HeadOfficeOS Documentação
Construir IAgentes
HEADOFFICE OS / DOCUMENTAÇÃO

Integrações, MCP e APIs

Dê ferramentas ao agente e descreva quando cada uma deve ser usada.

Edição de 7 de outubro de 2026 • Português

Escolha a conexão pelo trabalho

Uma integração precisa de três partes alinhadas: acesso técnico, permissão suficiente e instrução de uso. Conectar uma conta sem explicar quando consultar ou atualizar dados costuma produzir comportamento imprevisível.

Servidores MCP

O bloco Servidores MCP apresenta conexões para Google Workspace, Meta Ads, HubSpot e RD Station CRM, além de Adicionar MCP próprio por URL.

ATLAS DEMO · PASSO A PASSO Adicionar MCP próprio: ponto de entrada para conectar um servidor ao Atlas Demo.
Adicionar MCP próprio: ponto de entrada para conectar um servidor ao Atlas Demo.

Use o conector correspondente, conclua a autorização e confira o escopo. No Google Workspace, a descrição menciona Gmail, Drive, Calendar, Chat e People; isso não significa que todos os dados dessas aplicações estarão automaticamente liberados.

A lista observada marca Notion, Linear, Sanity, Hex, PostHog, Sentry, Granola, n8n, Amplitude e Atlassian como Em breve no próximo release. Um item aparecer em outro catálogo como sugestão não comprova que o conector MCP nativo esteja disponível.

APIs e webhooks ao vivo

A área mostra Quando usar, URL, Método, Saúde, Chamadas (7d), Escopo e Ações, com Adicionar Endpoint.

Antes de cadastrar um endpoint, defina:

  • Qual intenção deve acioná-lo.
  • Quais dados são obrigatórios.
  • Se a operação lê ou modifica informações.
  • Como reconhecer sucesso, erro e duplicidade.
  • O que fazer quando há timeout ou autorização expirada.

Exemplo: “Consultar o andamento de um pedido quando o cliente informar o identificador confirmado”. É mais útil que “usar API de pedidos”.

Pedir para IA

A seção Conecte qualquer aplicação exibe sugestões como RD Station, Zapier, Slack, WhatsApp, Google Sheets, Notion e Stripe, com Pedir para IA, em área beta. Trate o resultado como uma configuração a revisar: URL correta, autenticação, método, escopo e teste precisam ser conferidos.

API de conversas e agente como MCP

Veja onde encontrar canais e integrações na aula narrada.

API de conversas gera chave para outro sistema ler conversas do agente. A tela informa que a chave completa aparece uma vez e que o limite padrão é 60 pedidos por minuto. Guarde a chave no gerenciador de segredos do sistema consumidor e siga a documentação de endpoints que o produto fornecer; este guia não presume rotas não verificadas.

Ativar MCP Server expõe capacidades do IAgente a clientes compatíveis, como Cursor e n8n. Esse caminho está marcado como beta. É a direção inversa à conexão de um servidor MCP externo: aqui outro sistema chama seu agente.

Prova de funcionamento

Faça primeiro uma consulta conhecida, depois uma ação reversível autorizada e, por fim, um caso de erro. Registre retorno, evidência e efeito no sistema. Um texto “feito” do agente não substitui o registro criado ou atualizado no destino.

Nesta página