MCP o API MCP: qué enlace de Chatfuel usar

Chatfuel tiene dos enlaces de servidor MCP. https://mcp.chatfuel.com/panel (MCP) le da a cualquier asistente herramientas listas para usar para gestionar bots. https://mcp.chatfuel.com/panel/api (API MCP) les da a los agentes de programación toda la API GraphQL de Chatfuel, para que puedan buscar en el esquema y ejecutar cualquier consulta o mutación que tu cuenta permita.

¿Qué le da el enlace MCP al asistente?

El enlace MCP https://mcp.chatfuel.com/panel tiene herramientas tipadas que hacen una sola tarea cada una: listar bots, activar la IA, agregar entradas a las FAQ, configurar respuestas a comentarios, agregar servicios y especialistas, revisar chats, responder a un cliente, probar una respuesta en un chat de prueba (sandbox) y más. Las herramientas explican lo que cambian y piden un sí cuando hace falta, por eso el enlace MCP es adecuado para Claude, ChatGPT, Muse y el trabajo diario en cualquier asistente. Es el único enlace con la opción Read-only.

¿Qué le da el enlace API MCP al asistente?

El enlace API MCP https://mcp.chatfuel.com/panel/api es para Claude Code, Cursor, VS Code, Codex, Gemini CLI y Antigravity. Expone la Public API de Chatfuel mediante unas pocas herramientas generales:

• search_schema, list_operations, get_type y get_operation encuentran la operación de GraphQL correcta y muestran sus argumentos.
• execute_query y execute_mutation la ejecutan. execute_mutation puede verificar una solicitud con validateOnly sin enviarla.
• upload_file sube una imagen, un video, un archivo de audio o un documento y devuelve su ID de archivo.

El enlace API MCP también conserva las herramientas combinadas para las tareas más comunes: activar la IA, respuestas a comentarios, configuración de reservas, revisión de chats, diagnóstico, pruebas en sandbox y envío de un mensaje en un chat.

¿Qué puedo hacer solo con API MCP?

Algunas tareas no tienen una herramienta lista para usar y solo están disponibles en https://mcp.chatfuel.com/panel/api:

• Gestionar productos en el catálogo.
• Consultar las citas y agendarlas, moverlas, confirmarlas o cancelarlas.
• Mover leads entre etapas en el tablero de Leads.
• Crear un enlace para conectar un número de WhatsApp.
• Subir archivos.

En el enlace MCP, el asistente te remite al panel de Chatfuel para estas tareas.

¿Puedo agregar ambos enlaces?

Sí. Agrégalos con nombres distintos, por ejemplo chatfuel y chatfuel-api. Los dos enlaces son conexiones independientes: el inicio de sesión en uno no sirve para el otro, así que inicia sesión en cada uno. Un CLI token funciona en ambos enlaces.

¿Cómo se ve una solicitud GraphQL a través de API MCP?

El asistente normalmente busca en el esquema, lee la operación y la ejecuta. Para una solicitud como "Muestra la lista de mis bots", encuentra currentUser con search_schema, lo lee con get_operation y ejecuta un documento como este:

query Me {
  currentUser {
    botsV2(first: 50) {
      edges { node { id title } }
      pageInfo { hasNextPage endCursor }
    }
  }
}

El asistente solo ejecuta lo que permiten los permisos de tu cuenta. Algunas operaciones están cerradas para MCP en ambos enlaces, por ejemplo eliminar bots, gestionar a los miembros del equipo, la facturación y crear difusiones.

Problemas comunes

¿Qué enlace debo agregar a Claude o ChatGPT?

Agrega https://mcp.chatfuel.com/panel. Claude, ChatGPT y Muse funcionan con las herramientas listas para usar del enlace MCP.

¿Puedo usar API MCP con acceso de solo lectura?

No. API MCP siempre funciona con acceso completo, porque algunas consultas de GraphQL también cambian datos. Para tener acceso de solo lectura, usa el enlace MCP y activa Read-only al iniciar sesión.

El asistente dice que una operación no está disponible

Algunas operaciones están cerradas para MCP, y otras necesitan un plan activo o un rol en el bot. Haz la tarea en el panel de Chatfuel, en panel.chatfuel.com.