Globalping

Server MCP Globalping

Memungkinkan model AI berinteraksi dengan platform pengukuran jaringan global melalui bahasa alami. Berikan akses jaringan ke LLM mana pun.

Apa itu Globalping?

Globalping adalah API publik gratis yang menyediakan akses ke jaringan probe yang tersebar secara global untuk memantau, men-debug, dan melakukan benchmarking infrastruktur internet. Dengan Globalping, Anda dapat menjalankan tes jaringan (ping, traceroute, DNS, MTR, HTTP) dari ribuan lokasi di seluruh dunia.

Apa itu Server MCP Globalping?

Server MCP Globalping mengimplementasikan Model Context Protocol (MCP), yang memungkinkan model AI dan asisten IDE berinteraksi dengan kemampuan pengukuran jaringan Globalping melalui bahasa alami.

Server ini mendukung autentikasi OAuth 2.0 standar serta autentikasi token API untuk alur kerja otomatis.

Fitur Utama

• 🌐 Akses Jaringan Global: Jalankan pengukuran dari ribuan probe di seluruh dunia
• 🤖 Antarmuka Ramah AI: LLM mana pun akan dengan mudah memproses data dan menjalankan pengukuran baru sesuai kebutuhan
• 📊 Pengukuran Komprehensif: Dukungan untuk tes ping, traceroute, DNS, MTR, dan HTTP
• 🔍 Penanganan Konteks Cerdas: Deskripsi parameter terperinci dan anotasi alat semantik untuk perutean agen yang cerdas
• 🔄 Analisis Komparatif: Bandingkan latensi jaringan dan perutean antara target dan lokasi geografis yang berbeda
• 🔑 Dukungan Autentikasi: Gunakan OAuth atau token API dengan akun Globalping Anda untuk batas kecepatan yang lebih tinggi

---

Instalasi

Endpoint utama untuk semua integrasi MCP modern adalah:

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

ChatGPT & Codex

Hubungkan Globalping sebagai server MCP jarak jauh di ChatGPT dan Codex:

ChatGPT (Web & Desktop)

1. Di ChatGPT, buka Pengaturan → Keamanan dan login dan aktifkan Mode pengembang (atau Pengaturan → Fitur → Server MCP di ChatGPT Desktop).
2. Tambahkan konektor khusus / server MCP baru dengan endpoint:

https://mcp.globalping.dev/mcp

3. Autentikasi melalui OAuth saat diminta.

OpenAI Codex

Tambahkan server jarak jauh menggunakan Codex CLI:

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

Atau tambahkan ke ~/.codex/config.toml secara langsung:

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

Claude (Web, Desktop)

Claude mendukung konektor MCP Streamable HTTP jarak jauh secara native tanpa memerlukan jembatan mcp-remote lokal:

1. Di Claude, navigasikan ke Pengaturan → Konektor (atau Pengaturan organisasi → Konektor untuk akun Tim/Perusahaan).
2. Klik + Tambahkan konektor khusus.
3. Isi detail konektor:

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

Claude Code

Jalankan perintah berikut di terminal Anda:

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

Untuk membuat Globalping tersedia di semua proyek di mesin Anda (cakupan pengguna global) alih-alih hanya di direktori proyek saat ini:

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

Jalankan claude mcp login globalping --no-browser jika bekerja melalui SSH atau di terminal tanpa kepala untuk menyelesaikan pertukaran URL otorisasi secara manual.

Cursor

Tambahkan Globalping ke Cursor dalam satu klik:

Atau konfigurasikan secara manual di Pengaturan → Fitur → Server MCP → Tambahkan Server MCP Baru:

• Tipe: SSE / HTTP
• Nama: globalping
• URL: https://mcp.globalping.dev/mcp

Gemini CLI

Globalping terindeks di Galeri Ekstensi Gemini CLI resmi.

Instal melalui manajer ekstensi Gemini:

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

(Tambahkan --auto-update untuk menjaga ekstensi tetap diperbarui secara otomatis).

VS Code & GitHub Copilot

• Palet Perintah: Jalankan MCP: Add Server dan masukkan https://mcp.globalping.dev/mcp.

Klien MCP Generik

Untuk klien apa pun yang mendukung transport MCP Streamable HTTP standar, tambahkan:

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

Klien Lama (fallback SSE / stdio): Jika klien Anda secara ketat memerlukan SSE melalui jembatan proses lokal, konfigurasikan npx mcp-remote https://mcp.globalping.dev/sse.

---

Autentikasi

Globalping MCP mendukung dua mode autentikasi:

