Ir al contenido

MCP

MCP

Ver como Markdown

Nuntius tiene su propio servidor MCP (Model Context Protocol): expone tu cuenta — leads, contactos, conversaciones, citas y tickets — como un conjunto de tools que tu asistente de IA puede leer y, con tu confirmación, escribir. Es exactamente lo que permite la API pública, ni un endpoint más — sus tools se generan de la misma definición OpenAPI.

¿En qué se diferencia el servidor MCP propio de un servidor MCP externo (BYO-MCP)?
Son direcciones opuestas: el servidor MCP de Nuntius saca tu cuenta hacia tu asistente de IA externo (Claude Desktop, Claude Code, Cursor); un servidor MCP externo mete herramientas de terceros dentro del agente que atiende a tus clientes, y se conecta desde Ajustes, no desde tu cliente MCP. Ver Qué es y qué no es.
¿Qué necesito para conectar mi cliente MCP?
Un plan Pro o Enterprise y una clave de API con los scopes de los recursos que quieras usar — el mismo mecanismo que usarías para llamar a /public/v1 directamente.
¿El servidor MCP puede hacer más cosas que la API pública?
No — sus tools se generan leyendo la misma definición OpenAPI que /public/v1. Cualquier cosa que puedas hacer por MCP también podrías hacerla con una llamada curl directa a la API.
¿Por qué mi asistente pide confirmación antes de crear o cambiar algo?
Toda tool de escritura exige el argumento confirm: true; sin él, el servidor la rechaza antes de tocar la API y devuelve un resumen de lo que iba a hacer. Es el mismo principio de "el LLM nunca es la única barrera" que rige el resto del producto. Ver La confirmación en escrituras.
¿Puede una tool de MCP borrar datos?
No — ninguna tool puede borrar nada, porque la API pública no tiene ningún endpoint DELETE.
Solo veo la tool de estado en mi cliente MCP, nada más. ¿Por qué?
O tu tenant no está en un plan Pro/Enterprise, o tu clave no tiene ningún scope de lectura. Llama a la tool de estado para confirmar cuál de los dos es. Ver Límites, errores y resolución de problemas.