Conecta una IA a tu CRM (MCP)

MCP es un estándar abierto (el "USB-C de las integraciones de IA"): Syncro expone una única dirección y cualquier asistente compatible se conecta, sin necesidad de código.

Una vez conectada, la IA opera tu CRM mediante comandos en lenguaje natural. Algunos ejemplos de lo que puedes pedir:

• "Lista los leads del embudo Ventas que llevan más de 7 días parados."
• "Crea un lead para Maria Silva, teléfono +55 11 99999-0000, en el embudo Ventas, etapa Nuevo."
• "Mueve el lead #4821 a la etapa Propuesta enviada."
• "Marca el lead #4821 como ganado, con un valor de R$ 3.500."
• "Crea una tarea de llamada para mañana por la mañana para cada lead sin contacto desde hace 3 días."
• "Envía un mensaje de WhatsApp al lead #4821 confirmando la reunión."
• "¿Cuáles son mis embudos y etapas?"

Recursos disponibles:

Recurso	Lo que la IA puede hacer
Leads	Listar, buscar, crear, actualizar, mover de etapa, marcar como ganado/perdido, gestionar tags e inscribir en secuencias de nutrición
Tareas	Listar, crear, actualizar y completar
WhatsApp	Enviar mensajes de texto y plantillas aprobadas al teléfono del lead
Automatizaciones	Listar, detallar, crear, modificar, activar/desactivar y eliminar automatizaciones
Chatbots	Listar, detallar, crear, modificar, activar/desactivar y eliminar flujos
Catálogo	Consultar embudos, etapas, campos personalizados, usuarios y números de WhatsApp conectados
Webhooks	Gestionar suscripciones de eventos

