MCP Integration

O protocolo MCP permite que LLMs como Claude usem ferramentas externas. Com z-mcp, voce conecta seu WhatsApp diretamente ao Claude Desktop.

O que e MCP?

MCP (Model Context Protocol) e o padrao criado pela Anthropic para permitir que modelos de linguagem interajam com ferramentas externas. Pense como uma forma de dar “superpoderes” ao Claude: ele pode enviar mensagens, buscar informacoes, transcrever audios e muito mais.

O z-mcp implementa esse protocolo para WhatsApp via SSE (Server-Sent Events), permitindo que voce controle suas conversas diretamente pelo Claude Desktop, Cursor, Continue ou qualquer outro cliente MCP - tudo na nuvem, sem instalar nada.

100% Cloud

Nao precisa instalar nada no seu computador. A conexao e feita diretamente com sua instancia z-mcp na nuvem via SSE.

Configurando no Claude Desktop

1. Localize o arquivo de configuracao

Caminho do arquivo

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

2. Adicione a configuracao do z-mcp

Copie sua URL e API key do dashboard da sua instancia:

claude_desktop_config.jsonjson
{
  "mcpServers": {
    "whatsapp": {
      "transport": {
        "type": "sse",
        "url": "https://sua-instancia.z-mcp.com/api/mcp/sse?key=sua-api-key"
      }
    }
  }
}

3. Reinicie o Claude Desktop

Feche completamente o Claude Desktop e abra novamente. As ferramentas do WhatsApp estarao disponiveis automaticamente.

API Key e URL

Substitua “sua-instancia” e “sua-api-key” pelos valores reais do seu dashboard. Voce encontra em Configuracoes da sua instancia.

Ferramentas Disponiveis

Apos configurar, voce pode usar estas ferramentas diretamente no Claude:

send_message

Envia uma mensagem de texto para um contato ou grupo

Parametros:

tostringNumero de telefone ou ID do grupo
textstringConteudo da mensagem

Exemplo de uso:

Envie uma mensagem para +55 11 99999-9999 dizendo: "Ola! Tudo bem?"

search_messages

Busca mensagens por texto, contato ou periodo

Parametros:

querystringTermo de busca
chat_idstringID do chat (opcional)
limitnumberQuantidade maxima de resultados

Exemplo de uso:

Busque as mensagens que mencionam "reuniao" nas ultimas 24 horas.

list_contacts

Lista todos os contatos salvos

Parametros:

limitnumberQuantidade maxima de contatos

Exemplo de uso:

Liste meus 10 contatos mais recentes.

get_conversation

Retorna as mensagens de uma conversa especifica

Parametros:

chat_idstringID do chat ou numero de telefone
limitnumberQuantidade de mensagens

Exemplo de uso:

Mostre as ultimas 20 mensagens da conversa com Joao Silva.

transcribe_audio

Transcreve um audio do WhatsApp para texto usando Whisper

Parametros:

message_idstringID da mensagem de audio

Exemplo de uso:

Transcreva o ultimo audio que recebi.

analyze_image

Analisa uma imagem enviada no WhatsApp usando Vision AI

Parametros:

message_idstringID da mensagem de imagem
promptstringO que analisar na imagem

Exemplo de uso:

Analise a ultima imagem que recebi e descreva o que tem nela.

Outros Clientes MCP

O z-mcp funciona com qualquer cliente que suporte o protocolo MCP via SSE:

  • Claude Desktop - Cliente oficial da Anthropic
  • Cursor - Editor de codigo com IA integrada
  • Continue - Extensao para VS Code e JetBrains
  • Zed - Editor moderno com suporte MCP
  • ChatGPT - Via OpenAPI Actions (veja docs)

A configuracao e similar em todos: basta usar a URL SSE com sua API key.

ChatGPT Integration

O z-mcp tambem gera automaticamente uma especificacao OpenAPI compativel com ChatGPT Actions. Acesse:

https://sua-instancia.z-mcp.com/api/mcp/openapi-actions

Use essa URL para configurar um GPT customizado que pode enviar e receber mensagens do seu WhatsApp.

Dica

Combine ferramentas para automacoes poderosas. Por exemplo: “Busque todas as mensagens sobre fatura do ultimo mes e resuma em um relatorio.”

Vantagens do z-mcp Cloud

  • Sem instalacao - Tudo funciona via conexao SSE
  • Sempre atualizado - Novas features automaticamente
  • Multi-dispositivo - Use em qualquer computador
  • Seguro - Conexao criptografada, API key unica