O que são MCP Servers
MCP (Model Context Protocol) Servers são servidores externos que expõem ferramentas (tools) que seus agentes podem usar. Em vez de configurar cada tool individualmente dentro de cada agente, você registra o servidor MCP uma vez na plataforma, e todas as tools que ele disponibiliza ficam disponíveis para qualquer agente do seu workspace.
Pense no MCP Server como um "catálogo de ferramentas" — você conecta o catálogo, e depois escolhe quais ferramentas de cada catálogo cada agente pode usar.
Como funciona na prática
-
Você registra um MCP Server na página de Settings do OAP
-
Ao criar ou editar um agente, as tools daquele servidor aparecem agrupadas por servidor
-
Você liga/desliga cada tool individualmente com um toggle — ou seleciona todas de uma vez
-
O agente passa a poder usar aquelas tools durante o atendimento
Como adicionar um MCP Server
Acesse Settings no menu lateral do OAP. Na seção MCP Servers, clique em Add Server.
Preencha os campos:
| Campo | O que é | Exemplo |
|---|---|---|
| Name | Nome amigável para identificar o servidor | "API de Pedidos" |
| URL | Endereço do servidor MCP (sem /mcp no final) |
https://mcp.exemplo.com/v1 |
| Auth Type | Tipo de autenticação que o servidor exige | None, Bearer Token ou API Key |
| Credentials | Token ou chave (só aparece se Auth Type não for "None") | sk-abc123... |
Após salvar, a plataforma se conecta ao servidor e lista todas as tools disponíveis automaticamente.
Importante: a URL não deve terminar em /mcp — a plataforma adiciona esse sufixo automaticamente ao fazer requisições.
Tipos de autenticação
-
None — o servidor não exige credenciais. Basta informar a URL.
-
Bearer Token — a plataforma envia o token no header
Authorization: Bearer <token>a cada requisição. -
API Key — a plataforma envia a chave como header de autenticação.
As credenciais são armazenadas de forma criptografada. Ao editar um servidor, o campo de credenciais aparece vazio — você precisa re-inserir o token apenas se quiser alterá-lo.
Como vincular tools de um MCP Server a um agente
Ao criar ou editar um agente, a seção de MCP Tools mostra todos os servidores registrados em grupos colapsáveis. Cada grupo lista as tools do servidor com um toggle de liga/desliga.
Você pode:
-
Ligar tools individuais clicando no toggle de cada uma
-
Usar o toggle "Select all" para ligar todas as tools de um servidor de uma vez
-
Buscar tools pelo nome usando o campo de busca
O agente só terá acesso às tools que estiverem ligadas. Se uma tool for desligada, o agente não poderá acioná-la — mesmo que o servidor continue disponível.
O servidor Default
O workspace já vem com um MCP Server padrão (marcado como "Default"). Este servidor não pode ser excluído nem editado — ele é gerenciado pela plataforma.
Servidores adicionais que você cadastrar podem ser editados e excluídos normalmente.
Quando o servidor fica inacessível
Se a plataforma não conseguir se conectar a um servidor MCP, a lista de tools daquele servidor mostrará a mensagem "Server unreachable — tools cannot be loaded".
Verifique:
-
A URL está correta e acessível pela internet
-
As credenciais estão válidas (tokens podem expirar)
-
O servidor suporta requisições Streamable HTTP (o protocolo que a plataforma utiliza)
Boas práticas
-
Nomeie os servidores de forma descritiva — "API de Pedidos", "CRM Interno", "Gateway de Pagamentos" — facilita a identificação ao configurar agentes
-
Ative apenas as tools que o agente precisa — um agente com muitas tools pode ficar confuso sobre qual usar. Limite ao necessário
-
Oriente o uso no system prompt — no system prompt do sub-agente, mencione quando e por que usar cada tool. A tool existe no servidor, mas o agente precisa saber quando acioná-la
-
Teste antes de publicar — após conectar um servidor e vincular tools a um agente, teste no Playground para garantir que as tools estão respondendo corretamente