Gyro MCP sunucusu: Claude, Cursor ve VS Code'u Gyro hesabınıza bağlayın

1. MCP nedir, Gyro MCP sunucusu ne yapar?

Model Context Protocol (MCP), yapay zeka asistanlarını araçlara bağlayan açık bir standarttır. Gyro MCP sunucusu (@gyro-hosting/mcp, açık kaynak) bilgisayarınızda çalışır ve asistanınıza iki tür araç verir:

Asistan yalnız sizin hesabınızı görür: her çağrı sizin anahtarınızla yapılır.

2. API anahtarı oluşturma

1. Müşteri panelinde sağ üstteki hesap menüsünden API Kimlik Bilgileri sayfasını açın.
2. Yeni anahtar oluşturun. Önce yalnız okuma kapsamlarını seçin (cloud_read, services_read, billing_read). Asistanın değişiklik yapmasını istiyorsanız yazma kapsamlarını, sipariş vermesini istiyorsanız cloud_order kapsamını ekleyin.
3. IP listesine kendi bilgisayarınızın IP adresini ekleyin.
4. Anahtar bir kez gösterilir; parola yöneticinize kaydedin.

Yalnız belge araçlarını kullanacaksanız bu adımı atlayabilirsiniz.

3. Asistanınıza ekleme

Claude Desktop (Ayarlar → Developer → Edit Config), Cursor (~/.cursor/mcp.json) ve benzerleri:

{
  "mcpServers": {
    "gyro": {
      "command": "npx",
      "args": ["-y", "@gyro-hosting/mcp"],
      "env": { "GYRO_TOKEN": "wck_..." }
    }
  }
}

Claude Code:

claude mcp add gyro --env GYRO_TOKEN=wck_... -- npx -y @gyro-hosting/mcp

VS Code (.vscode/mcp.json; anahtar bir kez sorulur):

{
  "inputs": [{ "type": "promptString", "id": "gyro-token", "description": "Gyro API key", "password": true }],
  "servers": {
    "gyro": { "type": "stdio", "command": "npx", "args": ["-y", "@gyro-hosting/mcp"], "env": { "GYRO_TOKEN": "${input:gyro-token}" } }
  }
}

Asistanı yeniden başlatın; araç listesinde gyro görünür. Şunu deneyin: "Gyro'da hangi hizmetlerim var?"

Kurulumsuz: uzak bağlantı

Node.js kurmak istemiyorsanız Gyro'nun barındırdığı adresi kullanın: https://mcp.gyrohosting.com/mcp (Streamable HTTP). Anahtarınızı Authorization: Bearer wck_… başlığıyla gönderirsiniz; başlık yoksa yalnız belge araçları çalışır.

Claude Code:

claude mcp add --transport http gyro https://mcp.gyrohosting.com/mcp --header "Authorization: Bearer wck_..."

Cursor (~/.cursor/mcp.json):

{ "mcpServers": { "gyro": { "type": "http", "url": "https://mcp.gyrohosting.com/mcp", "headers": { "Authorization": "Bearer wck_..." } } } }

Claude.ai / Claude Desktop özel bağlayıcı: Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle → URL https://mcp.gyrohosting.com/mcp. Bu yolda anahtar gönderilemediği için yalnız belge araçları gelir; hesap işlemleri için Claude Code, Cursor, VS Code ya da yerel kurulumu kullanın.

IP kilitli anahtar kullanıyorsanız Gyro API'ye istekler uzak uç noktanın şu adreslerinden gelir; bunları anahtarın IP listesine ekleyin (ya da uzak uç için ayrı bir anahtar açın): 45.87.174.151, 45.87.174.153, 45.87.174.154.

Uzak uç noktada anahtar başına dakikada yaklaşık 120, IP başına 300 istek ve istek başına 256 KB sınırı vardır; API sınırları da ayrıca geçerlidir. Anahtarınız saklanmaz ve loglanmaz, her istek ayrı işlenir.

4. Güvenlik: para ve silme sizin onayınızla

• Değişiklik yapan araçlar (güç, ölçekleme, DNS kaydı, kova) confirm: true olmadan hiçbir şey yapmaz; asistana önce size sorması söylenir.
• Para harcayan araçlar (sunucu, kapsayıcı ortamı, depolama siparişi) önce fiyat teklifi döner. Siz onaylayınca sipariş bakiyenizden ödenir; tekrar korumalı anahtar sayesinde aynı istek iki kez sipariş vermez.
• Geri alınamaz araçlar (sunucu silme, DNS kaydı silme, kapsayıcı servisi silme) "yıkıcı" olarak işaretlidir; MCP istemciniz çalıştırmadan önce onay ister.
• Anahtarınız loglara yazılmaz ve yanıtlarda geri dönmez; yanıtlardaki parola gibi gizli alanlar maskelenir.
• İstem enjeksiyonu: sunucu adı, log ya da talep metni başkalarının yazdığı metin içerebilir. Her sonuç "güvenilmeyen veri" olarak işaretlenir. İhtiyacınız yoksa yazma ve silme kapsamlarını kapalı tutun.

5. Örnek istekler

• "Hangi bulut sunucularım kapalı?"
• "12345 numaralı kapsayıcı ortamındaki api servisinin son 50 log satırını göster."
• "İstanbul'da standart-2-4 sunucu aylık ne tutar?" (yalnız fiyat teklifi)
• "example.com'a www için 203.0.113.10 A kaydı ekle."
• "GitHub depomu Gyro Pipeline'a nasıl bağlarım?" (belge araması)

6. Sık sorulan sorular