---
title: Servidor MCP
description: Conecta tu agente LLM — Claude, Cursor o cualquier cliente MCP — a las 20 herramientas tipadas de Notta
url: https://notta.cl/docs/mcp
related:
  - https://notta.cl/docs/agentes
  - https://notta.cl/docs/emit-factura-33
  - https://notta.cl/docs/authentication
  - https://notta.cl/docs/cli-reference
---

> Documentación de Notta en markdown. Índice completo: https://notta.cl/llms.txt — corpus entero: https://notta.cl/llms-full.txt

# Servidor MCP

Notta expone un servidor [MCP](https://modelcontextprotocol.io) (Model Context
Protocol) para que tu agente emita DTEs y consulte tu cuenta con herramientas
tipadas. Es uno de los 3 canales programáticos (API, CLI, MCP) + el dashboard:
mismos shapes, misma API key.

El manifiesto de descubrimiento se sirve en
[`https://notta.cl/.well-known/mcp.json`](https://notta.cl/.well-known/mcp.json),
generado desde el toolset real del servidor: nombre, descripción y JSON Schema
de input de cada herramienta. Si tu agente no habla MCP, el corpus completo de
estas docs está en `https://notta.cl/llms.txt` y `/llms-full.txt`.

## Servidor remoto (HTTP)

Además del servidor local de la sección de abajo, Notta expone un servidor
MCP remoto por HTTP en `https://app.notta.cl/api/mcp` — no requiere instalar
nada. Conéctalo con:

```bash
claude mcp add --transport http notta https://app.notta.cl/api/mcp
```

Al conectar por primera vez, tu agente pide autorización OAuth — acceso de
solo lectura sobre DTEs, boletas y BHE, nunca de escritura. Administra o
revoca las apps conectadas desde `/app/mcp` en el dashboard.

> **Catálogo distinto al servidor local:**
El servidor remoto expone dos herramientas (`discover` y `execute`) sobre el
mismo catálogo de operaciones de solo lectura de la API — no el set completo
de 20 herramientas del servidor local (`@notta/mcp`) de la siguiente sección.

## Instalación

Agrega el servidor a la config de tu cliente MCP (p. ej. Claude Desktop,
`~/.config/claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "notta": {
      "command": "npx",
      "args": ["@notta/mcp"],
      "env": { "NOTTA_API_KEY": "ntt_cert_..." }
    }
  }
}
```

> **Disponibilidad:**
`@notta/mcp` está en proceso de publicación en npm — el `npx` de arriba todavía
no resuelve. Mientras tanto, el dashboard y la [API](/docs/api-reference) cubren
el flujo completo: tu agente puede llamar la API directo con una
[API key](/docs/authentication).

## Herramientas

El servidor expone 20 herramientas, espejo 1:1 de la API:

| Tool | Para qué |
|---|---|
| `notta_dte_emit` | emitir un DTE (33/34/39/41/56/61) con validaciones tributarias previas |
| `notta_dte_get` | obtener un DTE por id — para chequear estado terminal post-emisión |
| `notta_dte_list` | listar DTEs con filtros `tipo_dte`/`from`/`to` y cursor pagination |
| `notta_dte_pdf` | URL del PDF con timbre electrónico |
| `notta_dte_refresh_status` | forzar un poll inmediato al SII |
| `notta_bhe_emit` · `notta_bhe_get` · `notta_bhe_list` · `notta_bhe_anular` | Boletas de Honorarios Electrónicas |
| `notta_certificate_list` · `notta_certificate_get` | certificados digitales — metadatos, nunca la clave privada |
| `notta_caf_list` · `notta_caf_status` | folios (CAF) con alertas de agotamiento |
| `notta_rcv_list` · `notta_rcv_refresh` | Registro de Compras y Ventas por período |
| `notta_f29_get` · `notta_f29_recompute` | F29 propuesto, calculado desde el RCV |
| `notta_audit_log_query` | audit log con hash chain (retención legal 6 años) |
| `notta_help_dte_decision` · `notta_help_explain_status` | ayuda al agente: qué documento emitir y qué significa cada estado SII |

Tu agente invoca `notta_dte_emit` con el mismo shape que `POST /api/v1/dtes` —
ver [Emitir Factura 33](/docs/emit-factura-33). La herramienta genera el
Idempotency-Key automáticamente, así que un retry del agente no duplica el
documento.

## Decisión tributaria asistida

`notta_help_dte_decision` recibe un escenario en lenguaje libre ("el cliente
devolvió el producto") y devuelve el documento correcto con sus restricciones
legales: NC 61 con `cod_ref` 1/2/3, ND 56, o un bloqueo — intereses moratorios
legales (Oficio SII 2011/2020) o factura cedida hace más de 8 días (doctrina
Corte Suprema 2025). `notta_help_explain_status` traduce los estados SII (EPR,
RPR, RFR, RCT, RSC) a lenguaje natural con `next_action`.

## RCV y F29

Las herramientas `notta_rcv_list` y `notta_rcv_refresh` le dan a tu agente el
Registro de Compras y Ventas del SII por período — el insumo del crédito y
débito fiscal. Con `notta_f29_get` y `notta_f29_recompute`, el agente arma el
F29 propuesto del mes sin salir de la conversación. El detalle del modelo está
en [RCV y F29](/docs/rcv-f29).

## Próximos pasos

- **[Agentes](/docs/agentes)** — patrones para que tu agente emita con confirmación humana y maneje la emisión async.
- [Emitir Factura 33](/docs/emit-factura-33) — el shape completo del request de emisión y los estados SII.
- [Autenticación](/docs/authentication) — API keys, scopes y entornos sandbox/producción.
- [Referencia del CLI](/docs/cli-reference) — las mismas operaciones desde tu terminal.