z-mcp

npx add-mcp 'https://api.z-mcp.com/mcp'

Conectar com login

O caminho principal usa https://api.z-mcp.com/mcp, login e autorização. Os endpoints e escopos por número abaixo continuam disponíveis em Avançado.

MCP Integration

O protocolo MCP permite que LLMs como Claude e ChatGPT usem ferramentas externas. Com z-mcp, você conecta seu WhatsApp direto na conversa.

O que é MCP?

MCP (Model Context Protocol) é o padrão 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 informações, cruzar contexto de conversas e muito mais.

O z-mcp implementa esse protocolo como servidor MCP remoto, transporte Streamable HTTP, em https://api.z-mcp.com/mcp, com login e autorização. Para chave por número, use Avançado. O endpoint antigo /api/mcp/sse foi descontinuado e responde 410. Você controla suas conversas pelo Claude, ChatGPT, Claude Code, Cursor ou qualquer outro cliente MCP... tudo na nuvem, sem instalar nada.

100% Cloud

Não precisa instalar nada no seu computador. O cliente MCP fala direto com sua instância z-mcp na nuvem.

Avançado: autenticar por chave em um número

A instância aceita a chave zmcp_... de três jeitos. Use header sempre que o cliente permitir:

Método	Exemplo	Quando usar
X-API-Key	X-API-Key: zmcp_sua-api-key	Recomendado. Funciona em Claude Code, Cursor, Windsurf e qualquer cliente que aceite headers customizados.
Authorization: Bearer	Authorization: Bearer zmcp_sua-api-key	Alternativa equivalente, para clientes que só falam Bearer.
?key= na URL	?key=zmcp_sua-api-key	Só para cliente sem campo de header (ex.: ChatGPT). A chave aparece em log de acesso; trate a URL como senha.

Avançado: ferramentas e escopos por número

Depois de configurar, estas ferramentas ficam disponíveis na conversa:

Ferramenta	Descrição	Parâmetros	Escopos
send_whatsapp_message	Envia mensagem de texto para um contato ou grupo.	to, message	full, send_only
get_recent_messages	Mensagens recentes de todos os chats ou de um só, com paginação por data.	start_date, end_date, chat_id (opcional), limit	full, read_only
get_chat_history	Histórico de uma conversa específica, reunindo aliases do mesmo contato.	chat_id, período (opcional)	full, read_only
get_message	Texto completo de uma mensagem, útil quando o conteúdo vem truncado.	chat_id, message_id	full, read_only
search_contacts	Busca contatos e chats por nome ou telefone.	query	full, read_only
get_whatsapp_status	Informa se o WhatsApp da instância está conectado.	(nenhum)	full, read_only, send_only
get_response_metrics	Média, mediana e p90 de tempo de resposta num período, com comparação mensal.	start_date, end_date	full, read_only
get_attention_chats	Lista conversas esperando resposta, ordenadas por atraso.	start_date, end_date	full, read_only
get_contact_context	Resolve contato e aliases para cruzar com reuniões no Grilo conectado.	chat_id	full, read_only

Cada chave de API tem um escopo: full chama tudo, read_only chama tudo menos send_whatsapp_message, e send_only só envia mensagem e checa status.

Um endereço, login e autorização

Use o endereço abaixo no Claude, ChatGPT ou Codex. Ele inclui os números da sua conta. O acesso é identificado pelo login; nenhuma chave precisa ser copiada.

https://api.z-mcp.com/mcp

Veja Conectar IA para cada clique e os prints das telas.

Você escolhe o acesso

A tela de autorização mostra a conta e os números. Leitura é o padrão; envio é opcional e exige sua confirmação antes de cada mensagem. Você pode revogar em Conectar IA.

Claude

Abra Configurações › Conectores › Adicionar conector personalizado. Nome: z-mcp. Cole o endereço acima, adicione e clique em Conectar. Entre no z-mcp e clique em Autorizar. Numa conversa nova, ative o conector nas ferramentas e pergunte.

ChatGPT

Abra chatgpt.com/plugins e clique em Adicionar › Adicionar servidor MCP personalizado. Nome: z-mcp. Em Conexão, cole o endereço acima; em Autenticação, mantenha OAuth. Marque Entendo e quero continuar e clique em Criar como plugin. Entre no z-mcp e autorize. Numa conversa nova, escolha z-mcp no botão +.

Depende da sua conta

O botão de servidor personalizado depende do plano e das permissões do ChatGPT. Os rótulos são da tela em português conferida em outubro de 2026.

Codex

Adicione o conector e faça login no navegador:

codex mcp add z-mcp --url "https://api.z-mcp.com/mcp"
codex mcp login z-mcp

No editor, adicione o endereço como Streamable HTTP e clique em Autenticar. A configuração manual usa:

[mcp_servers.z-mcp]
url = "https://api.z-mcp.com/mcp"

Claude Code e outros clientes

claude mcp add --transport http z-mcp "https://api.z-mcp.com/mcp"
claude
# No Claude Code, abra /mcp e escolha Autenticar.

No Cursor e em clientes com OAuth, use o mesmo endereço e faça login quando solicitado.

Avançado: chave manual por número

Para um app sem OAuth ou para dar acesso a apenas um número, abra Avançado em Conectar IA. Chaves existentes continuam funcionando. O link contém uma senha; guarde em lugar seguro.

https://sua-instancia.zmcp.me/api/mcp?key=zmcp_sua-api-key

No ChatGPT, somente este modo usa Sem autenticação. Em clientes com headers, prefira X-API-Key:

{
  "mcpServers": {
    "zmcp": {
      "url": "https://sua-instancia.zmcp.me/api/mcp",
      "headers": {
        "X-API-Key": "zmcp_sua-api-key"
      }
    }
  }
}

curl -s -X POST "https://sua-instancia.zmcp.me/api/mcp" \
  -H "X-API-Key: zmcp_sua-api-key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Dica

Combine ferramentas para automações poderosas. Por exemplo: “Busque todas as mensagens sobre fatura do último mês e resuma em um relatório.”

Vantagens do z-mcp Cloud

• Sem instalação - Tudo funciona como conector remoto
• Sempre atualizado - Novas features automaticamente
• Multi-dispositivo - Use em qualquer computador
• Seguro - Conexão criptografada, API key única por instância