Aymar Agents 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.
Qué es y qué no esUn adaptador determinista sobre tu propia API pública, sin modelo de lenguaje propio.
Conectar tu asistenteURL, cabecera X-Api-Key y transporte Streamable HTTP.
Conecta tu cliente
Sección titulada «Conecta tu cliente»Claude DesktopConfiguración del cliente de escritorio.
Claude CodePor CLI o con .mcp.json.
CursorConfiguración del editor.
Referencia
Sección titulada «Referencia»Catálogo de toolsCada tool disponible, generada de la misma definición OpenAPI que la API pública.
La confirmación en escriturasNinguna escritura ocurre sin tu confirmación explícita.
Límites, errores y resolución de problemasQué hacer cuando algo falla.
Herramientas relacionadas
Sección titulada «Herramientas relacionadas»Referencia APILa misma superficie, en REST directo.
llms.txtÍndice de todo el portal en texto plano.
Preguntas frecuentes
Sección titulada «Preguntas frecuentes»¿En qué se diferencia el servidor MCP propio de un servidor MCP externo (BYO-MCP)?
Son direcciones opuestas: el servidor MCP de Aymar Agents 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.
Siguiente
Sección titulada «Siguiente»Conectar tu asistenteBloques de configuración para Claude Desktop, Claude Code y Cursor.