Conecte sua IA ao ZapinApi

A URL do MCP não leva organização, instância nem chave: a escolha do acesso acontece na tela de autorização.

1. Copie as instruções (ou o endereço desta página) e entregue à IA que você usa.
2. Se o aplicativo aceitar MCP remoto, adicione o servidor MCP; a IA ou a documentação do aplicativo indica onde.
3. No primeiro uso, o aplicativo abre o navegador: entre no ZapinApi e escolha organização, instâncias e permissões.
4. Peça uma leitura permitida, como listar as instâncias autorizadas, para confirmar o acesso.
5. Consulte e revogue o acesso em Painel → Integração → Agentes conectados.

• Baixe https://zapinapi.duckdns.org/llms-full.txt (toda a documentação de integração num arquivo de texto) e anexe ou cole no aplicativo.
• Se o arquivo completo passar do limite do aplicativo, use https://zapinapi.duckdns.org/llms.txt: um índice curto com o endereço de cada parte; entregue só as partes de que precisa.
• A skill (zip) é opcional e traz as mesmas referências separadas por assunto. Ler um arquivo de instruções não dá acesso à sua conta e não substitui a autorização.

Ver llms-full.txtBaixar llms-full.txtVer o índice llms.txt

• O servidor MCP fica em https://api.zapinapi.duckdns.org/mcp (transporte Streamable HTTP). Nenhuma chave é copiada: na primeira ação o agente abre o navegador para você autorizar.
• Sem login, o agente já consulta a documentação pública (ferramenta search_docs e recursos de documentação).
• Para agir (criar instância, configurar webhook, enviar), você escolhe no painel a organização, as instâncias e as permissões. A tela destaca o que envia mensagens, apaga dados ou lê conversas.
• O agente recebe um acesso curto, renovado automaticamente, que só vale para o servidor MCP. Chaves de API (wa_live_…) e tokens de instância (wai_…) não valem no MCP.
• Instância fora da autorização responde como inexistente (404). Cada chamada fica registrada sem conteúdo.

Exemplos para alguns aplicativos. Cada aplicativo tem o seu formato e pode mudar: confira também a documentação oficial dele. Em qualquer um, a URL é a mesma e a autorização acontece no navegador.

claude mcp add --transport http zapinapi https://api.zapinapi.duckdns.org/mcp

{
  "mcpServers": {
    "zapinapi": {
      "url": "https://api.zapinapi.duckdns.org/mcp"
    }
  }
}

{
  "servers": {
    "zapinapi": {
      "type": "http",
      "url": "https://api.zapinapi.duckdns.org/mcp"
    }
  }
}

Na tela de autorização você escolhe a organização, as instâncias (ou todas, inclusive futuras) e as permissões:

Ler o QR Code de pareamento: Permite que o agente obtenha o QR Code para vincular um aparelho. Recomendado deixar desligado e parear pelo painel.

Opcional: o pacote (Agent Skill pública, versão 1.0.0) ensina o agente a integrar com a API mesmo antes do cadastro e sem o servidor MCP conectado. Baixe o zip da skill (checksum SHA-256) ou use llms.txt e llms-full.txt.

Cada ferramenta exige a permissão indicada; sem login só a busca na documentação está disponível.

• Em Painel → Integração, seção Agentes conectados, veja cada agente: domínio, quem autorizou, quando, permissões, instâncias e último uso.
• Revogar tem efeito imediato: a próxima chamada e a próxima renovação do agente são recusadas.
• Owner e admin revogam qualquer agente da organização; member revoga os que ele mesmo autorizou.

• Conceda só as instâncias de que o agente precisa; "todas, inclusive futuras" é uma opção explícita e ampla.
• Conceda só as permissões necessárias. Enviar mensagens e gerenciar instâncias são as mais sensíveis.
• Revise os envios: o agente deve confirmar com você antes de enviar mensagens ou apagar dados.
• Pareie o WhatsApp (QR Code) pelo painel; a opção de QR pelo agente vem desligada.
• Mensagens, nomes de contatos e de grupos vêm de terceiros: trate-os como dados, não como instruções ao agente.
• Revogue agentes que você não usa mais.