Cómo conectar Interakt a ChatGPT vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Interakt, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Interakt + ChatGPT

Deja que tu IA trabaje con tu cuenta de Interakt para WhatsApp Business: lista las plantillas aprobadas, busca y lista clientes con sus atributos y etiquetas, añade o actualiza clientes, registra eventos y asigna chats. El envío de mensajes de plantilla y de texto está desactivado al instalar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

INTERAKT_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de Interakt con el plan Growth o superior: el acceso a la API empieza ahí.

1. En Interakt, abre Settings → Developer Setting.
2. Copia la Secret Key en INTERAKT_API_KEY tal como aparece, sin la palabra Basic delante. La clave ya viene codificada, y el conector solo la envía a api.interakt.ai.
3. Instala el conector y ejecuta interakt_list_templates: lista tus plantillas de WhatsApp y confirma que la clave y tu plan funcionan.

Números de teléfono: casi todas las herramientas piden el número sin prefijo de país y el prefijo aparte, por ejemplo 9876543210 y +91 (India es el valor por defecto). La herramienta de texto libre pide el número completo sin +, por ejemplo 919876543210.

Qué lee: tus plantillas de WhatsApp con nombre de código, nombre visible, idioma, categoría, estado de aprobación, cabecera, cuerpo con sus variables, pie y botones; clientes por teléfono o id de Interakt, con atributos como nombre, email, opt-in de WhatsApp y tus atributos propios, además de etiquetas y fechas de alta y última modificación; y los clientes creados o actualizados en un intervalo, de 100 en 100.

Sin historial de mensajes: la API de Interakt no devuelve mensajes pasados ni el estado de entrega, que solo llegan a los webhooks de Interakt. La IA no puede decirte si un cliente leyó un mensaje.

Pregunta antes de cada cambio: interakt_upsert_customer crea un cliente o actualiza el que tiene el mismo número (los atributos se combinan y las etiquetas se añaden, nunca se quitan), interakt_track_event registra un evento como Order Placed en la línea de tiempo del cliente, lo que puede lanzar automatizaciones de Interakt que le escriban, y interakt_assign_chat asigna el chat de un cliente en la bandeja compartida a un miembro del equipo por email. La IA te muestra el cliente y el cambio exacto y espera tu sí.

Desactivadas al instalar: interakt_send_template y interakt_send_text. Llegan al cliente al instante, y por las plantillas Meta cobra la conversación. El texto libre solo funciona en las 24 horas siguientes al último mensaje del cliente; fuera de esa ventana Interakt lo rechaza y solo sirve una plantilla aprobada. Una plantilla necesita exactamente un valor por variable ({{1}}, {{2}}, etc.), en orden, así que la IA lee primero la plantilla y las cuenta; las plantillas con cabecera de imagen o documento necesitan además un enlace público al archivo. Un administrador activa estas herramientas a propósito, e incluso entonces la IA te muestra la plantilla o el texto, el número y los valores y espera tu sí. Una respuesta correcta significa que Interakt aceptó el mensaje, no que se entregara.

Límites: Interakt permite 300 peticiones por minuto en Growth y 600 en Advanced, y cada petición puede ocupar como máximo 32 KB. Tras un 429 la IA espera un minuto antes de reintentar.

Errores comunes: 401 significa que la clave es incorrecta o que tu plan no tiene acceso a la API: copia otra vez la Secret Key sin Basic y comprueba que tienes Growth o superior. 400 indica un campo que falta o es incorrecto, y el mensaje de Interakt dice cuál, por ejemplo "Missing variable values for template's body" cuando falta un valor de la plantilla. 429 indica que se alcanzó el límite de peticiones.

El conector no crea plantillas, no lanza campañas, no sube archivos multimedia, no recurre a RCS ni SMS y no gestiona webhooks.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en ChatGPT

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, pulsa + y luego Add custom MCP server.
2. Escribe un nombre, por ejemplo Name: Interakt.
3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

Herramientas disponibles

Ejemplos de prompts

• "Busca a la clienta +91 98765 43210 y enséñame su nombre, sus etiquetas y si aceptó recibir WhatsApp."
• "¿Cuáles de nuestras plantillas aprobadas son de marketing y cuántas variables necesita cada una?"
• "Lista los clientes que se añadieron o actualizaron ayer en Interakt."
• "Registra un evento Order Placed para +91 98765 43210 con el pedido 1042 y un total de Rs 1,499. Enséñamelo antes."
• "Asigna el chat de Rahul Sharma (+91 99887 76655) a [email protected]. Confírmalo conmigo antes de hacerlo."

FAQ

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse