Cómo conectar Interakt a Claude 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 + Claude

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 Claude

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.

Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.

1. En Claude, abre Customize → Connectors.
2. Pulsa + y después Add custom connector.
3. Escribe un nombre, por ejemplo Interakt, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add.
4. Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.

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 con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

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