---
title: "Conecte seu agente de IA ao WhatsApp: MCP na prática (Claude, Cursor e n8n)"
description: "O MCP da WAME dá ao seu agente de IA acesso real ao WhatsApp, Instagram e Messenger: ler, responder, enviar mídia e gerenciar grupos. 21 ferramentas prontas."
url: "https://wame.api.br/blog/mcp-agente-ia-whatsapp"
language: "pt-BR"
og:type: "article"
published_time: "2026-09-10"
modified_time: "2026-09-10"
author: "Raphael Serafim"
keywords: "mcp whatsapp, agente de ia whatsapp, claude whatsapp, model context protocol whatsapp, ia que responde whatsapp, mcp server whatsapp, integrar ia com whatsapp"
reading_time: "8 min de leitura"
---

# Conecte seu agente de IA ao WhatsApp: MCP na prática (Claude, Cursor e n8n)

> O MCP da WAME dá ao seu agente de IA acesso real ao WhatsApp, Instagram e Messenger: ler, responder, enviar mídia e gerenciar grupos. 21 ferramentas prontas.

**O trabalho de conectar uma IA ao WhatsApp sempre foi o mesmo: escrever a integração.** Definir as funções, descrever cada parâmetro para o modelo, tratar a resposta, manter isso vivo quando a API muda. Meia semana de trabalho antes de a primeira mensagem sair.

O MCP corta essa etapa. A WAME publica um servidor **Model Context Protocol** em `https://mcp.wame.api.br`, e o seu agente descobre sozinho o que consegue fazer.

## O que muda na prática

Sem MCP, você escreve algo assim para cada capacidade que o agente precisa:

```js
const tools = [{
  name: 'enviar_whatsapp',
  description: 'Envia uma mensagem de texto no WhatsApp',
  parameters: {
    type: 'object',
    properties: {
      to: { type: 'string', description: 'Número com DDI' },
      text: { type: 'string' },
    },
    required: ['to', 'text'],
  },
}];
// ...e o handler que de fato chama a API, e o tratamento de erro,
// e a mesma coisa de novo para ler conversas, mandar mídia, criar grupo...
```

Com MCP, você não escreve nada disso. O servidor já declara as ferramentas, e o agente as lê ao conectar.

## Conectar

No **Claude Code**, um comando:

```bash
claude mcp add --transport http wame https://mcp.wame.api.br
```

Em **Cursor**, **Claude Desktop** ou qualquer cliente com interface de MCP, o caminho é o mesmo: adicionar um servidor HTTP e colar `https://mcp.wame.api.br`. O cliente pede a autorização da sua instância e pronto.

Depois disso, você conversa:

> "Veja se alguém do time comercial ficou sem resposta hoje e me mostre."

E o agente chama `find_pending_replies` e `list_chats` por conta própria. Você não escolheu a ferramenta — ele escolheu.

## As 21 ferramentas

Elas cobrem o ciclo inteiro de uma conversa, não só o disparo:

**Conversar**

| Ferramenta | Parâmetros | O que faz |
|---|---|---|
| `send_message` | `to`, `text`, `channel?` | Envia texto no canal escolhido |
| `send_media` | `to`, `type`, `url`, `caption?` | Imagem, vídeo, áudio, documento |
| `reply_to_message` | `messageId`, `to`, `text` | Responde citando a mensagem |
| `react_to_message` | `messageId`, `emoji` | Reage com emoji |
| `set_typing` | `to`, `status` | Mostra "digitando…" |

**Ler e entender**

| Ferramenta | Parâmetros | O que faz |
|---|---|---|
| `list_chats` | `limit?`, `onlyUnread?` | Lista as conversas |
| `read_messages` | `chatId`, `limit?`, `page?` | Lê o histórico de uma conversa |
| `wait_for_message` | `timeoutSeconds?`, `chatId?` | Espera a próxima mensagem chegar |
| `find_contact` | `query` | Acha o número pelo nome |
| `check_number_registered` | `number` | Confere se o número tem WhatsApp |
| `mark_as_read` | `messageId`, `typing?` | Marca como lida |

**Operar**

| Ferramenta | Parâmetros | O que faz |
|---|---|---|
| `get_instance_status` | — | Estado da conexão |
| `list_templates` | `onlyApproved?` | Templates disponíveis |
| `send_template` | `templateName`, `recipients[]`, `confirm?` | Dispara template aprovado |
| `get_analytics` | `report?`, `since?`, `until?` | Métricas de atendimento |

**Grupos**

`list_groups`, `get_group`, `create_group`, `update_group`, `manage_group_participants`, `leave_group` — criar grupo, entrar, sair, adicionar e remover participante.

## Três canais, o mesmo agente

