Globalping

Servidor MCP Globalping

Permite que modelos de IA interajam com uma plataforma global de medição de rede por meio de linguagem natural. Dê acesso à rede para qualquer LLM.

O que é o Globalping?

Globalping é uma API pública e gratuita que fornece acesso a uma rede globalmente distribuída de sondas para monitoramento, depuração e avaliação de infraestrutura de internet. Com o Globalping, você pode executar testes de rede (ping, traceroute, DNS, MTR, HTTP) a partir de milhares de locais ao redor do mundo.

O que é o Servidor MCP Globalping?

O Servidor MCP Globalping implementa o Model Context Protocol (MCP), permitindo que modelos de IA e assistentes de IDE interajam com os recursos de medição de rede do Globalping por meio de linguagem natural.

O servidor suporta autenticação OAuth 2.0 padrão, bem como autenticação por token de API para fluxos de trabalho automatizados.

Principais Recursos

• 🌐 Acesso Global à Rede: Execute medições a partir de milhares de sondas ao redor do mundo
• 🤖 Interface Amigável para IA: Qualquer LLM conseguirá analisar facilmente os dados e executar novas medições conforme necessário
• 📊 Medições Abrangentes: Suporte para testes de ping, traceroute, DNS, MTR e HTTP
• 🔍 Tratamento Inteligente de Contexto: Descrições detalhadas de parâmetros e anotações semânticas de ferramentas para roteamento inteligente de agentes
• 🔄 Análise Comparativa: Compare latência de rede e roteamento entre diferentes alvos e localizações geográficas
• 🔑 Suporte a Autenticação: Use OAuth ou um token de API com sua conta Globalping para limites de taxa mais altos

---

Instalação

O endpoint principal para todas as integrações MCP modernas é:

https://mcp.globalping.dev/mcp HTTP Streamable

ChatGPT e Codex

Conecte o Globalping como um servidor MCP remoto no ChatGPT e no Codex:

ChatGPT (Web e Desktop)

1. No ChatGPT, vá para Configurações → Segurança e login e ative o Modo desenvolvedor (ou Configurações → Recursos → Servidores MCP no ChatGPT Desktop).
2. Adicione um novo conector personalizado / servidor MCP com o endpoint:

https://mcp.globalping.dev/mcp

3. Autentique via OAuth quando solicitado.

OpenAI Codex

Adicione o servidor remoto usando o CLI do Codex:

codex mcp add globalping --url https://mcp.globalping.dev/mcp

Ou adicione ao ~/.codex/config.toml diretamente:

[mcp_servers.globalping]
url = "https://mcp.globalping.dev/mcp"

Claude (Web, Desktop)

O Claude suporta conectores MCP HTTP Streamable remotos nativamente, sem exigir bridges locais de mcp-remote:

1. No Claude, navegue até Configurações → Conectores (ou Configurações da organização → Conectores para contas Team/Enterprise).
2. Clique em + Adicionar conector personalizado.
3. Preencha os detalhes do conector:

• Nome: Globalping
• URL: https://mcp.globalping.dev/mcp

Claude Code

Execute o seguinte comando no seu terminal:

claude mcp add --transport http globalping https://mcp.globalping.dev/mcp

Para disponibilizar o Globalping em todos os projetos da sua máquina (escopo global do usuário) em vez de apenas no diretório do projeto atual:

claude mcp add -s user --transport http globalping https://mcp.globalping.dev/mcp

Execute claude mcp login globalping --no-browser se estiver trabalhando via SSH ou em um terminal sem interface gráfica para concluir a troca da URL de autorização manualmente.

Cursor

Adicione o Globalping ao Cursor com um clique:

Ou configure manualmente em Configurações → Recursos → Servidores MCP → Adicionar Novo Servidor MCP:

• Tipo: SSE / HTTP
• Nome: globalping
• URL: https://mcp.globalping.dev/mcp

CLI do Gemini

O Globalping está indexado na Galeria de Extensões do Gemini CLI oficial.

Instale via gerenciador de extensões do Gemini:

gemini extensions install https://github.com/jsdelivr/globalping-mcp-server

(Adicione --auto-update para manter a extensão atualizada automaticamente).

VS Code e GitHub Copilot

• Paleta de Comandos: Execute MCP: Add Server e digite https://mcp.globalping.dev/mcp.

Clientes MCP Genéricos

Para qualquer cliente que suporte o transporte MCP HTTP Streamable padrão, adicione:

{
  "mcpServers": {
    "globalping": {
      "url": "https://mcp.globalping.dev/mcp"
    }
  }
}

Clientes Legados (fallback SSE / stdio): Se o seu cliente exigir estritamente SSE por meio de uma bridge de processo local, configure npx mcp-remote https://mcp.globalping.dev/sse.

---

Autenticação

O Globalping MCP suporta dois modos de autenticação:

• OAuth 2.0: Tratado automaticamente em clientes interativos durante a conexão.
• Token de API: Útil para scripts headless, pipelines de CI/CD ou clientes de API programáticos.

Usando um Token de API Globalping

1. Acesse dash.globalping.io e gere um token de API na seção Tokens.
2. Envie o token por meio de cabeçalhos HTTP padrão:

