Introdução

O que é o MCP Z-API?

O MCP Z-API é um servidor que expõe operações do WhatsApp como ferramentas prontas para qualquer IA compatível com MCP — Claude, ChatGPT, agentes customizados, entre outros. Em vez de chamar a API REST diretamente, a IA conversa com o servidor MCP e ele executa as ações na sua instância Z-API.

Novo no MCP? MCP (Model Context Protocol) é um padrão aberto que define como IAs se conectam a sistemas externos. Funciona como um “menu de habilidades”: a IA pergunta o que o servidor sabe fazer, escolhe a ação e envia os dados necessários.

O que dá pra fazer

Hoje o MCP Z-API expõe 9 ferramentas, divididas em dois grupos:

Mensagens

Ferramenta	O que faz
Send-text	Envia uma mensagem de texto para um número ou grupo
Send-image	Envia uma imagem (link ou Base64), com legenda opcional
Send-video	Envia um vídeo (link ou Base64), com legenda opcional

Grupos

Ferramenta	O que faz
Group-create	Cria um novo grupo com os participantes informados
Group-add-participant	Adiciona novos membros a um grupo existente
Group-remove-participant	Remove membros de um grupo
Group-add-admin	Promove um ou mais participantes a administradores do grupo
Group-remove-admin	Remove a administração de um ou mais membros do grupo
Group-metadata	Retorna as informações do grupo (nome, participantes, admins, etc.)

Novas ferramentas são adicionadas conforme o servidor evolui.

Ações sobre grupos e participantes têm efeito imediato no WhatsApp. Como qualquer ação executada por uma IA, revise o que o agente vai fazer antes de autorizar, principalmente em fluxos automatizados.

Como funciona na prática

Usuário faz um pedido à IA
        │
        ▼
IA consulta o MCP Z-API → recebe a lista de ferramentas disponíveis
        │
        ▼
IA escolhe a ferramenta e envia os parâmetros (ex.: número + mensagem)
        │
        ▼
MCP valida o token OAuth e aciona a Z-API
        │
        ▼
Ação executada no WhatsApp → IA confirma ao usuário ✅

Perguntas frequentes

Preciso de uma conta Z-API?

Sim. O MCP é uma camada sobre a Z-API, não um substituto. A instância de WhatsApp precisa estar conectada normalmente na plataforma.

A mensagem sai do número de quem?

Do número conectado à instância Z-API do cliente — igual a qualquer envio pela API tradicional.

Dá pra criar e gerenciar grupos pelo MCP?

Sim. Hoje já é possível criar grupos, adicionar e remover participantes, e promover ou remover administradores diretamente pelas ferramentas do MCP.

Token de segurança da conta Como conectar

Início

Segurança

MCP Server

Dicas

Parceiros

O que é o MCP Z-API?

O que dá pra fazer

Mensagens

Grupos

Como funciona na prática

Perguntas frequentes

​O que é o MCP Z-API?

​O que dá pra fazer

​Mensagens

​Grupos

​Como funciona na prática

​Perguntas frequentes

O que é o MCP Z-API?

O que dá pra fazer

Mensagens

Grupos

Como funciona na prática

Perguntas frequentes