Pular para o conteúdo
ZaiaZaiaZaia

Controle a Zaia pelo Claude, ChatGPT ou outra IA

Com o MCP da Zaia, você controla seu workspace conversando com a IA que já usa. Em vez de abrir o Console para cada ajuste, você escreve o que quer e o assistente faz.

Cada conexão controla um workspace: o da chave de API que você usar.

O que você pode pedir

Seção intitulada “O que você pode pedir”
  • Criar e ajustar agentes, squads e tools.
  • Cadastrar bases de conhecimento e tabelas.
  • Configurar canais e tags.
  • Consultar analytics e conversas.
  • Publicar o que ficou pronto.

Agentes, squads e tools ficam em rascunho até você pedir a publicação, e o assistente só publica com a sua confirmação. Canais, tags, conhecimento e tabelas valem na hora. Para a lista completa, veja Operar o workspace via MCP da Zaia.

Como conectar

Seção intitulada “Como conectar”

1. Gere uma chave de API

Seção intitulada “1. Gere uma chave de API”
  1. No Console, vá em Configurações → Integrações → Chaves de API (recurso em beta).
  2. Clique em Nova Chave de API, dê um nome (por exemplo, “Claude”) e copie a chave.

Trate a chave como uma senha: ela dá acesso ao workspace. Não cole em chats nem em repositórios.

2. Cole a configuração no seu assistente

Seção intitulada “2. Cole a configuração no seu assistente”

Todos os assistentes pedem as mesmas informações:

Campo Valor
URL https://api.endless.zaia.app/api/v1/mcp
Autenticação Header Authorization com o valor Bearer <sua-chave>

Exemplo no Cursor (arquivo mcp.json):

{
  "mcpServers": {
    "zaia": {
      "url": "https://api.endless.zaia.app/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer <sua-chave>"
      }
    }
  }
}

No Claude Code, rode no terminal:

claude mcp add --transport http zaia https://api.endless.zaia.app/api/v1/mcp --header "Authorization: Bearer <sua-chave>"

No Claude Desktop, que só usa servidores locais, use o conector mcp-remote (precisa do Node.js) em claude_desktop_config.json:

{
  "mcpServers": {
    "zaia": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.endless.zaia.app/api/v1/mcp", "--header", "Authorization:${ZAIA_AUTH}"],
      "env": { "ZAIA_AUTH": "Bearer <sua-chave>" }
    }
  }
}

Serve também para ChatGPT, Gemini ou qualquer outro assistente que aceite MCP remoto (HTTP streamable) com um header personalizado. Se o seu só aceita login por OAuth, use um dos exemplos acima. Depois de salvar, reinicie o assistente.

3. Teste

Seção intitulada “3. Teste”

Peça: “Chame a tool explain_zaia e me explique o que existe no meu workspace.”

Se ele responder com o resumo do seu workspace, está conectado. Faça isso antes de pedir qualquer alteração.

Cuidados

Seção intitulada “Cuidados”
  • Peça sempre uma lista do que será alterado antes de autorizar.
  • Teste no chat de teste antes de publicar.
  • Se a chave vazar, gere outra e troque no assistente.
  • Erro de autorização? Confira se a chave foi copiada inteira e se o valor começa com Bearer .

Próximos passos

Seção intitulada “Próximos passos”