Notta expone tres canales de integración con la misma estructura de respuesta: API REST, servidor MCP (para agentes de IA como Claude o Cursor) y CLI. Todos se autentican con una API key que creas en app.notta.cl/app/api-keys.
API REST
La API vive en https://app.notta.cl/api/v1 y usa autenticación Bearer con tu API key.
• Las keys tienen prefijo ntt_cert_… o ntt_prod_…, pero el ambiente lo define tu organización, no el prefijo de la key. Si tu organización está en certificación, emites contra el sandbox del SII (maullin); tras la autorización, contra producción.
• El secreto se muestra una sola vez al crearla — guárdalo en ese momento. Si lo pierdes, crea una key nueva.
• Cada key tiene permisos por scope: dte:read, dte:write, bhe:read, bhe:write, rcv:read, caf:write, entre otros. Asigna solo los que tu integración necesita.
Emitir un DTE por API
Envía POST /api/v1/dtes con el header Idempotency-Key (obligatorio): un retry con la misma key jamás duplica un DTE. La respuesta es un 202 con el folio asignado y links al PDF, al XML firmado y a los eventos del documento.
Para confirmar la aceptación, consulta GET /api/v1/dtes/{id} hasta que sii_status sea EPR (aceptado por el SII).
MCP local: tu agente de IA emite por ti
El servidor MCP local corre con el binario notta-mcp y tu API key:
NOTTA_API_KEY=ntt_prod_… notta-mcp
Es compatible con Claude Code, Claude Desktop y Cursor. Incluye tools para emitir y consultar: notta_dte_emit, notta_dte_get, notta_dte_list, notta_dte_pdf, notta_bhe_emit, notta_caf_status, y ayudas como notta_help_dte_decision (qué documento corresponde emitir) y notta_help_explain_status (qué significa un estado del SII).
MCP remoto: solo lectura, vía OAuth
Si prefieres no instalar nada, conecta tu agente a https://app.notta.cl/api/mcp con OAuth. Este canal es solo lectura: sirve para consultar documentos y estados, no para emitir. Conectas y revocas el acceso desde app.notta.cl/app/mcp.
CLI
El CLI notta cubre el flujo completo desde la terminal: auth, orgs, dte, bhe, caf, rcv y doctor (diagnóstico de tu configuración).
Estado actual
• Los paquetes @notta/cli y @notta/mcp están en proceso de publicación en npm: la instalación vía npm install puede no estar disponible todavía. Si te bloquea, escríbenos a soporte.
• La consulta de F29 por API, CLI o MCP aún no está disponible, aunque el comando aparezca en algunos listados.
Siguiente paso
Crea tu API key en app.notta.cl/app/api-keys con los scopes que necesites, guarda el secreto y prueba tu primer POST /api/v1/dtes contra el sandbox — los documentos de certificación no tienen validez tributaria, así que puedes experimentar sin riesgo.