Files

Josep Piguillem 9236cb73c6 feat(mcp): MCP server for AI clients, consuming the REST API

New app apps/mcp (NestJS + @nestjs-mcp/server 2): Streamable HTTP at
POST /mcp, stateless.

- 24 tools: projects (mine, public, details with settings, board, stats,
  analytics, activity), tickets (my work, search, details with comments and
  history, create, update, move, assign, release, comment, link), releases
  (list, upcoming, details with progress and burnup, create, publish) and
  users (whoami, search). Admin operations stay in the web.
- No credentials of its own: each call's Authorization header (a Pireon
  token) is forwarded to the API; without it only public projects are read.
- Typed REST client generated from apps/api/openapi.json (openapi-fetch +
  openapi-typescript via `nx run mcp:openapi-types`); API refusals become
  readable tool errors; parameters validated with zod.
- Tests: the real MCP against a simulated API (token forwarding, errors,
  validation, writes).
- Docker target `mcp` (Node 24) and an optional compose service under the
  `mcp` profile; zod declared as a root dependency.
- Docs: chapter 9 «Servidor MCP», references in 01/06/07 and the index;
  Word/PDF regenerated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-07 18:59:38 +02:00

1.9 KiB

Raw Blame History

Documentación de TaskStream

TaskStream es una alternativa a Jira para equipos de desarrollo: proyectos, tickets (bugs, features, cambios de UI, tareas, QA), releases, comentarios y relaciones entre tickets, todo en tiempo real.

Documento	Para qué
1. Visión general	Qué hace el producto, stack y estructura del monorepo
2. Arquitectura	Hexagonal, CQRS, event sourcing, flujo escritura → lectura y tiempo real
3. API	Dominio (agregados, workflow, eventos) y la API GraphQL
4. Cliente web	Angular, NgRx Signals con eventos, GraphQL y `@pi/ui`
5. Autenticación	Pireon: tokens, login en el navegador, sesiones y webhooks
6. Desarrollo	Puesta en marcha, comandos, tests y cómo añadir una funcionalidad
7. Despliegue	Docker, variables de entorno y escalado
8. Decisiones	Por qué está hecho así (y qué alternativas se descartaron)
9. Servidor MCP	Usar TaskStream desde asistentes de IA (Claude…): herramientas y conexión

Cada librería de libs/ tiene además su propio README.md con su responsabilidad y su contenido.

Empezar rápido

docker compose up -d --build     # web en http://localhost:8080

Para entrar hacen falta dos clientes OAuth de Pireon en .env (authorization_code y password, ver Autenticación).

1.9 KiB Raw Blame History

Documentación de TaskStream

1.9 KiB

Raw Blame History