Activarlo
El instalador con Docker Compose deja el endpoint desactivado por defecto. Añade lo siguiente al archivo.env en el directorio kodus-installer:
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 ahttps://<your-api-host>/mcp en la API de tu instancia. El servidor usa Streamable HTTP.
- Abre Organization → CLI keys, genera una clave y cópiala. Solo los owners de la organización pueden generar claves. Consulta Claves de CLI.
- Configura el cliente para que envíe la clave en uno de estos encabezados al llamar a una herramienta.
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
teamIdde otro equipo se rechaza, y unteamIdomitido 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/listypingfuncionan sin clave. Cualquier otra llamada necesita una clave válida, y una clave ausente, inválida o revocada devuelve401.
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.