Visão geral
Registrar servidores de ferramentas na organização e instalá-los nos workspaces.
MCP é um protocolo aberto para expor ferramentas a modelos de IA. Um servidor MCP publica um conjunto de ferramentas, e o Agente decide quando chamá-las.
Ligar um MCP acontece em dois passos, em telas diferentes: a organização registra o servidor no catálogo, e cada workspace instala o que vai usar. Esta página cobre os dois.
O registro da organização
Organização › MCPs é o catálogo dos servidores aprovados pela empresa. Nenhum workspace instala um MCP que não tenha passado por aqui.
A tela abre para Superadmin e Admin, mas cadastrar servidores novos é privilégio do Superadmin. Ela tem três abas:
- Instalados: os servidores já registrados na organização.
- Docker Hub: catálogo público de MCPs distribuídos como imagem.
- GitHub: catálogo público de MCPs distribuídos como repositório.
Os dois catálogos públicos servem para descobrir e registrar sem sair da plataforma. O passo a passo está em Registrar um servidor.
Liberar para um workspace
Registrar não entrega o servidor a ninguém. A liberação é feita em Organização › Workspaces, na seção de MCPs de cada workspace.
É o passo que costuma ser esquecido: um servidor no registro e nenhum workspace conseguindo instalá-lo quase sempre significa que essa associação não foi feita.
Instalar no workspace
Workspace › MCPs é onde o servidor é efetivamente ligado. Instalar e configurar exige papel de Proprietário, Curador ou Editor.
A tela tem duas abas:
- Instalados: os servidores já ligados neste workspace, com a configuração de cada um.
- Disponíveis: o que a organização liberou e ainda não foi instalado aqui.
Ao instalar, você dá ao servidor um nome e a configuração que este workspace precisa. O mesmo servidor do registro pode ser instalado várias vezes no mesmo workspace, desde que cada instalação tenha nome diferente. É assim que se aponta para dois ambientes do mesmo sistema.
A configuração e o funcionamento pertencem à instalação, não ao registro. Alterar uma instalação não afeta as outras nem o item registrado na organização.
Entregar a um agente
Instalar no workspace ainda não basta. Cada Agente precisa marcar o MCP na seção MCPs do próprio formulário.
Lá também fica o máximo de iterações, que limita quantas vezes aquele Agente pode acionar ferramentas em uma única resposta. É o que evita um laço quando uma ferramenta devolve algo inesperado.
Remover
Remover uma instalação interrompe o uso naquele workspace. Agentes que a tinham marcada param de acionar aquelas ferramentas e passam a responder sem elas, sem erro visível para quem conversa.
Remover o servidor do registro da organização não desfaz o que os workspaces já instalaram, porque a configuração pertence à instalação. Para interromper o uso de vez, é preciso remover nos dois lugares.
Quando uma ferramenta não é acionada
- O MCP não está marcado no Agente: instalação no workspace não é entrega ao Agente.
- O limite de iterações foi atingido: o Agente concluiu a resposta antes de completar as chamadas.
- O servidor está fora do ar: a falha aparece nos traces, em Observabilidade.