> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifique MCP

> Conecte Cursor, Claude u otros IDE a Notifique y envíe mensajes desde el chat.

<Tip>
  MCP es el **camarero** de su IDE: usted pregunta en lenguaje sencillo ("enviar un WhatsApp", "listar webhooks fallidos") y la IA llama a la API Notifique por usted.
</Tip>

## ¿Qué es MCP?

**MCP** (Model Context Protocol) es un puente entre la IA de su computadora y la API de Notifique. En lugar de elaborar solicitudes HTTP a mano, chatea y la IA utiliza herramientas listas para usar.

Piensa en un camarero: tú pides el plato; lo llevan a la cocina (API) y traen la respuesta.

Servidor: `https://mcp.notifique.dev/mcp`. Utiliza la **misma Clave API** que su aplicación.

## ¿Para qué sirve?

Con MCP puedes:

* **Enviar** WhatsApp (texto, botones, lista, medios), SMS, correo electrónico, push, RCS, voz e Instagram Direct
* **Conectar** WhatsApp oficial (Cloud API) o no oficial (QR)
* **Consultar** estado de mensajes, instancias, plantillas, contactos y webhooks
* **Sincronizar** plantillas con Meta WABA (`whatsapp.sync_templates`, `whatsapp.push_template`)
* **Administrar** instancias y ver métricas (`metrics_overview`, `metrics_logs`)
* **Notificar** a través de múltiples canales en una llamada vía `POST /v1/notify`

Herramientas comunes: `whatsapp.send_text`, `whatsapp.send`, `whatsapp.create_instance`, `messages.send_template`, `messages.send_sms`, `messages.send_email`. Para voz, use **`POST /v1/voice/calls`** a través de una herramienta genérica.

¿No está seguro de qué herramienta utilizar? Pregunte por **`system.help`** o **`system.capabilities`**.

***

## WhatsApp oficial en MCP

Piense en Cloud API como el **contador oficial** de Meta: fuera del período de 24 horas, solo puede enviar una **plantilla aprobada**; dentro se permiten texto, botones y listas.

| Tarea                                      | Herramienta                            | Detalle                                                                                      |
| ------------------------------------------ | -------------------------------------- | -------------------------------------------------------------------------------------------- |
| Crear línea no oficial (QR)                | `whatsapp.create_instance`             | `mode: "UNOFFICIAL"` (predeterminado)                                                        |
| Crear línea oficial (credenciales propias) | `whatsapp.create_instance`             | `mode: "OFFICIAL_BYOK"` + `metaAccessToken` + `metaPhoneNumberId` (+ `metaWabaId`)           |
| Crear oficial con enlace compartible       | `whatsapp.create_instance`             | `mode: "OFFICIAL"` + `generateShareableLink: true`                                           |
| Embedded Signup en el navegador            | Panel / Aura                           | MCP **no puede** abrir inicio de sesión Facebook; use el panel, Aura o el enlace compartible |
| Enviar texto / botones / lista             | `whatsapp.send` o `whatsapp.send_text` | Líneas oficiales: solo con ventana de 24 h abierta                                           |
| Fuera de 24 h                              | `messages.send_template`               | Plantilla `WHATSAPP_OFFICIAL` + `APPROVED`                                                   |
| Sincronizar Meta ↔ local                   | `whatsapp.sync_templates`              | `mode: preview` luego `apply`                                                                |
| Publicar plantilla en WABA                 | `whatsapp.push_template`               | Refleja HEADER/FOOTER/BUTTONS/carrusel                                                       |

Ejemplo, crear una instancia oficial en modo avanzado:

Ejemplo, mensaje con botones (sesión, dentro de 24 h):

<Warning>
  Si la API devuelve `META_TEMPLATE_REQUIRED`, la línea oficial está fuera de la ventana de 24 horas. Utilice `messages.send_template`, no vuelva a intentarlo con texto libre.
</Warning>

<Info>
  Guía completa Cloud API: [Inicio rápido oficial](/es/whatsapp-api/como-funciona/quick-start). QR vs oficial: [Modos de conexión](/es/whatsapp-api/como-funciona/modos-de-conexao).
</Info>

## ¿Cuándo usarlo?

| Situación                                    | ¿Usar MCP?                            |
| -------------------------------------------- | ------------------------------------- |
| Probar un envío sin salir de Cursor o Claude | **Sí**                                |
| Generar código que corre en su backend       | No (use LLMs.txt + Skill)             |
| Automatización visual sin código             | No (use [n8n](/es/build-with-ai/n8n)) |

## Frases de ejemplo

* "¿Cuál es el estado del mensaje X?"
* "¿Qué instancias de WhatsApp están activas? ¿Cuáles son oficiales?"
* "Crear una conexión oficial de WhatsApp con mi token y mi número de teléfono"
* "Enviar un mensaje de texto al +1..."
* "Enviar un mensaje de botones Sí/No a este número"
* "Sincronizar plantillas Meta en esta instancia"
* "Mostrar webhooks que fallaron hoy"
* "Enviar un RCS al 5511999999999"
* "Originar una llamada de voz al +5511999887766 diciendo Hola"
* "Enviar un DM de Instagram a @nombredeusuario"

## Cómo configurar

### Escritorio Claude

Edite el archivo de configuración:

* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

Reemplace `sk_...` con su clave y reinicie Claude.

### Cursor

Abra **Settings → MCP** o cree `.cursor/mcp.json` en la raíz del proyecto:

### Claude Code

### Otras apps MCP

Use la URL `https://mcp.notifique.dev/mcp` y envíe la clave en el encabezado:

* `X-API-Key: sk_...`
* o `Authorization: Bearer sk_...`

<Warning>
  Nunca ponga su clave en un repositorio público. ¿Se filtró? Revóquela en el panel y cree una nueva.
</Warning>

## Probar si el servidor está activo

No se necesita Clave API:

Si ve `"ok": true`, el servidor está funcionando.

## Seguridad y consejos

| Tema                           | Comportamiento                                            |
| ------------------------------ | --------------------------------------------------------- |
| **Clave no válida**            | Respuesta **401**                                         |
| **Acciones sensibles**         | Puede pedir `confirm: "YES"`                              |
| **Logs**                       | La clave completa no se muestra                           |
| **Varias instancias WhatsApp** | Pase **`instanceId`** al enviar                           |
| **Reintento**                  | Use **`idempotencyKey`** en envíos                        |
| **Estado de un mensaje**       | Use la herramienta del canal (ej. `whatsapp.get_message`) |

<Note>
  [Notifique MCP](/es/build-with-ai/mcp-notifique) (IDE + Clave API) es **diferente** del asistente MCP del espacio de trabajo. Ver [Automatizaciones](/es/automations-api/como-funciona/introducao).
</Note>

***

## Próximos pasos

* [Construir con IA](/es/build-with-ai/hub): descripción general
* [LLMs.txt](/es/build-with-ai/llm): mapa para generar código
* [Skills](/es/build-with-ai/skills): recetas por tarea
* [Claves API](/es/guides/api-key/index): crear y revocar claves
* [Sandbox](/es/guides/sandbox/index): prueba con `sk_test_...`