O servidor MCP

MCP é o jeito como um app de IA usa ferramentas de fora. Conecte o Claude, o ChatGPT, o Codex ou qualquer cliente MCP ao whatsapi, e ele pode enviar mensagens, ler conversas e cuidar dos seus números. Cada ferramenta vem da mesma definição da versão REST, então você tem a mesma validação, a mesma cota e os mesmos erros.

Claude Code e Codex: instale o plugin

O plugin do whatsapi conecta seu agente ao whatsapi. Não tem chave para copiar.

Claude Code

claude plugin marketplace add owe-br/plugins
claude plugin install whatsapi@owe-br

Depois digite /mcp, escolha whatsapi e clique em Authenticate.

Codex

codex plugin marketplace add owe-br/plugins
codex plugin add whatsapi@owe-br
codex mcp login whatsapi

A última linha faz o login. Ela precisa do Codex 0.147 ou mais novo: as versões antigas falham com "missing required issuer". Para atualizar, rode npm install -g @openai/codex@latest.

Nos dois casos, o navegador abre o whatsapi. Entre e clique em Conectar. Isso cria uma chave de API com o nome do app, listada em Chaves de API no painel. Para desconectar o app, revogue essa chave.

Ver o plugin no GitHub

claude.ai e ChatGPT: adicione um conector

Nos apps que fazem login pelo navegador, adicione um conector personalizado com este endereço e sem chave:

MCP URL

https://api.whatsapi.sh/mcp

O app abre o whatsapi, você entra e clica em Conectar. Ele ganha uma chave de API própria, e as mensagens dele contam na sua cota mensal como as de qualquer outra chave.

Um agente sem navegador

Um script num servidor ou num container pode entrar com um código curto em vez de colar uma chave. Comece o login:

curl https://api.whatsapi.sh/oauth/device_authorization -d client_id=whatsapi-agent

Mostre para a pessoa o link verification_uri_complete. Ela abre, confere o código e clica em Conectar. Enquanto isso, peça a chave a cada 5 segundos:

# device_code comes from the first answer
curl https://api.whatsapi.sh/oauth/token \
  -d client_id=whatsapi-agent \
  -d grant_type=urn:ietf:params:oauth:grant-type:device_code \
  -d device_code=DEVICE_CODE

Até ela clicar em Conectar, a resposta é authorization_pending. Depois disso, access_token é uma chave wa_, enviada uma vez só. O código expira em 10 minutos.

Qualquer outro cliente: use uma chave

Crie uma chave em Chaves de API no painel e mande no header Authorization. A maioria dos clientes aceita um bloco como este:

mcp.json

{
  "mcpServers": {
    "whatsapi": {
      "type": "streamable-http",
      "url": "https://api.whatsapi.sh/mcp",
      "headers": { "Authorization": "Bearer wa_your_key" }
    }
  }
}

O que um app pode ver e o que guardamos sobre ele: Privacidade ao conectar um app de IA.

Carregando a lista de ferramentas…