Conectar un cliente MCP
TAIA expone un servidor MCP con 36 herramientas: tareas, subtareas, dependencias, mensajes, proyectos, workspaces, worktrees, sesiones y agentes.
Hay dos transportes:
| Transporte | Cómo se levanta | Cuándo usarlo |
|---|---|---|
| HTTP | Viene con docker compose up en http://localhost:13336/mcp. Fuera de Docker: pnpm -F @taia/mcp start:http |
Lo normal: un solo servidor compartido por todos los clientes |
| stdio | pnpm mcp desde el repo |
Clientes que solo hablan stdio y corren en la misma máquina que el código de TAIA |
Claude Code
Sección titulada «Claude Code»En cualquier proyecto:
claude mcp add --transport http taia http://localhost:13336/mcpDentro del repo de TAIA no hace falta: el .mcp.json de la raíz ya lo declara. Al abrir el proyecto, Claude Code pide aprobar el server taia, y /mcp lo muestra conectado.
Claude Desktop
Sección titulada «Claude Desktop»Claude Desktop lee su propio archivo de configuración. Con el stack de Docker arriba:
./scripts/dev/connect-claude-desktop.shEl script agrega una entrada taia (con backup del archivo) que conecta por mcp-remote al servidor HTTP. Después cerrá Claude Desktop del todo y volvé a abrirlo.
Para hacerlo a mano, agregá esto a claude_desktop_config.json:
{ "mcpServers": { "taia": { "command": "npx", "args": ["-y", "mcp-remote", "http://localhost:13336/mcp"] } }}Si Claude Desktop no encuentra npx, el script resuelve el problema usando tu shell de login.
Cursor y otros clientes
Sección titulada «Cursor y otros clientes»Cualquier cliente con soporte para MCP por HTTP (streamable HTTP) usa la URL http://localhost:13336/mcp. Si el cliente solo soporta stdio, usá mcp-remote como en el ejemplo de Claude Desktop.
Workspaces
Sección titulada «Workspaces»Las herramientas que listan o crean cosas aceptan workspace_id; sin él, usan ws-default. Si tus agentes trabajan en otro workspace, indicalo en sus instrucciones. Para ver los workspaces y sus columnas: taia_list_workspaces y taia_get_workspace_columns.
Acceso desde otra máquina o detrás de un proxy
Sección titulada «Acceso desde otra máquina o detrás de un proxy»Sin TAIA_API_TOKEN, el servidor MCP no pide credenciales: en Docker solo escucha en 127.0.0.1, y en producción no se publica. Con el token de acceso definido, cada cliente lo manda como Authorization: Bearer <token>; en Claude Code:
claude mcp add --transport http taia http://localhost:13336/mcp \ --header "Authorization: Bearer <token>"Además, el servidor rechaza requests con un Host que no reconoce (protección contra DNS rebinding). Agregá el nombre público con MCP_ALLOWED_HOSTS, separado por comas.