{
  "mcpServers": {
    "globalping": {
      "url": "https://mcp.globalping.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GLOBALPING_API_TOKEN"
      }
    }
  }
}

---

Integração Programática (API de Mensagens da Anthropic)

Para usar o Globalping diretamente com a API de Mensagens da Anthropic (Conector MCP), envie a definição do servidor remoto no payload da sua solicitação:

{
  "model": "claude-3-7-sonnet-latest",
  "max_tokens": 1024,
  "mcp_servers": [
    {
      "type": "url",
      "name": "globalping",
      "url": "https://mcp.globalping.dev/mcp"
    }
  ],
  "tools": [
    {
      "type": "mcp_toolset",
      "mcp_server_name": "globalping"
    }
  ],
  "messages": [
    {
      "role": "user",
      "content": "Run a traceroute to 1.1.1.1 from Frankfurt and Tokyo."
    }
  ]
}

---

Ferramentas Disponíveis

Ferramenta	Descrição
ping	Executa testes de ping ICMP/pacote para um destino
traceroute	Rastreia os saltos de roteamento de rede até um alvo
dns	Resolve consultas DNS usando resolvedores e tipos de registro específicos
mtr	Executa testes combinados de ping e traceroute (My Traceroute)
http	Executa solicitações HTTP/HTTPS a partir de sondas ao redor do mundo
locations	Lista as regiões e filtros de sondas Globalping disponíveis
limits	Exibe a cota horária gratuita atual de testes e créditos adicionais
getMeasurement	Recupera resultados de uma medição histórica por ID
compareLocations	Guia auxiliar para comparar métricas de desempenho em múltiplas regiões
help	Referência de ferramentas e documentação de sintaxe
authStatus	Verifica o status atual de autenticação do MCP

---

Exemplos de Uso

Após conectar, execute diagnósticos de rede usando linguagem natural:

Ping google.com from 3 locations in Europe

Run a traceroute to github.com from Japan and compare with traceroute from the US

Check the DNS resolution of example.com using Google DNS (8.8.8.8)

Is jsdelivr.com reachable from China? Test with both ping and HTTP

What's the average response time for cloudflare.com across different continents?

---

Especificação de Localização

As localizações podem ser especificadas usando o parâmetro magic da localização:

• Continentes: EU, NA, AS, AF, OC, SA
• Códigos de país: US, DE, JP, PL, BR
• Cidades: London, Tokyo, New York, Warsaw
• Redes e ASNs: Cloudflare, Google, AS13335, AS15169
• Regiões de nuvem: aws-us-east-1, gcp-us-central1
• Combinações: London+UK, Cloudflare+US, AWS+Frankfurt

---

Solução de Problemas e Suporte

O conector não consegue alcançar o servidor

• Use o endpoint HTTP Streamable exatamente como mostrado: https://mcp.globalping.dev/mcp.
• Uma resposta 401 Unauthorized antes de concluir o OAuth é esperada. Reconecte a integração e finalize o fluxo de autorização no navegador.
• Use o endpoint legado /sse apenas para clientes que não suportam HTTP Streamable.

A autenticação falha ou expira

• Remova e reconecte a integração para iniciar um novo fluxo OAuth.
• Para autenticação por token de API, gere um token atual no painel do Globalping e envie-o como Authorization: Bearer YOUR_GLOBALPING_API_TOKEN.
• Após conectar, use a ferramenta authStatus para verificar se a autenticação está ativa e a ferramenta limits para verificar a cota horária gratuita de testes e os créditos disponíveis. O limite de taxa exibido cobre apenas testes gratuitos; usuários autenticados com créditos podem continuar acima dele gastando um crédito por teste adicional.

Obter ajuda ou relatar um problema

• Para dúvidas de uso e bugs reproduzíveis, abra uma issue no GitHub.
• Para relatos sensíveis à segurança, use o formulário privado Report a vulnerability do GitHub. Não inclua credenciais ou dados sensíveis em uma issue pública.
• A Política de Privacidade e os Termos de Uso do Globalping se aplicam a este serviço.

---

Desenvolvimento

src/
├── index.ts        # Main entry point & MCP agent definition
├── app.ts          # OAuth web routes
├── api/            # Globalping API client
├── auth/           # Authentication helpers
├── config/         # Configuration & constants
├── lib/            # Utilities
├── mcp/            # MCP tool definitions & handlers
├── types/          # TypeScript interfaces
└── ui/             # OAuth HTML templates

Credenciais e Segredos

Armazene credenciais OAuth:

npx wrangler secret put GLOBALPING_CLIENT_ID

Para verificação de domínio do diretório de plugins da OpenAI, armazene o token gerado pelo portal de submissão:

npx wrangler secret put OPENAI_APPS_CHALLENGE

O Worker serve esse valor como texto simples a partir de /.well-known/openai-apps-challenge. A rota retorna 404 até que o segredo seja configurado.

Configuração de Armazenamento KV

Para gerenciamento de estado OAuth do Cloudflare Workers:

1. Crie um namespace KV: npx wrangler kv:namespace create OAUTH_KV
2. Configure OAUTH_KV dentro de wrangler.jsonc.