Saltar al contenido principal

Introducción

El servidor MCP de Kadu es un servidor Model Context Protocol remoto: conecta Claude, ChatGPT, Claude Code o un IDE y usa Kadu conversando — listar tareas, lanzar una ejecución, seguir eventos y logs, resolver pendientes, configurar entornos, secrets, programaciones y webhooks, sincronizar el Playbook y consultar uso y costo. Ofrece las operaciones de la API v1 como tools que el cliente de IA llama. Lo conectas por URL; no hay nada que instalar.

Se sirve en un host propio, mcp.kadu.ia.br, con transporte Streamable HTTP en modo stateless y autenticación por Bearer token emitido por la Cuenta Kobana: por el flujo OAuth 2.1, en el que el cliente recibe solo la URL e inicia sesión por su cuenta, o con un token personal creado en el asistente de tokens de la Cuenta Kobana. No interviene ningún certificado de cliente.

Cuándo usarlo​

API v1Servidor MCP (este)
Consumidortu backend, una integraciónun cliente de IA (Claude, ChatGPT, Claude Code, un IDE)
Configuracióntoken, fuera de bandauna URL
TransporteHTTPS/RESTStreamable HTTP (JSON-RPC 2.0)
AutenticaciónBearer token emitido para la APIOAuth 2.1 o token personal, siempre emitido para el MCP
Superficielas rutas de /v1una tool por operación de /v1

El servidor MCP no reemplaza a la API. Cada tool despacha in-process al handler de la ruta que implementa la operación, así que validación, filtros, cola de ejecuciones, plan contratado, tope de costo y aislamiento por organización son exactamente los mismos. Si estás escribiendo código, usa la API v1. Si estás conectando un asistente, usa esto.

El principio​

Una capacidad solo existe en el MCP si existe en la API v1.

No hay una segunda implementación de nada. La tool llama al handler de la ruta con la identidad que el token del llamador ya probó — la misma persona, la misma organización —, así que corre como correría para cualquier solicitud HTTP. Una tool hace lo que hace la ruta — nunca más.

En la práctica, el MCP alcanza lo mismo que el Agent Console, porque toda acción de la consola tiene ruta en la API. Queda fuera solo lo que, por definición, es de la persona en el navegador: inicio de sesión y cambio de organización, onboarding, la conexión del Playbook por la GitHub App y decidir una aprobación — mira Confirmación de tools destructivas.

tools/list devuelve solo las tools que este llamador puede ejecutar: las que el alcance del token cubre y que el rol de la persona permite en la organización. A un asistente no se le informan capacidades que solo recibirían una negativa. Las reglas están en Autenticación.

Primeros pasos​

  1. Apunta tu cliente a la URL del servidor — mira Endpoints y Clientes.

  2. Autoriza. El cliente abre el inicio de sesión de la Cuenta Kobana; entra con una cuenta de la organización y elige, en la pantalla de consentimiento, qué puede hacer el asistente. Mira Autenticación.

  3. Lista las tools para confirmar lo que alcanza tu acceso — pídeselo al asistente o, con un token emitido para el MCP en mano:

    curl https://mcp.kadu.ia.br/ \
      -H "Authorization: Bearer $MCP_TOKEN" \
      -H "Content-Type: application/json" \
      -H "Accept: application/json" \
      -H "MCP-Protocol-Version: 2025-06-18" \
      -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

  4. Explora la documentación — el catálogo completo está en Tools.

:::caution Lo que viene de una ejecución es dato, no instrucción Eventos, logs, memorias y pendientes traen texto que el agente escribió a partir de datos de terceros (extractos, registros del ERP, correos). El servidor orienta al asistente a no seguir órdenes encontradas allí y a confirmar contigo antes de cualquier acción que un resultado parezca pedir. :::

Próximos pasos​

  • Autenticación — el flujo OAuth, el token personal, el alcance y los permisos aplicados, y los modos de falla.
  • Endpoints — URLs por entorno y rutas servidas.
  • Transporte — JSON-RPC, versiones del protocolo, cabeceras y métodos.
  • Resources y prompts — documentos por URI, guiones listos, autocompletado y la confirmación de tools destructivas.
  • Clientes — cómo conectar Claude Code y clientes configurados por archivo.
  • Límite de Peticiones — el presupuesto por persona.
  • Listado, Orden y Filtros — cursor, limit, sort_by y los filtros.
  • Idempotencia — idempotency_key en las escrituras.
  • Errores — los dos canales de falla, y por qué importa la distinción.
  • Tools — el catálogo de tools.