Globalping

Globalping MCP Sunucusu

Yapay zeka modellerinin doğal dil aracılığıyla küresel bir ağ ölçüm platformuyla etkileşime girmesini sağlayın. Herhangi bir LLM'ye ağ erişimi verin.

Globalping Nedir?

Globalping, internet altyapısını izlemek, hata ayıklamak ve kıyaslama yapmak için küresel olarak dağıtılmış bir prob ağına erişim sağlayan ücretsiz, herkese açık bir API'dir. Globalping ile dünya genelindeki binlerce konumdan ağ testleri (ping, traceroute, DNS, MTR, HTTP) çalıştırabilirsiniz.

Globalping MCP Sunucusu Nedir?

Globalping MCP Sunucusu, Model Context Protocol (MCP) uygulayarak yapay zeka modellerinin ve IDE asistanlarının doğal dil aracılığıyla Globalping'in ağ ölçüm yetenekleriyle etkileşime girmesini sağlar.

Sunucu, otomatik iş akışları için standart OAuth 2.0 kimlik doğrulamasının yanı sıra API token kimlik doğrulamasını da destekler.

Temel Özellikler

• 🌐 Küresel Ağ Erişimi: Dünya genelindeki binlerce probdan ölçüm çalıştırın
• 🤖 Yapay Zeka Dostu Arayüz: Herhangi bir LLM verileri kolayca ayrıştırır ve gerektiğinde yeni ölçümler çalıştırır
• 📊 Kapsamlı Ölçümler: Ping, traceroute, DNS, MTR ve HTTP testleri desteği
• 🔍 Akıllı Bağlam Yönetimi: Akıllı ajan yönlendirmesi için ayrıntılı parametre açıklamaları ve anlamsal araç açıklamaları
• 🔄 Karşılaştırmalı Analiz: Farklı hedefler ve coğrafi konumlar arasında ağ gecikmesini ve yönlendirmeyi karşılaştırın
• 🔑 Kimlik Doğrulama Desteği: Daha yüksek hız limitleri için Globalping hesabınızla OAuth veya API token kullanın

---

Kurulum

Tüm modern MCP entegrasyonları için birincil uç nokta:

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

ChatGPT ve Codex

Globalping'i ChatGPT ve Codex'te uzak bir MCP sunucusu olarak bağlayın:

ChatGPT (Web ve Masaüstü)

1. ChatGPT'de Ayarlar → Güvenlik ve giriş bölümüne gidin ve Geliştirici modunu etkinleştirin (veya ChatGPT Masaüstü'nde Ayarlar → Özellikler → MCP Sunucuları).
2. Uç nokta ile yeni bir özel bağlayıcı / MCP sunucusu ekleyin:

https://mcp.globalping.dev/mcp

3. İstendiğinde OAuth ile kimlik doğrulayın.

OpenAI Codex

Codex CLI kullanarak uzak sunucuyu ekleyin:

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

Veya doğrudan ~/.codex/config.toml dosyasına ekleyin:

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

Claude (Web, Masaüstü)

Claude, yerel mcp-remote köprüleri gerektirmeden uzak Streamable HTTP MCP bağlayıcılarını yerel olarak destekler:

1. Claude'da Ayarlar → Bağlayıcılar bölümüne gidin (Ekip/Kurumsal hesaplar için Kuruluş ayarları → Bağlayıcılar).
2. + Özel bağlayıcı ekle seçeneğine tıklayın.
3. Bağlayıcı ayrıntılarını doldurun:

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

Claude Code

Terminalinizde aşağıdaki komutu çalıştırın:

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

Globalping'i yalnızca geçerli proje dizini yerine makinenizdeki tüm projelerde (küresel kullanıcı kapsamı) kullanılabilir yapmak için:

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

SSH üzerinden veya başsız bir terminalde çalışıyorsanız yetkilendirme URL değişimini manuel olarak tamamlamak için claude mcp login globalping --no-browser komutunu çalıştırın.

Cursor

Globalping'i tek tıkla Cursor'a ekleyin:

Veya Ayarlar → Özellikler → MCP Sunucuları → Yeni MCP Sunucusu Ekle bölümünden manuel olarak yapılandırın:

• Tür: SSE / HTTP
• Ad: globalping
• URL: https://mcp.globalping.dev/mcp

Gemini CLI

Globalping, resmi Gemini CLI Uzantı Galerisi içinde dizinlenmiştir.

Gemini uzantı yöneticisi aracılığıyla yükleyin:

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

(Uzantının otomatik olarak güncel kalması için --auto-update ekleyin).

VS Code ve GitHub Copilot

• Komut Paleti: MCP: Add Server komutunu çalıştırın ve https://mcp.globalping.dev/mcp girin.

Genel MCP İstemcileri

Standart Streamable HTTP MCP aktarımını destekleyen herhangi bir istemci için şunu ekleyin:

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

Eski İstemciler (SSE / stdio yedeği): İstemciniz kesinlikle yerel bir işlem köprüsü üzerinden SSE gerektiriyorsa, npx mcp-remote https://mcp.globalping.dev/sse yapılandırın.

---

