Conectar Claude Code

En Claude Code (y en cualquier cliente MCP que soporte transporte HTTP con headers) te autenticas con una api-key de kiban. El servidor no la guarda: la reenvía al backend en cada llamada.

Primero: ¿la api-key de cuál herramienta?

Las api-keys de kiban son por herramienta. Una key creada en workfloo autentica en workfloo; una creada en link autentica en link. No son intercambiables, y el header x-api-key solo puede llevar una.

Si mandas la key equivocada, la llamada llega al backend y él la rechaza con 401.

Agregar el servidor

claude mcp add kiban-workfloo \
  --transport http https://mcp.kiban.com/mcp \
  --header "x-api-key: TU_API_KEY_DE_WORKFLOO"

Si además quieres poder ejecutar en modo sandbox, agrega tu key de sandbox — es una key distinta, de la misma herramienta:

claude mcp add kiban-workfloo \
  --transport http https://mcp.kiban.com/mcp \
  --header "x-api-key: TU_API_KEY_DE_WORKFLOO" \
  --header "x-api-key-sandbox: TU_API_KEY_SANDBOX_DE_WORKFLOO"

Verifica con el comando /mcp dentro de Claude Code: el servidor debe aparecer conectado y con sus herramientas.

Comprobar que responde

curl -s -X POST https://mcp.kiban.com/mcp \
  -H "x-api-key: TU_API_KEY" \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Debe devolver el catálogo de herramientas. Si responde 401, revisa Solución de problemas.

Usar workfloo y link al mismo tiempo

El header x-api-key es uno solo por servidor, así que hay dos caminos:

Opción A — conéctate con login (recomendado). Con la conexión OAuth de claude.ai tu identidad de kiban cubre workfloo, link y rekon con una sola credencial, sin keys. Es la única forma de tener los tres módulos juntos.

Opción B — registra el MCP dos veces, una por herramienta, con nombres distintos:

claude mcp add kiban-workfloo \
  --transport http https://mcp.kiban.com/mcp \
  --header "x-api-key: TU_API_KEY_DE_WORKFLOO"

claude mcp add kiban-link \
  --transport http https://mcp.kiban.com/mcp \
  --header "x-api-key: TU_API_KEY_DE_LINK"

Claude Code nombra las herramientas por servidor, así que no chocan entre sí. Dos advertencias:

• Cada servidor lista las 15 herramientas, no solo las de su herramienta: el catálogo no depende de la key. Si el asistente llama link_execute en el servidor de workfloo, el backend responde 401.
• Por eso conviene decirle cuál usar ("para las consultas usa kiban-link") o desactivar en cada servidor las herramientas que no le corresponden.

Diferencias contra claude.ai