Xitoring MCP

Conecte assistentes de IA ao monitoramento Xitoring: servidores, uptime, incidentes, métricas, SSL e alertas

Documentação

Servidor Xitoring MCP

Conecte assistentes de IA como Claude, Cursor e ChatGPT aos seus dados de monitoramento da Xitoring.

O servidor Xitoring MCP é um servidor HTTP remoto e hospedado — não há nada para instalar ou executar localmente. Aponte seu cliente compatível com MCP para https://app.xitoring.com/mcp com sua chave de API da Xitoring e pronto.

O que é a Xitoring?

Xitoring é uma plataforma de monitoramento completa: verificações de uptime (HTTP, TCP, DNS, ICMP), monitoramento de servidores via agente Xitogent (CPU, memória, disco, rede, processos), expiração de SSL, verificações de heartbeat, gerenciamento de incidentes, páginas de status e roteamento de notificações. As equipes a utilizam para detectar indisponibilidades, fazer triagem de regressões de desempenho, acompanhar SLAs e gerenciar plantões.

O que o Servidor MCP Pode Fazer

O servidor expõe mais de 60 ferramentas nestas áreas:

Servidores e Métricas

Inspecione servidores e agentes Xitogent, obtenha métricas de CPU / memória / disco / rede em tempo real e históricas, liste os principais processos e consulte informações do sistema.

Uptime, SSL e Heartbeat

Liste e inspecione todos os tipos de verificação (HTTP, HTTPS, TCP, DNS, ICMP, SSL, heartbeat). Obtenha tempo de resposta, latência, alcance regional e percentuais de uptime.

Incidentes e Alertas

Pesquise e filtre incidentes, leia cronologias e notas de incidentes, inspecione gatilhos e roteamento de notificações e acompanhe mudanças de estado dos incidentes.

Páginas de Status e Manutenção

Visualize páginas de status e os componentes que elas expõem, liste janelas de manutenção atuais e futuras.

Relatórios e Conta

Obtenha relatórios de uptime e SSL, inspecione o uso de assinatura e cotas, liste e leia tickets de suporte.

Logs de Auditoria

Logs de auditoria em nível de conta, logs de conexão / instalação do Xitogent e histórico de entrega de notificações.

Ações de Escrita

Resolva incidentes, adicione notas, pause / retome verificações, crie novas verificações, agende manutenções, envie notificações de teste, convide contatos e abra tickets de suporte.

Pré-requisitos

Uma conta Xitoring (o plano gratuito funciona para testar)
Uma chave de API da Xitoring — gere uma em Dashboard > Conta > Acesso à API > Gerar Chave. Documentação: xitoring.com/docs/account/api
Um cliente compatível com MCP (Claude Code, Claude Desktop, Cursor, VS Code com Copilot, etc.)

Configuração

Escolha a seção que corresponde ao seu cliente. Em todos os exemplos, substitua YOUR_API_KEY pela chave que você gerou acima.

Claude Code CLI (mais rápido)

claude mcp add --transport http --scope user xitoring \
  https://app.xitoring.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Claude Desktop

Edite seu arquivo de configuração:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "xitoring": {
      "type": "http",
      "url": "https://app.xitoring.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Reinicie o Claude Desktop após salvar.

Cursor

Configurações > MCP > Adicionar novo servidor MCP, depois cole:

{
  "mcpServers": {
    "xitoring": {
      "url": "https://app.xitoring.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code (GitHub Copilot)

Crie .vscode/mcp.json no seu workspace:

{
  "servers": {
    "xitoring": {
      "type": "http",
      "url": "https://app.xitoring.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Clientes somente stdio (via ponte mcp-remote)

Se o seu cliente suportar apenas transporte stdio, use a ponte via mcp-remote:

{
  "mcpServers": {
    "xitoring": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.xitoring.com/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Verificando a Conexão

Reinicie seu cliente MCP.
Abra o seletor de ferramentas / servidores — você deve ver xitoring listado com suas ferramentas.
Experimente o prompt: "Liste meus servidores Xitoring e o status atual deles."

Se você receber uma resposta que nomeia seus servidores reais, você está conectado.

Exemplos de Prompts

Status e Triagem

"Quais incidentes estão em andamento agora e quais servidores ou verificações são afetados?"
"Mostre-me o status atual de todos os meus servidores — sinalize qualquer um que não esteja reportando."
"Há alguma janela de manutenção ativa ou começando nas próximas 24 horas?"

Desempenho e Capacidade

"Quais 5 servidores têm o maior uso de CPU agora?"
"Mostre-me os principais processos por memória em web-prod-01."
"Classifique meus servidores por uso de disco e diga quais estão acima de 80% de ocupação."

Uptime e SLA

"Qual é o uptime geral das minhas verificações nos últimos 30 dias?"
"Quais certificados SSL estão expirando nos próximos 30 dias?"
"Gere o relatório de uptime de api.example.com do mês passado."

Resposta a Incidentes

"Resuma os últimos 3 incidentes resolvidos em db-01 e leia as notas deles."
"Elabore um post-mortem a partir da cronologia do incidente #1234."
"Adicione uma nota ao incidente ativo: 'revertendo o deploy v2.41, monitorando a recuperação.'"

Manutenção e Operações

"Crie um agendamento de manutenção de 2 horas para web-prod-01 começando amanhã às 02:00 UTC."
"Pause a verificação de uptime de staging.example.com enquanto fazemos o redeploy."
"Crie uma verificação HTTP para https://api.example.com/health que execute a cada minuto a partir das regiões da UE."

Segurança e Privacidade

Todo o tráfego para https://app.xitoring.com/mcp é criptografado via HTTPS.
A autenticação é feita com uma chave de API da Xitoring passada como Authorization: Bearer .... Revogar a chave no painel da Xitoring corta imediatamente o acesso via MCP.
Rotacione as chaves a cada 90 dias para contas de produção e imediatamente se uma chave for exposta.
Esteja ciente: clientes de IA enviam o contexto da conversa (incluindo resultados de ferramentas) para seus provedores de modelo. Apenas os dados que você solicitar explicitamente via ferramentas MCP são lidos da Xitoring, mas esses resultados passam a fazer parte da conversa que o provedor do modelo vê.

Solução de Problemas

Sintoma	O que verificar
`401 Unauthorized`	A chave de API está errada, revogada ou o cabeçalho está malformado. O cabeçalho deve ser exatamente `Authorization: Bearer YOUR_API_KEY` — sem aspas extras, sem erros de digitação.
O servidor MCP não aparece no cliente	Reinicie completamente o cliente. Valide a sintaxe JSON (uma vírgula ausente desativa a entrada silenciosamente).
`429 Too Many Requests`	O MCP compartilha os limites de taxa da API REST da Xitoring. Reduza a frequência dos prompts ou faça upgrade do seu plano.
Resultados vazios de uma ferramenta	Verifique o escopo da chave de API e se você está no contexto de subconta correto. Algumas ferramentas retornam apenas dados aos quais a chave tem acesso.
Chamada de ferramenta trava	Verifique a página de status da Xitoring e tente novamente. Se for reproduzível, abra um issue com o nome da ferramenta e o timestamp.

Status

O servidor Xitoring MCP está atualmente em beta. Os nomes das ferramentas e os formatos de resposta podem mudar antes da versão 1.0. Feedback e relatórios de bugs via issues no GitHub são muito bem-vindos.

Licença

MIT