API ou MCP customizado

Quando o sistema que você quer integrar não está entre os conectores prontos, dá para ligar um agente a ele de duas formas: por uma API REST ou por um servidor MCP. Diferente das conexões OAuth, essa configuração é feita por agente, e costuma pedir alguém técnico da sua empresa por perto.

Por agente, não por organização

As conexões do modal de Apps (Google, Microsoft, Slack e outros) valem para a organização inteira. A API ou o MCP customizado funciona diferente: cada agente recebe a sua própria configuração, apontando para o sistema que aquele agente precisa acessar.

Quando usar API REST

• O sistema já expõe uma API HTTP. ERPs, sistemas internos e ferramentas com API documentada entram aqui.
• O agente precisa de chamadas pontuais. Consultar, criar ou atualizar registros em um sistema específico.

Quando usar servidor MCP

• O sistema já oferece um servidor MCP. MCP é um protocolo aberto para expor ferramentas a agentes de IA, e cada vez mais ferramentas o suportam.
• Você quer entregar um conjunto de ferramentas de uma vez. Um servidor MCP agrupa várias capacidades sob um protocolo padrão, em vez de mapear chamada por chamada.

Na dúvida entre os dois, comece pelo que o sistema já oferece: se existe servidor MCP pronto, ele tende a ser o caminho mais curto.

Quem configura

• Quem edita o agente no Studio. A configuração fica no agente, então quem cria ou mantém o agente é quem a aplica. Isso depende da permissão de escrita em agentes, definida na matriz de permissões do workspace.
• Alguém técnico da sua empresa. Endereços, credenciais e o formato das chamadas vêm de quem conhece o sistema integrado, em geral o time de TI ou de engenharia.

Quando escalar

• Sem acesso para editar o agente: administrador do workspace, que ajusta papel e permissões.
• Dúvida sobre o desenho da integração ou sobre qual caminho seguir: fale com a gente descrevendo o sistema e o que o agente precisa fazer.