Conectar un agente (MCP)

Klevy expone su API como un servidor MCP: un agente —Claude u otro— la usa por su cuenta. Pide trámites, abre el widget para capturar la clave de un titular y emite documentos tributarios, con las mismas herramientas que documenta esta referencia.

Conectar

＋ Agregar a Cursor ＋ Agregar a VS Code

Claude Desktop y Claude Code

Agregá el servidor a tu configuración MCP (claude_desktop_config.json, o el .mcp.json del proyecto en Claude Code). Reemplazá la API key por la tuya (sk_live_… o sk_test_… para el sandbox):

{
  "mcpServers": {
    "klevy": {
      "command": "npx",
      "args": ["-y", "@klevy/mcp"],
      "env": { "KLEVY_API_KEY": "sk_live_tu_api_key" }
    }
  }
}

Las herramientas y el botón usan npx @klevy/mcp. Mientras no esté publicado en npm, apuntá command a node y args al binario compilado: ["ruta/a/klevy/apps/mcp/dist/main.js"].

Qué puede hacer

Doce herramientas, las mismas que esta referencia documenta endpoint por endpoint:

Herramienta	Qué hace
`klevy_catalog`	Lista los flujos disponibles y qué credencial exige cada uno.
`klevy_run`	Ejecuta un flujo (trámite).
`klevy_get_run`	Estado y resultado de un run.
`klevy_list_runs`	Lista los runs del tenant.
`klevy_create_session`	Abre el widget para capturar la clave de un titular.
`klevy_list_emisores`	Las empresas por cuenta de las que se emite.
`klevy_folios`	Folios disponibles por tipo de documento.
`klevy_emit_document`	Emite un DTE (factura, boleta, guía…).
`klevy_list_documents`	Lista los documentos emitidos.
`klevy_get_document`	Un documento con su XML firmado.
`klevy_send_documents`	Manda al SII los documentos pendientes.
`klevy_envio_status`	El veredicto del SII sobre un envío.

Configuración

Variable
`KLEVY_API_KEY`	Obligatoria. La API key del integrador.
`KLEVY_BASE_URL`	Opcional. Por defecto `https://api.klevy.cl`.

Para empezar necesitás una API key: pedila en Solicitar acceso. La referencia de cada operación está en el resto de estos docs.