Picchat
MCP · Claude · API oficial

MCP do WhatsApp para o seu agente de IA

Conecte o Claude — ou qualquer cliente MCP — à sua conta do Picchat. O agente lê tíquetes, contatos e campanhas com as mesmas permissões que você tem no painel e, na conta Infra, manda mensagens e templates pelo número oficial.

— [ o que é ]

O que é o MCP do Picchat

MCP (Model Context Protocol) é o padrão aberto para conectar agentes de IA a ferramentas externas. Com o MCP do Picchat, o Claude Desktop, o Claude Code, o claude.ai e outros clientes compatíveis passam a enxergar a sua conta como um conjunto de ferramentas que eles chamam sozinhos.

Em qualquer conta, as ferramentas são de leitura, com os mesmos nomes do painel: tíquetes, mensagens, contatos, propriedades, tags, listas, campanhas, automações, canais, templates, usuários, notas, assistentes de IA e bases de conhecimento. Dá para perguntar "quantas conversas ficaram sem resposta ontem?" e o agente busca.

Na conta Infra, para desenvolvedores, o agente também envia mensagens e templates, cria canais e templates, gerencia webhooks e consulta o saldo — tudo pela API oficial da Meta.

O MCP é um cliente da API pública do Picchat: não acessa banco de dados e não guarda segredo além do seu token. O token age como o seu usuário, então o agente só vê o que você vê no painel.

— [ o que o agente faz ]

Exemplos de uso

Relatório em linguagem natural

"Resuma as conversas sem resposta de ontem por equipe" — o agente consulta tíquetes e mensagens e devolve o resumo.

Análise de campanha

"Qual campanha do mês teve mais respostas?" — o agente lê campanhas e automações e compara.

Auditoria de templates

Liste os templates por status e categoria e descubra quais estão pausados ou rejeitados.

Agente que envia (conta Infra)

O seu agente manda mensagens e templates pelo número oficial e recebe as respostas por webhook no seu backend.

Permissões respeitadas

O token segue o grupo de permissão do usuário e os canais vinculados a ele. Quem não pode ver campanhas no painel também não vê pelo MCP.

Para a equipe toda

Um arquivo .mcp.json no repositório do time deixa o MCP configurado para todo mundo, cada um com o próprio token.

— [ instalação ]

Conecte em um comando

Gere um token pessoal em Minha conta → Conectar ao Claude. Depois, escolha o cliente.

Claude Code
claude mcp add picchat -e PICCHAT_TOKEN=SEU_TOKEN -- npx -y picchat-mcp
Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "picchat": {
      "command": "npx",
      "args": ["-y", "picchat-mcp"],
      "env": { "PICCHAT_TOKEN": "SEU_TOKEN" }
    }
  }
}
Servidor remoto (conectores que aceitam MCP por HTTP)
URL: https://mcp.picchat.io/mcp
Header: Authorization: Bearer SEU_TOKEN

Perguntas frequentes

O MCP do Picchat é oficial?

É o servidor MCP mantido pelo Picchat, publicado no npm como picchat-mcp, e conversa com a API oficial do WhatsApp da Meta por trás da API do Picchat.

Funciona com quais clientes?

Claude Desktop e Claude Code pelo pacote npx, e clientes que aceitam MCP por HTTP pelo servidor remoto em mcp.picchat.io.

O agente consegue mandar mensagem pelo WhatsApp?

Na conta Infra, sim: envio de mensagens e templates pela API oficial. Nas contas da plataforma, as ferramentas do MCP são de consulta; o envio acontece pelas automações, campanhas e agentes de IA do painel.

É seguro dar acesso da minha conta a uma IA?

O token age como o seu usuário e respeita o grupo de permissão e os canais vinculados a ele. Você pode revogar o token a qualquer momento na mesma tela em que criou.

Quanto custa?

O MCP não tem custo à parte: ele usa a sua conta do Picchat. Para desenvolvedores, há plano sem mensalidade a R$ 0,04 por disparo; a tarifa da Meta é cobrada à parte.

Dê o WhatsApp oficial ao seu agente

Gere o token, rode um comando e o Claude passa a enxergar a sua conta.