Ir al contenido
Nuntius

Guías

Mi propia IA y mi backend, hablando con mis datos

Ver como Markdown

Si has llegado hasta aquí probablemente ya viste el servidor MCP y la referencia de API 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

Sección titulada «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

Sección titulada «El puente en 3 pasos»
  1. Crea una clave de API con los scopes que necesitas ambos usos. Ver Claves de 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. A partir de aquí, tu asistente puede leer y (con tu confirmación, ver La confirmación en escrituras) 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.

Cuándo usar cada camino

Sección titulada «Cuándo usar cada camino»
CaminoPara qué sirveConfirmació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.

Ver también

Sección titulada «Ver también»