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 Configuração › Integrações › Servidores MCP — rota /config/integracoes/mcp. Criar e editar exige a permissão integracoes:edit.
A lista
KPIs no topo (total, ativos, execuções e erros nos últimos 7 dias). Cada servidor mostra o nome, o host, a descrição, um toggle ativar/desativar e métricas — quantas tools foram descobertas, execuções, % de erro e “sync há X”. Se a última descoberta falhou, o erro aparece no card.
Ações: Refresh (re-descobre as tools; um toast informa “N tools descobertas”), Editar e Excluir. O botão Novo MCP server abre o formulário.
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 Habilitado e clique em Criar. O conecta/ai conecta e descobre as ferramentas automaticamente.
Depois de registrar
Na tela de edição você vê o bloco “Tools descobertas” — nome e descrição de cada uma, com a data do último sync e eventual erro. Há também um testador (roda uma tool descoberta) e um histórico de execuções.
Quando o servidor MCP ganha ou muda ferramentas, use Refresh para re-descobrir — assim o agente passa a enxergar as novidades. Cada servidor é escopado por organização.
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.