`send_message` aceita `channel`. Isso não é detalhe de API: é consequência de a WAME entregar **WhatsApp, Instagram Direct e Messenger na mesma instância**, com [um único formato de webhook](/blog/webhook-whatsapp-instagram-messenger-padrao-meta).

O agente que responde no WhatsApp responde no Direct do Instagram sem uma linha a mais. Se você já leu sobre [os três canais na mesma API](/blog/api-instagram-messenger-mesma-api-whatsapp), é a mesma instância — agora acessível por IA.

## Onde isso é útil de verdade

**Triagem de caixa de entrada.** "Quais conversas de ontem ficaram sem resposta e qual o assunto de cada uma?" O agente lê, resume e devolve uma lista. Ninguém abre 40 conversas na mão.

**Operação assistida.** "Manda o comprovante em PDF pro cliente que perguntou sobre a nota fiscal." Ele acha o contato, encontra a mensagem e envia a mídia.

**Suporte a quem desenvolve.** Dentro do Cursor ou do Claude Code, com o MCP conectado, dá para testar o comportamento real da API enquanto você escreve o código que vai usá-la. O agente manda a mensagem de teste, lê o que chegou e você compara com o que o seu handler esperava.

**Automação em fluxo.** No n8n, o mesmo servidor MCP entra como ferramenta de um nó de agente — útil quando o fluxo já existe e você só quer dar a ele capacidade de conversar. Se o seu caso é um bot completo com memória por contato, o caminho mais direto continua sendo [o template pronto de n8n](/blog/bot-ia-n8n-whatsapp-instagram-messenger).

## O que o MCP não é

**Não substitui a API.** Se o seu sistema precisa mandar uma confirmação de pedido quando o status muda no banco, isso é [uma chamada da sua API](/blog/como-enviar-mensagem-whatsapp-api), não um agente decidindo. Código determinístico continua sendo a resposta certa para fluxo determinístico.

**Não é um bot pronto.** O MCP dá capacidade ao agente; a conversa, o tom e as regras continuam sendo sua definição.

**Não dá acesso ao que você não autorizou.** O escopo é a instância conectada. E `send_template`, que é a única ferramenta capaz de atingir muita gente de uma vez, pede `confirm` antes de disparar — de propósito.

## Como começar

1. Crie uma instância no [portal](https://dash.wame.api.br/) — a não oficial conecta por QR Code em segundos, e serve perfeitamente para testar.
2. Conecte o MCP com o comando acima.
3. Peça algo simples ao agente: *"qual o status da minha instância?"*. Se ele responder, está tudo no lugar.
4. Só então aponte para a instância de produção.

A página do [MCP da WAME](/mcp) tem a referência completa das ferramentas, os limites de cada uma e os prompts que costumam funcionar melhor.

## Conclusão

Integrar IA ao WhatsApp deixou de ser um projeto e virou uma linha de configuração. O ganho real não é economizar as horas da integração — é que, quando a API ganha uma capacidade nova, o agente passa a enxergá-la sem você reescrever nada. A ferramenta nova aparece na lista, e ele a usa.

Se você entrega sistemas para clientes, isso vale ainda mais: [o mesmo código serve todo projeto](/api-whatsapp-para-software-house), e agora o mesmo agente também.

## Perguntas frequentes

### O que é o MCP da WAME?

É um servidor Model Context Protocol hospedado em https://mcp.wame.api.br que expõe a WAME API como ferramentas para agentes de IA. Em vez de você escrever código para o agente falar com o WhatsApp, ele descobre as ferramentas sozinho e chama direto: enviar mensagem, ler conversas, responder, criar grupo, disparar template.

### Preciso programar para usar o MCP?

Não para conectar. No Claude Code é um comando: claude mcp add --transport http wame https://mcp.wame.api.br. Em clientes com interface, você cola a URL do servidor. A partir daí o agente já enxerga as ferramentas. Programar só é necessário se você quiser embutir isso dentro do seu próprio produto.

### O MCP funciona com WhatsApp, Instagram e Messenger?

Sim. As ferramentas de envio aceitam um parâmetro de canal, porque a WAME entrega os três canais oficiais da Meta numa única instância. O mesmo agente atende os três sem integração separada por canal.

### É seguro dar acesso do WhatsApp a um agente de IA?

O acesso é o da instância que você autorizou, e nada além. Ferramentas de disparo em massa, como o envio de template para vários destinatários, exigem confirmação explícita antes de executar. A recomendação é começar com uma instância de teste e só depois apontar para a de produção.

### Qual a diferença entre usar MCP e usar a API direto?

A API direto é para o seu sistema: código que você escreve, testa e faz deploy. O MCP é para o agente: ele lê a descrição das ferramentas e decide qual chamar em tempo de execução. Os dois usam a mesma instância e a mesma conta — MCP não substitui a API, ele evita escrever integração para o caso em que quem age é uma IA.