MCP: tu cuenta desde una IA
La referencia técnica del servidor MCP de administración. Para el paso a paso de cada IA, la guía.
| Servidor | https://api.waiaconnect.com/mcp/admin (MCP sobre HTTP, «Streamable HTTP») |
|---|---|
| Autenticación | OAuth 2.1 con registro dinámico (Claude, ChatGPT, Cursor, VS Code): la persona entra con su Google y elige los números. O un token MCP wcm_… creado en el panel, en Authorization: Bearer. Es distinto de la clave de la API (wc_live_…). |
| Permisos | admin:read (todos) y admin:write (dueño o administrador; un miembro sólo lee). La autorización vence a los 90 días sin uso. |
| Lectura | estado_cuenta · numeros · webhooks · plantillas · errores · api_explicar · generar_codigo · chequeo_alta |
| Escritura (2 pasos) | preparar_webhook_crear · preparar_webhook_editar · preparar_webhook_borrar · preparar_webhook_probar · preparar_plantilla_crear · preparar_mensaje_prueba · preparar_clave_rotar · confirmar. Cada preparar_* valida sin tocar nada y devuelve una vista previa y un código de confirmación de 5 minutos; confirmar aplica exactamente eso, una sola vez. Con topes por día (por ejemplo, 10 mensajes de prueba, sólo a los números de la cuenta o a sus teléfonos de prueba). La plantilla va a revisión de Meta. La clave nueva de la API y el secreto de un webhook no se le dan a la IA: se ven una vez en el panel. |
| Privacidad | Es para la administración de la cuenta: nunca lee ni guarda el contenido de los mensajes ni les escribe a tus clientes. Lo que viene de Meta o de terceros se marca como no confiable para la IA. |