Saltar al contenido principal
El servidor MCP está disponible solo en instalaciones autoalojadas de Kodus. Expone los repositorios, pull requests, Kody Issues, Kody Rules y memorias de un workspace como herramientas para un cliente MCP. Para conectar herramientas externas a Kody mediante Plugins, configura MCP Manager.

Activarlo

El instalador con Docker Compose deja el endpoint desactivado por defecto. Añade lo siguiente al archivo .env en el directorio kodus-installer:
Ejecuta docker compose up -d --no-deps api en ese directorio para aplicar la variable. El chart de Helm habilita el endpoint por defecto. Para desactivarlo, establece global.config.API_MCP_SERVER_ENABLED en "false" en el archivo de valores y ejecuta helm upgrade. Mientras está desactivado, la API no sirve /mcp. La ruta es POST /mcp en el host de la API, así que un reverse proxy debe reenviarla. Consulta Proxy inverso.

Conectar un cliente

Conecta el cliente a https://<your-api-host>/mcp en la API de tu instancia. El servidor usa Streamable HTTP.
  1. Abre Organization → CLI keys, genera una clave y cópiala. Solo los owners de la organización pueden generar claves. Consulta Claves de CLI.
  2. Configura el cliente para que envíe la clave en uno de estos encabezados al llamar a una herramienta.
Para comprobar la conexión, sustituye kodus-api.example.com por el host de tu API y lista las herramientas. Esta solicitud de descubrimiento funciona sin clave.
  • Una clave pertenece a un equipo. Un argumento teamId de otro equipo se rechaza, y un teamId omitido se completa a partir de la clave.
  • La mayoría de las herramientas reciben un argumento organizationId. Debe ser el ID de tu organización. Cualquier otro valor se rechaza.
  • initialize, tools/list y ping funcionan sin clave. Cualquier otra llamada necesita una clave válida, y una clave ausente, inválida o revocada devuelve 401.

Herramientas

Repositorios y pull requests

Kody Issues

Kody Rules y memorias

Gestionar reglas y memorias

KODUS_CREATE_KODY_RULE, KODUS_UPDATE_KODY_RULE, KODUS_DELETE_KODY_RULE y KODUS_CREATE_MEMORY necesitan la capacidad kodyRules:manage en la clave. En Organization → CLI keys, haz clic en Configure en la clave y activa Allow Kody Rules management via CLI. Sin ella, estas herramientas devuelven un resultado de error (isError: true) que indica que la clave no tiene permiso para gestionar Kody Rules. Las otras herramientas no necesitan ninguna capacidad.
  • Una regla creada a través del servidor muestra el origen MCP/Agent y espera en Pending review hasta que alguien la apruebe.
  • Una memoria espera allí solo cuando Kody knowledge approval está activado.
  • Con una configuración centralizada activada, crear, cambiar o eliminar una regla o memoria abre en su lugar un pull request en el repositorio de configuración.

Límites

  • Solo se admite POST.
  • Sin estado. El servidor no mantiene ninguna sesión entre solicitudes y no devuelve Mcp-Session-Id.
  • No envía nada al cliente fuera de la respuesta a un POST.