Conectar um assistente de IA

A GoBots Open API tem um servidor MCP (Model Context Protocol). Com ele, um assistente de IA consulta suas métricas e o seu GoBots Ads em linguagem natural e, com a sua confirmação, aplica mudanças em campanhas.

Item	Valor
Endereço do servidor	https://open-api.live.gobots.com.br/mcp
Transporte	Streamable HTTP (somente POST, respostas JSON)
Revisão do MCP	2026-07-28
Login	OAuth: você cola uma chave de API na tela de autorização da GoBots

Antes de começar, crie uma chave de API no painel (veja Primeiros passos).

Claude

1. No Claude, abra Configurações e depois Conectores.
2. Escolha Adicionar conector personalizado.
3. Dê um nome (por exemplo, GoBots) e cole o endereço https://open-api.live.gobots.com.br/mcp.
4. Clique em Conectar. A tela de autorização da GoBots abre em uma nova janela.
5. Confira o nome do assistente e o site de retorno, cole sua chave de API em Cole sua chave de API e clique em Autorizar.

Pronto: o Claude passa a listar as ferramentas MCP da GoBots. Peça, por exemplo, “quais foram minhas métricas de atendimento na última semana?”.

Claude Code

claude mcp add --transport http gobots https://open-api.live.gobots.com.br/mcp

Depois, rode /mcp dentro do Claude Code e escolha gobots para fazer o login.

Outros clientes MCP

Qualquer cliente que fale a revisão 2026-07-28 do MCP pode se conectar de um destes dois jeitos:

• OAuth (recomendado). Informe só o endereço do servidor. O cliente descobre o servidor de autorização sozinho e abre a tela de autorização da GoBots. O cliente precisa se identificar por um Client ID Metadata Document (um client_id que é uma URL HTTPS); o servidor não aceita registro dinâmico de clientes.

• Chave de API no cabeçalho. Se o cliente aceita cabeçalhos fixos, envie a chave direto, sem OAuth:

  {
    "mcpServers": {
      "gobots": {
        "url": "https://open-api.live.gobots.com.br/mcp",
        "headers": { "Authorization": "Bearer gb_live_..." }
      }
    }
  }

  O formato exato do arquivo muda de um cliente para outro; veja a documentação do seu cliente. Nesse modo a chave fica gravada na configuração do cliente, então trate esse arquivo como um segredo.

Quanto tempo dura a conexão

• O acesso dura 1 hora e o cliente o renova sozinho por até 30 dias. Depois disso, conecte de novo.
• Uma conexão OAuth nunca dura mais que a chave usada para autorizá-la.
• Revogar a chave no painel desconecta na hora todos os assistentes autorizados com ela.

Mudanças pedem confirmação

As ferramentas de escrita que mudam algo no marketplace (update_ad_campaign, set_ad_group_status, apply_opportunity e apply_opportunities) mostram a mudança exata e só executam depois que você confirma no próprio assistente. Se o cliente não sabe pedir essa confirmação, a ferramenta responde com o erro confirmation_required e nada muda. Nesse caso, faça a mudança pelo painel GoBots ou pela API REST.

dismiss_opportunity não muda nada no marketplace e por isso não pede confirmação.

Limites

Cada chamada de ferramenta conta como uma requisição no mesmo limite da API REST, e uma escrita confirmada conta duas. Veja Erros e limites.