Servidores MCP
O MCP (Model Context Protocol) é um padrão para expor ferramentas a uma IA. Em vez de você cadastrar cada endpoint à mão, registra o servidor MCP e o agente descobre sozinho as ferramentas que ele oferece. No LLM, elas aparecem como mcp_<slug>_*.
Onde fica
Menu Loja › Servidores MCP, rota /config/integracoes/mcp. Criar e editar exige a permissão integracoes:edit.
A lista
No topo, uma frase resume a tela: quantos servidores existem, quantos estão ligados, quantas ferramentas os ligados oferecem aos agentes e quantas chamadas houve nos últimos 7 dias, com quantas terminaram em erro.
Abaixo, uma linha por servidor: o nome, a descrição, quantas ferramentas ele oferece e em qual endereço, e o uso da semana. O servidor desligado diz Desligado. A linha ganha uma régua de atenção quando a última sincronização falhou (e diz A sincronização falhou) ou quando as chamadas erram em mais de 5%.
Clique num servidor para abrir o painel ao lado. O botão Novo servidor MCP abre o formulário nesse mesmo painel.
Registrar um servidor
Identificação. Um Nome (slug) no formato
[a-z][a-z0-9_]*e uma Descrição opcional (quando o agente deve recorrer a este servidor).Conexão. A URL do servidor MCP (Streamable HTTP, ex.
https://.../mcp) e os Headers de autenticação (ex.Authorization: Bearer ...).Habilite e salve. Marque Ligado e clique em Cadastrar servidor. O conecta/ai conecta e descobre as ferramentas automaticamente.
O painel do servidor
- O que ele oferece: nome e descrição de cada ferramenta descoberta na última sincronização.
- Sincronizar busca as ferramentas de novo e avisa quantas encontrou. Se a sincronização falhar, o painel mostra a resposta do servidor com a régua de atenção, e o agente segue com a lista de antes.
- Testar com valores de exemplo: escolha a ferramenta, preencha o que ela pede e clique em Testar agora.
- Últimas chamadas: as 20 mais recentes, com qual ferramenta foi chamada, Deu certo ou Falhou, o tempo e o canal.
- Editar, Ligar ou Desligar e Excluir (que pede confirmação). Mudou o endereço? Sincronize depois de salvar.
Quando o servidor MCP ganha ou muda ferramentas, use Sincronizar para descobrir de novo: assim o agente passa a enxergar as novidades. Cada servidor é escopado por organização. Sem a permissão integracoes:edit, a tela mostra a lista, as ferramentas e as últimas chamadas, sem as ações e sem os cabeçalhos.
MCP ou HTTP?
- Um endpoint solto dos seus sistemas → Ferramentas HTTP.
- Um servidor que já fala MCP e expõe várias tools → registre aqui e deixe a auto-descoberta trabalhar.