Agentes de IA

Kimi Code CLI

Kimi Code — MCP

Kimi Code CLI es un cliente MCP. Las herramientas MCP aparecen junto a las integradas, sin ninguna diferencia de comportamiento, con el nombre mcp__<servidor>__<herramienta> (por ejemplo mcp__github__create_issue).

La versión corta

  1. En la TUI, ejecuta /mcp-config y añade el servidor de forma interactiva (también se encarga del login OAuth de MCP con /mcp-config login <nombre-del-servidor>).
  2. O edita directamente mcp.json (más abajo).
  3. Ejecuta /mcp para confirmar que el servidor se conectó.

mcp.json

Ubicaciones: a nivel de usuario ~/.kimi-code/mcp.json (o $KIMI_CODE_HOME/mcp.json) y a nivel de proyecto .kimi-code/mcp.json. Si hay entradas con el mismo nombre, gana la del proyecto. Los servidores MCP no se configuran en config.toml.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    },
    "linear": {
      "url": "https://mcp.linear.app/mcp"
    },
    "legacy-events": {
      "transport": "sse",
      "url": "https://mcp.example.com/sse"
    }
  }
}

Transportes: stdio (proceso hijo, con command/args), HTTP (con url) y sse (heredado; hay que poner transport: "sse" explícitamente).

Campos opcionales por servidor: env, cwd (stdio), headers, bearerTokenEnvVar (HTTP/SSE), enabled, startupTimeoutMs (30000 por defecto), toolTimeoutMs (60000 por defecto), enabledTools y disabledTools. Precedencia de los timeouts: por servidor > variable de entorno (KIMI_MCP_STARTUP_TIMEOUT_MS / KIMI_MCP_TOOL_TIMEOUT_MS) > [mcp] de config.toml > valor interno por defecto.

Un ejemplo concreto: GitHub por stdio

# 1. Añádelo a ~/.kimi-code/mcp.json:
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_…" }
    }
  }
}
# 2. En la TUI, compruébalo:
/mcp

# 3. Úsalo — el agente ya tiene herramientas como mcp__github__create_issue:
"Crea un issue en GitHub por el test intermitente de src/api.test.ts"

Cosas que conviene saber

  • Confianza: los servidores MCP de proyecto en una carpeta no confiable aparecen en la pregunta de confianza del workspace (la respuesta por defecto es “confiar en esta carpeta”). Revisa el comando de arranque o la URL antes de confirmar — confiar activa los servidores MCP del proyecto.
  • Cambios a mitad de sesión: borrar un servidor no mata las sesiones abiertas (queda listado como removed y sus llamadas fallan); los servidores añadidos a mitad de sesión sólo entran en las sesiones nuevas.
  • Permisos: las reglas admiten comodines */** (mcp__github__*); los argumentos de las herramientas MCP no entran en la comparación. Las llamadas que no coincidan con ninguna regla piden aprobación. En modo Ask When Needed las llamadas MCP se aprueban solas — la documentación advierte de usar ese modo sólo con servidores de confianza. Ver Permisos.
  • Plugins: pueden declarar mcpServers en su manifiesto (activados por defecto; se alternan con /plugins mcp enable|disable <id> <servidor> y luego /reload).

Última verificación: 2026-09-07

Fuentes oficiales:

Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.