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

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Interakt.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

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