Kimlik Doğrulama

Globalping MCP iki kimlik doğrulama modunu destekler:

• OAuth 2.0: Etkileşimli istemcilerde bağlantı sırasında otomatik olarak işlenir.
• API Token: Başsız betikler, CI/CD hatları veya programatik API istemcileri için kullanışlıdır.

Globalping API Token Kullanımı

1. dash.globalping.io adresine gidin ve Tokenlar altında bir API token oluşturun.
2. Token'ı standart HTTP başlıkları aracılığıyla iletin:

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

---

Programatik Entegrasyon (Anthropic Messages API)

Globalping'i doğrudan Anthropic'in Messages API'si (MCP Bağlayıcısı) ile kullanmak için, istek yükünüzde uzak sunucu tanımını iletin:

{
  "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."
    }
  ]
}

---

Kullanılabilir Araçlar

Araç	Açıklama
ping	Bir hedefe ICMP/paket ping testleri gerçekleştirin
traceroute	Bir hedefe ağ yönlendirme atlamalarını izleyin
dns	Belirli çözümleyiciler ve kayıt türlerini kullanarak DNS sorgularını çözün
mtr	Birleşik ping ve traceroute testleri çalıştırın (My Traceroute)
http	Dünya genelindeki problar üzerinden HTTP/HTTPS istekleri yürütün
locations	Kullanılabilir Globalping prob bölgelerini ve filtrelerini listeleyin
limits	Geçerli ücretsiz saatlik test kotasını ve ek kredileri görüntüleyin
getMeasurement	Kimliğe göre geçmiş bir ölçümün sonuçlarını alın
compareLocations	Çok bölgeli performans metriklerini karşılaştırmak için yardımcı kılavuz
help	Araç referansı ve sözdizimi belgeleri
authStatus	Geçerli MCP kimlik doğrulama durumunu kontrol edin

---

Kullanım Örnekleri

Bağlandıktan sonra doğal dil kullanarak ağ teşhislerini çalıştırın:

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?

---

Konum Belirtimi

Konumlar, konumun magic parametresi kullanılarak belirtilebilir:

• Kıtalar: EU, NA, AS, AF, OC, SA
• Ülke kodları: US, DE, JP, PL, BR
• Şehirler: London, Tokyo, New York, Warsaw
• Ağlar ve ASN'ler: Cloudflare, Google, AS13335, AS15169
• Bulut bölgeleri: aws-us-east-1, gcp-us-central1
• Kombinasyonlar: London+UK, Cloudflare+US, AWS+Frankfurt

---

Sorun Giderme ve Destek

Bağlayıcı sunucuya ulaşamıyor

• Streamable HTTP uç noktasını tam olarak gösterildiği gibi kullanın: https://mcp.globalping.dev/mcp.
• OAuth tamamlanmadan önce 401 Unauthorized yanıtı beklenir. Entegrasyonu yeniden bağlayın ve tarayıcı yetkilendirme akışını tamamlayın.
• Eski /sse uç noktasını yalnızca Streamable HTTP'yi desteklemeyen istemciler için kullanın.

Kimlik doğrulama başarısız oluyor veya süresi doluyor

• Yeni bir OAuth akışı başlatmak için entegrasyonu kaldırın ve yeniden bağlayın.
• API token kimlik doğrulaması için Globalping panelinde güncel bir token oluşturun ve Authorization: Bearer YOUR_GLOBALPING_API_TOKEN olarak gönderin.
• Bağlandıktan sonra kimlik doğrulamanın aktif olduğunu doğrulamak için authStatus aracını ve ücretsiz saatlik test kotasını ve mevcut kredileri kontrol etmek için limits aracını kullanın. Görüntülenen hız limiti yalnızca ücretsiz testleri kapsar; kredisi olan kimliği doğrulanmış kullanıcılar, ek test başına bir kredi harcayarak bu limitin üzerine çıkabilir.

Yardım alın veya bir sorun bildirin

• Kullanım soruları ve tekrarlanabilir hatalar için bir GitHub sorunu açın.
• Güvenlikle ilgili raporlar için GitHub'ın özel Güvenlik açığı bildir formunu kullanın. Herkese açık bir soruna kimlik bilgileri veya hassas veriler eklemeyin.
• Globalping'in Gizlilik Politikası ve Kullanım Koşulları bu hizmet için geçerlidir.

---

Geliştirme

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

Kimlik Bilgileri ve Sırlar

OAuth kimlik bilgilerini saklayın:

npx wrangler secret put GLOBALPING_CLIENT_ID

OpenAI eklenti dizini alan doğrulaması için, gönderim portalı tarafından oluşturulan token'ı saklayın:

npx wrangler secret put OPENAI_APPS_CHALLENGE

Worker bu değeri /.well-known/openai-apps-challenge konumundan düz metin olarak sunar. Sır yapılandırılana kadar rota 404 döndürür.

KV Depolama Kurulumu

Cloudflare Workers OAuth durum yönetimi için:

1. Bir KV ad alanı oluşturun: npx wrangler kv:namespace create OAUTH_KV
2. wrangler.jsonc içinde OAUTH_KV yapılandırın.