Servidor MCP

Nodda expone un servidor MCP remoto (Model Context Protocol) para que agentes de IA consulten tus datos ya sincronizados —conexiones, saldos, movimientos y documentos— en modo sólo lectura. Está construido sobre la misma API de lectura y la misma especificación OpenAPI que documentamos en el resto de esta guía.

URL del servidor: https://app.nodda.cl/api/mcp
Transporte: Streamable HTTP (remoto, nada que instalar).
Autorización: OAuth 2.1 (autorizas una vez desde el panel de Nodda).
Permisos: un único scope read. El agente no puede gatillar sincronizaciones ni modificar nada.

Activa y revoca conexiones desde el panel: app.nodda.cl → MCP.

Las dos herramientas

El servidor expone exactamente dos herramientas, manejadas por la especificación OpenAPI (https://app.nodda.cl/api/openapi.json):

Herramienta	Qué hace
`discover`	Orienta al agente: lista tus conexiones y el catálogo de operaciones de lectura. Con `{ "operation": "listRcvDocuments" }` devuelve el esquema de parámetros de esa operación.
`execute`	Ejecuta una operación de lectura: `{ "operation": "listRcvDocuments", "params": { … } }`. Valida los parámetros contra la especificación y devuelve el JSON tal cual lo entrega la API.

Ejemplo de llamada a execute (el agente la construye; tú no escribes esto a mano):

{
  "operation": "listRcvDocuments",
  "params": {
    "id": "3f1c9e2a-7b44-4d51-9a0e-1c2d3e4f5a6b",
    "period": "2026-05",
    "limit": 50
  }
}

Respuesta (igual que la API REST, con data + pagination):

{
  "data": [
    { "id": "a1b2c3d4-0000-4000-8000-000000000001", "rut": "76.123.456-7", "razon_social": "Proveedor SpA", "direction": "received", "total": "2500000.00" }
  ],
  "pagination": { "limit": 50, "offset": 0, "total": 1 }
}

Cómo conectarlo

Claude (web o escritorio): Settings → Connectors → + Add custom connector → ponle un nombre y pega https://app.nodda.cl/api/mcp. Claude abre el flujo OAuth: inicias sesión en Nodda y autorizas el acceso de sólo lectura.

Claude Code (CLI):

claude mcp add --transport http nodda https://app.nodda.cl/api/mcp

Completa el consentimiento en el navegador y luego pídele al agente que llame a discover.

El flujo OAuth 2.1

El cliente se conecta a /api/mcp sin token y recibe un 401 que apunta a los metadatos de autorización.
Se registra dinámicamente (DCR) y abre /oauth/authorize.
Inicias sesión en Nodda y ves la pantalla de consentimiento (qué app pide acceso, a qué organización, scope read).
Tras autorizar, el cliente intercambia el código (PKCE) por un access token nodda_at_… de corta duración (1 hora) y un refresh token nodda_rt_….
El access token se renueva solo con el refresh token (rotación automática), así que autorizas una vez y la conexión sigue funcionando sin volver a iniciar sesión.

Los tokens del MCP son de sólo lectura y están atados a tu organización. Si revocas una aplicación desde app.nodda.cl → MCP, pierde el acceso de inmediato y debe volver a autorizarse.

Operaciones disponibles

El agente puede llamar (vía execute) cualquier endpoint de lectura de la API. Resumen por área (detalle completo en la Referencia de la API):

Área	Operaciones
Conexiones	`listConnections`, `getConnection`, `listSyncRuns`, `getSyncRun`
SII RCV	`listRcvDocuments`, `getRcvDocument`, `listRcvPeriods`
SII Boletas	`listSiiBoletas`, `listSiiBoletasPeriods`
SII Guías de despacho	`listDispatchGuides`, `getDispatchGuide`, `listDispatchGuidePeriods`
Banco Security	`listSecurityTransfers`, `listSecurityTransferPeriods`, `listSecurityNominas`, `listNominaPagos`, `listSecurityNominaPeriods`, `listSecurityBalances`
BCI	`listBciBalances`, `listBciMovements`, `listBciMovementPeriods`
Mercado Público	`getMercadoPublicoLicitacion`, `listMercadoPublicoDocumentos`, `listMercadoPublicoPreguntas`, `listMercadoPublicoOfertas`

Las operaciones que mutan (crear conexiones, gatillar syncs, cambiar horarios, administrar API keys) no están expuestas al MCP — son exclusivas del panel.

Para el detalle de cada respuesta y los filtros disponibles, revisa la Referencia de la API, la Autenticación y la guía Para agentes.

Servidor MCP

Las dos herramientas

Cómo conectarlo

El flujo OAuth 2.1

Operaciones disponibles

On this page