> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecotrust.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar um MCP

> Como conectar um servidor MCP externo ao agente de um módulo pelo chat, com /mcp e a autenticação do servidor, e como um gestor aprova a conexão, define o escopo e autoriza as ferramentas na aba Config.

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.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/18-mcp-ficha.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=88b7e1928c4567ab9bda5e50cfb05367)

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.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/17-mcp-novo.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=069e88c5bb02a22e82f410cc022908a3)

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.](https://mintcdn.com/eco-trust/CC6vcTjxwIaP-HZA/images/inventory/16-cfg-mcp.png?fit=max\&auto=format\&n=CC6vcTjxwIaP-HZA\&q=85\&s=28a5658af76bb769753ef397faf89cd7)

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**

| Estado | O que significa |
| - | - |
| **Solicitado** | Pedido aberto, à espera de decisão. O cartão traz **Aprovar** e **Rejeitar**. |
| **Autorizado** | Conexão liberada, no escopo escolhido. |
| **Não autorizado** | Pedido recusado. O cartão mantém **Aprovar**, para rever a decisã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

* [Integrar a EcoTrust com as suas ferramentas](https://docs.ecotrust.io/ecotrust-os/integrar-com-as-suas-ferramentas.md): quando usar um MCP e exemplos por tipo de ferramenta.
* [Paleta de comandos](https://docs.ecotrust.io/ecotrust-os/paleta-de-comandos.md)
* [Conectar o Prowler](https://docs.ecotrust.io/modulos/baseline/conectar-o-prowler.md), no Baseline
* [Conectar o seu assistente de IA ao servidor MCP](https://docs.ecotrust.io/mcp/conectar-o-seu-assistente.md): o caminho inverso, para usar a EcoTrust no Claude, no Cursor ou no VS Code.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.