Qué es y qué no es

MCP (Model Context Protocol) es un estándar abierto para que un asistente de IA (Claude Desktop, Claude Code, Cursor, o un agente propio) opere herramientas externas de forma estructurada, en vez de por texto libre. Aymar Agents tiene su propio servidor MCP: expone tu cuenta — leads, contactos, conversaciones, citas y tickets — como un conjunto de tools que tu asistente puede leer y, con tu confirmación, escribir.

Qué es

• Un adaptador determinista, sin modelo de lenguaje propio: el LLM que decide qué tool llamar vive siempre en tu cliente (Claude Desktop, Claude Code, Cursor…), nunca en este servidor.
• Exactamente lo que permite la API pública (/public/v1), ni un endpoint más — sus tools se generan leyendo la misma definición OpenAPI que documenta la referencia REST, así que cualquier cosa que puedas hacer por MCP también podrías hacerla con una llamada curl directa a la API. Ver el catálogo completo de tools.
• Sin acceso a tu base de datos ni a ningún dato que la API no exponga ya: cada llamada de una tool reenvía tu propia clave de API a /public/v1, tal cual — el servidor MCP no guarda tu clave ni tiene ninguna otra vía de acceso a tu cuenta. Todo el control (permisos, plan, límites, aislamiento por cuenta) lo aplica la API, no este adaptador.

Qué NO es

No confundas esto con los “servidores MCP externos” que puedes conectar a tu propio agente de IA desde Ajustes → Integraciones (BYO-MCP) — son lo contrario:

	Servidor MCP de Aymar Agents (esta sección)	Servidores MCP externos (BYO-MCP)
Dirección	Saca tu cuenta de Aymar Agents hacia tu asistente de IA externo	Mete herramientas de terceros dentro del agente de IA de tu cuenta
Quién lo conecta	Tú, desde tu cliente MCP (Claude Desktop, Claude Code, Cursor…)	Tú, desde la Plataforma, para que las use el agente que atiende a tus clientes
Dónde se configura	En la configuración de tu propio cliente MCP (ver Conectar tu asistente)	En Ajustes → Servidores MCP de la Plataforma

Si lo que buscas es dar a tu agente de IA acceso a herramientas externas (tu CRM, tu catálogo, tu calendario…), esa es la otra pieza — consulta la guía Ajustes e integraciones, apartado 8. Esta sección es sobre lo contrario: dar a tu propio asistente de IA acceso a Aymar Agents.

Requisitos

• Plan Pro o Enterprise — con el plan Starter, cualquier tool responde el mismo 403 PLAN_NOT_ELIGIBLE que la API pública (ver Planes y límites). El servidor sigue siempre listando la tool aymar_status para que tu cliente pueda mostrar un mensaje claro sobre por qué no hay más.
• Una clave de API con los scopes de los recursos que quieras usar — el mismo mecanismo, y la misma pantalla, que la clave que usarías para llamar a /public/v1 directamente (guía Claves de API, catálogo completo de scopes en Autenticación). Las tools que ve tu cliente MCP son exactamente las que tu clave puede usar — nada más.

Cómo funciona, en tres pasos

Tu cliente MCP (Claude Desktop / Claude Code / Cursor / tu propio agente)
      │  Streamable HTTP, cabecera X-API-Key: <tu clave>
      ▼
Servidor MCP de Aymar Agents  (sin base de datos, sin estado, sin LLM propio)
      │  reenvía tu misma clave, llamada a llamada
      ▼
API pública de Aymar Agents  (/public/v1 — aquí se decide todo: permisos, plan, límites)

Sigue con Conectar tu asistente para los bloques de configuración concretos. Si además quieres que tu propio backend hable directamente con la API pública, con la misma clave, ver Mi propia IA y mi backend, hablando con mis datos.