Si has llegado hasta aquí probablemente ya viste el **[servidor MCP](/mcp/getting-started/)** y la
**[referencia de API](/api/getting-started/)** por separado. Son dos caras de la misma superficie
`/public/v1` — esta página es el puente que las conecta, para el caso real de "quiero mi propio asistente
de IA (Claude, Cursor) hablando con mis datos de Nuntius, Y también mi backend tirando de la API
pública directamente".

## Por qué son la misma cosa por dentro

El servidor MCP **no tiene lógica propia**: sus *tools* se generan leyendo la misma definición OpenAPI que
documenta esta referencia REST, y cada llamada de una tool reenvía tu propia clave de API a `/public/v1`,
tal cual. Todo el control real — permisos, plan, límites, aislamiento por cuenta — lo aplica la API, nunca
el adaptador MCP. Por eso: **una sola clave, un solo conjunto de scopes, dos formas de usarlos.**

## El puente en 3 pasos

1. **Crea una clave de API con los scopes que necesitas ambos usos.** Ver
   **[Claves de API](/guides/claves-api/)** — se muestra completa una sola vez, guárdala. Si tu asistente
   de IA solo necesita leer leads y tu backend además necesita crear tickets, dale a la clave los dos
   scopes: `tenant:leads.read` y `tenant:tickets.manage`, por ejemplo — la misma clave sirve para ambos
   usos a la vez.
2. **Conecta tu asistente de IA por MCP** con esa clave — Claude Desktop, Claude Code o Cursor hablan
   `Streamable HTTP` en `https://mcp.nuntius.chat/mcp` con la cabecera `X-Api-Key`. Ver **[Conectar tu
   asistente](/mcp/connect/)**. A partir de aquí, tu asistente puede leer y (con tu confirmación, ver
   **[La confirmación en escrituras](/mcp/confirm/)**) escribir en tu cuenta durante la conversación.
3. **Conecta tu backend directamente a la API pública**, con la misma clave, en la cabecera `X-API-Key` de
   cada petición HTTP — sin MCP de por medio, para el código que corre sin supervisión humana turno a
   turno. Ver los **[5 casos de uso con ejemplos de código](/api/use-cases/)**.

## Cuándo usar cada camino

| Camino | Para qué sirve | Confirmación |
| --- | --- | --- |
| **MCP** (`https://mcp.nuntius.chat/mcp`) | Tu asistente conversacional (Claude, Cursor) explora y actúa sobre tu cuenta dentro de una sesión con una persona presente. | Toda escritura exige `confirm: true` — pensado para que la persona vea el resumen de la acción antes de aprobarla. |
| **API pública** (`https://api.nuntius.chat/public/v1`) | Tu propio backend, un script programado, o una integración con otro sistema (CRM, helpdesk, Zapier…) que corre sin supervisión turno a turno. | No hay paso de confirmación intermedio — tu código decide y ejecuta directamente. |

Un ejemplo real que usa los dos a la vez: tu asistente de Claude Code, conectado por MCP, consulta y
cualifica leads mientras hablas con él; tu propio backend, con la misma clave pero por la API directa,
sincroniza esos mismos leads hacia tu CRM cada hora sin que nadie lo mire — ver **[Sincronizar leads hacia
tu propio CRM](/api/use-cases/)**.

## Ver también

- **[Qué es y qué no es](/mcp/getting-started/)** — el servidor MCP explicado, y con qué no confundirlo
  (BYO-MCP).
- **[Empezar con la API](/api/getting-started/)** — autenticación, primera petición, formato de respuesta.
- **[Claves de API](/guides/claves-api/)** — scopes, orígenes permitidos y revocación.
- **[Catálogo de tools](/mcp/tools/)** — cada tool MCP con su operación REST equivalente.