Pular para o conteúdo principal
Use este guia para dar ao agente de um módulo acesso a um servidor MCP externo (Model Context Protocol), como o da sua ferramenta de chamados ou de postura de nuvem. O jeito mais rápido é pedir pelo próprio chat do agente: ele confere o servidor, pede a autenticação e abre a solicitação para um gestor. Ao final, o agente passa a consultar esse servidor nas conversas do módulo, no escopo que o gestor autorizou.

Pré-requisitos

  • A URL do servidor MCP, num endereço que a plataforma alcance (por exemplo, https://servidor.exemplo.com/mcp). Requisitos de rede ou de chave do lado do servidor ficam no guia do módulo que o usa.
  • O jeito que o servidor pede autenticação: login pelo provedor (OAuth), uma chave de API ou nenhuma.
  • Um gestor do painel para decidir a solicitação, ou a URL já na lista de MCPs pré-aprovados.

Passos

1

Pedir a conexão no chat do agente

No Agent Work do módulo, digite /mcp seguido da URL do servidor, como /mcp https://servidor.exemplo.com/mcp, e envie. O agente responde “Analisando o servidor MCP…” e confere como o servidor faz a autenticação.
2

Autenticar

O que vem a seguir depende do servidor:
  • O servidor usa OAuth: o agente avisa que vai preparar a autorização e mostra o link do provedor. Abra o link, entre com a sua conta até ver a tela de sucesso e clique em Já autorizei. Se o servidor não faz o registro automático de cliente, o agente pede antes o Client ID e, se houver, o Client Secret do cliente OAuth que você criou no provedor.
  • Nos outros casos: o agente pergunta “Como o servidor MCP faz a autenticação?”. Escolha Chave de API, Sem autenticação ou OAuth. Na Chave de API, escolha Bearer Token e informe o Token, ou Cabeçalho personalizado e informe o Nome do cabeçalho e o Valor do token.
Cancelar encerra o pedido sem criar nada.
3

Conferir a conexão

O agente responde “Conexão estabelecida com o MCP”, com quantas ferramentas o servidor oferece e uma prévia delas, e abre a solicitação para os gestores do painel. Se a URL estiver nos MCPs pré-aprovados, a conexão já nasce aprovada e fica disponível no módulo na hora.
4

Decidir, se você é gestor

A solicitação aparece na aba Config do módulo, em MCP, como Solicitado. Abra a linha por Detalhes. Na ficha ficam a Decisão do gestor, o Escopo de autorização (Somente este módulo, Módulos selecionados ou Todos os módulos) com o botão Salvar escopo, os Usuários e as Ferramentas do MCP, cada uma com autorizar e bloquear.
Ficha de um MCP com a decisão do gestor, o escopo de autorização, os usuários e as ferramentas com os botões autorizar e bloquear.

O escopo passa a valer quando o MCP está autorizado. Salvar escopo fica abaixo das três opções.

Pedir pela aba Config

Você também pode pedir a conexão sem passar pelo chat. Na aba Config do módulo, abra MCP e clique em + Novo MCP. Preencha o nome, opcional, e a URL, obrigatória, e clique em Solicitar MCP. A solicitação entra como Solicitado, e cada usuário autentica com a própria conta depois que um gestor aprovar.
Formulário Novo MCP externo com os campos de nome e URL e os botões Solicitar MCP e Cancelar.

O formulário abre acima da lista. Cancelar fecha sem solicitar.

Um usuário só usa o MCP quando ele está autorizado, ele tem permissão e já autenticou.

Verificar o resultado

Na aba Config, em MCP, o servidor aparece como Autorizado, com o selo que diz se vale neste módulo ou só em outro. No Agent Work, /mcp-list lista as suas conexões aprovadas no módulo, com quantas ferramentas cada uma tem.
Sub-aba MCP com os filtros por estado, o botão Novo MCP e a lista de MCPs externos, cada um com estado, URL, solicitante, escopo e os botões de decisão.

A lista de MCPs, com os filtros por estado e o botão Novo MCP. O selo ao lado do estado diz se o MCP está autorizado aqui ou só em outro módulo.

Os estados de uma solicitação

MCPs pré-aprovados

Embaixo da lista fica o bloco MCPs pré-aprovados, com o botão + Adicionar. Uma conexão de qualquer membro para uma URL dessa lista nasce aprovada, sem passar por um gestor. A autenticação continua sendo a de cada usuário. Solicitações, decisões e autorizações ficam registradas com trilha de auditoria.

Próximos passos

Última modificação em 17 de novembro de 2026