Además de leads, tareas y WhatsApp, la IA conectada vía MCP también lee, crea, modifica, activa y elimina automatizaciones y flujos de chatbot — son 11 tools nuevas (32 en total). Son capas finas sobre la API v1 (/automations/* y /chatbots/*), por lo que aplican los mismos permisos de la clave (automations:read/write, chatbots:read/write).

Tools de automatización: list_automations, get_automation, save_automation, toggle_automation, delete_automation, install_automation_template.

Tools de chatbot: list_chatbot_flows, get_chatbot_flow, save_chatbot_flow, toggle_chatbot_flow, delete_chatbot_flow.

Flujo recomendado (la IA lo sigue automáticamente):

1. Descubrir lo que es válido — get_crm_catalog (recursos automation_capabilities / chatbot_capabilities) o los endpoints /capabilities.
2. Simular — save_* con validate_only:true corrige cada error señalado antes de guardar.
3. Guardar — save_* crea/actualiza. Todo nace inactivo.
4. Activar — toggle_* es un paso aparte y exige confirmación del usuario (al activar, la automatización dispara mensajes reales y el bot pasa a responder conversaciones en vivo).

Las eliminaciones (delete_*) exigen confirm: true. La validación es estricta: cualquier spec inválido se rechaza con la ruta exacta del error para que la IA se autocorrija.

Referencia completa: Automatizaciones y Chatbots.

1. Verifica que el recurso esté habilitado. En Configuración → Integraciones, busca la tarjeta "MCP — Agentes de IA". Si no aparece, habla con el soporte para habilitarlo en tu cuenta.

2. Genera una API Key dedicada. En Configuración → API Keys, haz clic en Nueva API Key, dale un nombre (ej.: "MCP – Claude") y copia la clave — se muestra una sola vez. Recomendamos usar una clave solo para el MCP, para poder revocarla sin afectar a otras integraciones.

3. Anota la dirección del servidor:

https://app.syncro.chat/mcp

La IA usa tu API Key para autenticarse y queda restringida a tu cuenta, con los mismos permisos y límites de la clave.

Elige el cliente que usas. En todos, sustituye SUA_API_KEY por la clave generada en el paso anterior.

Claude Code (terminal)

claude mcp add --transport http syncro https://app.syncro.chat/mcp --header "X-API-Key: SUA_API_KEY"

Después solo tienes que conversar: "lista mis leads del embudo Ventas".

Cursor / Windsurf

Añade el servidor al archivo de configuración de MCP (mcp.json en Cursor):

{
  "mcpServers": {
    "syncro": {
      "url": "https://app.syncro.chat/mcp",
      "headers": { "X-API-Key": "SUA_API_KEY" }
    }
  }
}

En Windsurf la estructura es equivalente (el campo de la URL suele llamarse serverUrl).

ChatGPT (modo desarrollador)

En la configuración de Conectores, añade un servidor MCP con la URL https://app.syncro.chat/mcp y autenticación por API key (ChatGPT la envía en el encabezado Authorization: Bearer — Syncro acepta ambas formas). El modo desarrollador/conectores puede depender de tu plan de ChatGPT.

Claude.ai y Claude Desktop (conectores)

En Configuración → Conectores → Añadir conector personalizado, indica la URL https://app.syncro.chat/mcp.

• Si tu cuenta ya tiene el campo de encabezados (headers), usa X-API-Key con tu clave.
• Si aún no tienes ese campo (Anthropic lo está liberando gradualmente), usa la URL secreta: en Configuración → API Keys, haz clic en "URL MCP" en la clave deseada para generar una dirección con el formato https://app.syncro.chat/mcp/t/SEU_TOKEN y pégala como URL del conector — en ese caso no hace falta indicar encabezado.

API de OpenAI (Responses / Agents)

{
  "type": "mcp",
  "server_label": "syncro",
  "server_url": "https://app.syncro.chat/mcp",
  "headers": { "X-API-Key": "SUA_API_KEY" }
}

• La IA actúa con los permisos de tu API Key y queda restringida exclusivamente a tu cuenta — nunca accede a datos de otras empresas.
• Las acciones que borran o envían mensajes (eliminar un lead, enviar un WhatsApp) exigen confirmación antes de ejecutarse. El servidor nunca ejecuta ese tipo de acción por su cuenta.
• Trata la API Key y la URL secreta como una contraseña: no las compartas, no las publiques en capturas ni mensajes. Cualquier persona que las tenga puede operar tu CRM.
• Puedes revocar el acceso en cualquier momento (ver abajo).

El servidor MCP de Syncro no consume créditos de IA de tu plan — solo expone las acciones del CRM. El costo del modelo de lenguaje corre por cuenta del cliente que uses (tu suscripción de Claude/ChatGPT o tu cuenta de API).

Las llamadas comparten el límite de la API de Syncro: 60 solicitudes por minuto por clave. Si usas la misma clave en otras integraciones (como n8n o WordPress), considera crear una clave separada para el MCP.

• Para desconectar todo: en Configuración → API Keys, revoca la API Key usada. Cualquier cliente que la utilizara pierde el acceso al instante.
• Para desactivar solo la URL secreta (manteniendo la API Key): en la misma pantalla, haz clic en revocar la URL MCP de esa clave.

¿La IA ve los datos de otras empresas? No. El acceso está aislado por cuenta y limitado a los permisos de tu API Key.

¿Necesito saber programar? No. En Claude.ai y en ChatGPT la conexión se hace por la interfaz. El comando de terminal es solo para quien usa Claude Code.

¿Funciona con mi WhatsApp? Sí. La IA envía mensajes por los números de WhatsApp ya conectados en tu cuenta (texto y, en los números oficiales, plantillas aprobadas). Fuera de la ventana de 24 horas de los números oficiales, usa una plantilla.

¿La IA puede borrar algo sin que yo quiera? No sin confirmación. Las acciones destructivas siempre piden tu aprobación en el propio asistente antes de ejecutarse.

No aparece la tarjeta de MCP en Integraciones. ¿Y ahora? El recurso se habilita por cuenta. Habla con el soporte para activarlo.