MCP Servers
Conecte os servidores MCP da sua organização (logs, métricas, runbooks, cluster) para a IA usar como contexto na análise de alertas e chamados
Em MCP Servers, sua organização conecta os próprios servidores MCP (Model Context Protocol) — por exemplo, de logs, métricas, runbooks ou o cluster Kubernetes — para que a IA do OpsScript os utilize como contexto ao analisar alertas e chamados.
Não confunda com o MCP Server do OpsScript: aquele é o servidor que a própria plataforma expõe, para que clientes de IA externos (Claude Desktop, Cursor, etc.) operem o OpsScript. Esta página é o caminho inverso: os MCP Servers da sua infraestrutura entram como ferramentas que a IA do OpsScript consulta durante uma análise.
Onde fica
Acesse Integrações no menu lateral e abra o card MCP Servers. A tela lista os servidores cadastrados e permite adicionar, editar, habilitar/desabilitar, testar e remover cada um.
O recurso faz parte do plano Pro (e superior). Sem a feature de integrações, o card aparece bloqueado no catálogo com a opção de fazer upgrade.
Cadastrando um MCP Server
Abra o formulário
Em Integrações → MCP Servers, clique em Adicionar MCP Server.
Preencha os dados de conexão
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome | Sim | Identificação do servidor (ex.: Grafana MCP (produção)). |
| URL | Sim | Endpoint MCP do servidor (ex.: https://mcp.exemplo.com/mcp). |
| Descrição | Não | O que este servidor oferece à IA — ajuda a entender o propósito de cada ferramenta cadastrada. |
| Header de autenticação | Não | Nome do header enviado na requisição (ex.: Authorization). |
| Token | Não | Credencial enviada no header acima. Fica armazenado cifrado e a API nunca o devolve. Em Authorization sem prefixo, o Bearer é adicionado automaticamente. |
Ao editar um servidor, deixe o campo Token em branco para manter o token atual — só é necessário preenchê-lo para trocar a credencial.
Habilite para a IA
Marque Disponível para a IA nas análises de alertas para que o servidor entre como ferramenta assim que for salvo. Desabilitado, o servidor continua cadastrado mas não é oferecido à IA.
Testando a conexão
Cada servidor cadastrado tem um botão Testar, que valida a conexão pelo backend do OpsScript — não pelo seu navegador. O teste inicializa a sessão MCP com o servidor e lista as ferramentas (tools) que ele expõe, exibindo os primeiros resultados junto com suas descrições. Se a conexão falhar, o erro retornado pelo servidor é exibido no card.
Use o Testar sempre que cadastrar um servidor novo ou trocar a URL/token — é a forma mais rápida de confirmar que a IA vai conseguir consultá-lo antes de depender dele numa análise real.
Onde os MCP Servers são usados
Os MCP Servers habilitados alimentam duas análises por IA da plataforma:
- Análise por IA do episódio de alerta (tela Alertas): todos os MCP Servers habilitados da organização entram automaticamente como ferramentas disponíveis para a IA consultar (logs, métricas, contexto de cluster) ao gerar o resumo, a causa provável e as ações recomendadas.
- Análise sob demanda no chat do chamado: ao pedir uma análise por IA na conversa de um chamado, você escolhe manualmente quais MCP Servers entram naquela análise específica, através de um seletor no composer de mensagens.
A lista de MCP Servers oferecida no seletor do chat respeita a organização do chamado aberto — abrir um chamado de outra organização não reaproveita os servidores da anterior.
Segurança
- Cadastre um token de leitura com o menor escopo possível no sistema de origem (ex.: uma API key somente leitura no Grafana, restrita ao que a IA precisa consultar).
- A IA é orientada a não expor segredos capturados via MCP nas respostas da análise.
- O token nunca é retornado pela API após salvo — se precisar trocá-lo, gere um novo no sistema de origem e cole-o na edição do servidor.
Como em qualquer integração externa, evite reutilizar um token com privilégios de escrita ou de escopo amplo. Prefira credenciais dedicadas, somente leitura, por MCP Server.