--- title: "MCP WhatsApp: conecte seu agente de IA em 1 comando" description: "O MCP da WAME dá ao seu agente de IA acesso real ao WhatsApp, Instagram e Messenger: ler conversas, responder, enviar mídia, criar templates e gerenciar grupos. Um comando para conectar, 21 ferramentas prontas — sem escrever integração." url: "https://api-wa.me/blog/mcp-agente-ia-whatsapp" language: "pt-BR" og:type: "article" og:site_name: "WAME API" --- [Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Conecte seu agente de IA ao WhatsApp: MCP na prática (Claude, Cursor e n8n) Raphael Serafim· Publicado em 10 de setembro de 2026· 8 min de leitura Compartilhar # 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 conversas, responder, enviar mídia, criar templates e gerenciar grupos. Um comando para conectar, 21 ferramentas prontas — sem escrever integração. Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/mcp-agente-ia-whatsapp.md) **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](https://api-wa.me/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](https://api-wa.me/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](https://api-wa.me/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](https://api-wa.me/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://portal.api-wa.me/) — 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](https://api-wa.me/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](https://api-wa.me/api-whatsapp-para-software-house), e agora o mesmo agente também. ### Pronto para automatizar seu WhatsApp? Crie sua conta gratuita e comece a enviar mensagens pela API em minutos. [Começar grátis](https://portal.api-wa.me/sign-up) ## 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. ## Continue lendo [### Como criar um chatbot de IA com a API da OpenAI para responder no WhatsApp Um webhook, uma chamada à API da OpenAI e uma resposta pela WAME API: o código completo de um chatbot de IA que atende no WhatsApp, Instagram e Messenger. Com memória por contato, controle de custo e o que fazer quando a IA não deve responder.](https://api-wa.me/blog/chatbot-ia-openai-whatsapp)[### Cobrança por Pix dentro do WhatsApp pela API: como enviar e o que muda na conversão Mandar o código Pix no WhatsApp resolve o pior ponto da cobrança digital: o cliente não precisa sair do app. Como enviar a cobrança pela API, tratar a confirmação e evitar os erros que transformam a facilidade em suporte.](https://api-wa.me/blog/cobrar-pix-whatsapp-api)[### Erros da API do WhatsApp: o que cada um significa e como tratar A mensagem não saiu e o log diz apenas 'erro ao enviar'. Os erros que você vai encontrar de verdade — janela fechada, número inválido, template não aprovado, limite atingido, instância caída — e o tratamento certo para cada um.](https://api-wa.me/blog/erros-api-whatsapp-como-tratar) [Voltar ao blog](https://api-wa.me/blog) ## Structured data ```json { "@context": "https://schema.org", "@type": "WebSite", "name": "WAME API", "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram e Messenger", "url": "https://api-wa.me", "inLanguage": "pt-BR", "publisher": { "@id": "https://api-wa.me/#organization", "@type": "Organization", "name": "WAME API", "url": "https://api-wa.me" } } { "@context": "https://schema.org", "@type": "Organization", "@id": "https://api-wa.me/#organization", "name": "WAME API", "alternateName": [ "WAME", "Wame API", "wame.api.br", "api-wa.me" ], "url": "https://api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/web-app-manifest-512x512.png", "width": 512, "height": 512 }, "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.", "identifier": { "@type": "PropertyValue", "propertyID": "INPI-BR", "name": "Pedido de registro de marca (INPI, classe NCL 42)", "value": "944724159" }, "foundingDate": "2017", "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram e Messenger numa instância só. Desde 2017.", "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.", "knowsAbout": [ "WhatsApp Cloud API oficial (Meta)", "API oficial de Instagram (Direct)", "API oficial de Messenger", "API multicanal Meta", "Meta Business Partner", "WhatsApp API", "API não oficial de WhatsApp", "automação de WhatsApp", "números virtuais", "webhooks" ], "sameAs": [ "https://github.com/wame-api", "https://www.linkedin.com/company/wameapi", "https://www.instagram.com/wame.api/", "https://www.youtube.com/@wameapi" ], "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "url": "https://api-wa.me/contact", "availableLanguage": [ "Portuguese" ] } } { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "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 conversas, responder, enviar mídia, criar templates e gerenciar grupos. Um comando para conectar, 21 ferramentas prontas — sem escrever integração.", "image": "https://api-wa.me/blog/mcp-agente-ia-whatsapp/opengraph-image", "datePublished": "2026-09-10", "dateModified": "2026-09-10", "author": { "@type": "Person", "name": "Raphael Serafim", "url": "https://github.com/raphaelvserafim", "sameAs": [ "https://github.com/raphaelvserafim" ] }, "publisher": { "@type": "Organization", "name": "api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/screenshot.png" } }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://api-wa.me/blog/mcp-agente-ia-whatsapp" }, "keywords": "mcp whatsapp, agente de ia whatsapp, claude whatsapp, model context protocol whatsapp, ia que responde whatsapp, mcp server whatsapp, integrar ia com whatsapp", "inLanguage": "pt-BR" } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://api-wa.me" }, { "@type": "ListItem", "position": 2, "name": "Blog da API do WhatsApp", "item": "https://api-wa.me/blog" }, { "@type": "ListItem", "position": 3, "name": "Conecte seu agente de IA ao WhatsApp: MCP na prática (Claude, Cursor e n8n)", "item": "https://api-wa.me/blog/mcp-agente-ia-whatsapp" } ] } { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "O que é o MCP da WAME?", "acceptedAnswer": { "@type": "Answer", "text": "É 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." } }, { "@type": "Question", "name": "Preciso programar para usar o MCP?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "O MCP funciona com WhatsApp, Instagram e Messenger?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "É seguro dar acesso do WhatsApp a um agente de IA?", "acceptedAnswer": { "@type": "Answer", "text": "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." } }, { "@type": "Question", "name": "Qual a diferença entre usar MCP e usar a API direto?", "acceptedAnswer": { "@type": "Answer", "text": "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." } } ] } ```