• OAuth 2.0: Ditangani secara otomatis di klien interaktif selama koneksi.
• Token API: Berguna untuk skrip tanpa kepala, pipeline CI/CD, atau klien API terprogram.

Menggunakan Token API Globalping

1. Buka dash.globalping.io dan buat token API di bawah Token.
2. Kirim token melalui header HTTP standar:

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

---

Integrasi Terprogram (Anthropic Messages API)

Untuk menggunakan Globalping secara langsung dengan Messages API Anthropic (Konektor MCP), kirim definisi server jarak jauh di payload permintaan Anda:

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

---

Alat yang Tersedia

Alat	Deskripsi
ping	Lakukan tes ping ICMP/paket ke tujuan
traceroute	Lacak hop perutean jaringan ke target
dns	Selesaikan kueri DNS menggunakan resolver dan tipe catatan tertentu
mtr	Jalankan tes ping dan traceroute gabungan (My Traceroute)
http	Jalankan permintaan HTTP/HTTPS dari probe di seluruh dunia
locations	Daftarkan wilayah dan filter probe Globalping yang tersedia
limits	Tampilkan tunjangan tes per jam gratis saat ini dan kredit tambahan
getMeasurement	Ambil hasil pengukuran historis berdasarkan ID
compareLocations	Panduan bantuan untuk membandingkan metrik kinerja multi-wilayah
help	Referensi alat dan dokumentasi sintaks
authStatus	Periksa status autentikasi MCP saat ini

---

Contoh Penggunaan

Setelah terhubung, jalankan diagnostik jaringan menggunakan bahasa alami:

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?

---

Spesifikasi Lokasi

Lokasi dapat ditentukan menggunakan parameter magic lokasi:

• Benua: EU, NA, AS, AF, OC, SA
• Kode negara: US, DE, JP, PL, BR
• Kota: London, Tokyo, New York, Warsaw
• Jaringan & ASN: Cloudflare, Google, AS13335, AS15169
• Wilayah cloud: aws-us-east-1, gcp-us-central1
• Kombinasi: London+UK, Cloudflare+US, AWS+Frankfurt

---

Pemecahan Masalah dan Dukungan

Konektor tidak dapat menjangkau server

• Gunakan endpoint Streamable HTTP persis seperti yang ditunjukkan: https://mcp.globalping.dev/mcp.
• Respons 401 Unauthorized sebelum menyelesaikan OAuth adalah hal yang wajar. Hubungkan kembali integrasi dan selesaikan alur otorisasi browser.
• Gunakan endpoint /sse lama hanya untuk klien yang tidak mendukung Streamable HTTP.

Autentikasi gagal atau kedaluwarsa

• Hapus dan hubungkan kembali integrasi untuk memulai alur OAuth baru.
• Untuk autentikasi token API, buat token saat ini di dasbor Globalping dan kirim sebagai Authorization: Bearer YOUR_GLOBALPING_API_TOKEN.
• Setelah terhubung, gunakan alat authStatus untuk memverifikasi bahwa autentikasi aktif dan alat limits untuk memeriksa tunjangan tes per jam gratis dan kredit yang tersedia. Batas kecepatan yang ditampilkan hanya mencakup tes gratis; pengguna terautentikasi dengan kredit dapat melanjutkan di atasnya dengan menghabiskan satu kredit per tes tambahan.

Dapatkan bantuan atau laporkan masalah

• Untuk pertanyaan penggunaan dan bug yang dapat direproduksi, buka masalah GitHub.
• Untuk laporan yang sensitif terhadap keamanan, gunakan formulir Laporkan kerentanan pribadi GitHub. Jangan sertakan kredensial atau data sensitif dalam masalah publik.
• Kebijakan Privasi dan Ketentuan Penggunaan Globalping berlaku untuk layanan ini.

---

Pengembangan

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

Kredensial & Rahasia

Simpan kredensial OAuth:

npx wrangler secret put GLOBALPING_CLIENT_ID

Untuk verifikasi domain direktori plugin OpenAI, simpan token yang dihasilkan oleh portal pengiriman:

npx wrangler secret put OPENAI_APPS_CHALLENGE

Worker menyajikan nilai ini sebagai teks biasa dari /.well-known/openai-apps-challenge. Rute mengembalikan 404 hingga rahasia dikonfigurasi.

Pengaturan Penyimpanan KV

Untuk manajemen status OAuth Cloudflare Workers:

1. Buat namespace KV: npx wrangler kv:namespace create OAUTH_KV
2. Konfigurasikan OAUTH_KV di dalam wrangler.jsonc.