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

Gyro MCP sunucusu, yapay zeka asistanlarının bu belgelerde arama yapmasını ve Gyro bulutunuzu kendi API anahtarınızla yönetmesini sağlar: sunucu, kapsayıcı, S3, DNS, fatura. Para harcayan ve silen işlemler her zaman onayınızı ister.

Model Context Protocol (MCP), yapay zeka asistanlarını araçlara bağlar. Gyro MCP sunucusu (@gyro-hosting/mcp, açık kaynak, MPL-2.0) bilgisayarınızda çalışır, Gyro API ile kendi API anahtarınızla konuşur ve yalnız sizin hesabınızı görür.

1. API anahtarı oluşturun#

Müşteri paneli → sağ üstteki hesap menüsü → API Kimlik Bilgileri. Okuma kapsamlarıyla başlayın (cloud_read, services_read, billing_read); asistanın değişiklik yapmasını istiyorsanız yazma, sipariş ya da silme kapsamlarını ekleyin. Anahtarın IP listesine kendi IP adresinizi ekleyin. Belge araçları anahtarsız da çalışır.

2. Sunucuyu asistanınıza ekleyin#

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

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

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

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

Claude Desktop: Ayarlar → Developer → Edit Config (claude_desktop_config.json). Cursor: ~/.cursor/mcp.json ya da projede .cursor/mcp.json. VS Code: .vscode/mcp.json (anahtar bir kez sorulur, VS Code saklar). Node.js 18.17 ya da üstü gerekir.

Yalnız belgeler (anahtarsız, hiçbir şey değiştirilemez):

{
  "mcpServers": {
    "gyro-docs": { "command": "npx", "args": ["-y", "@gyro-hosting/mcp"] }
  }
}

3. Araçlar#

Araç	Ne yapar	Anahtar
`search_docs`, `get_endpoint`, `get_doc`, `list_products`, `get_limits_info`	Bu belgelerde arama, bir ucun OpenAPI tanımı, sayfayı Markdown olarak okuma, ürün listesi, hesap sınırları	gerekmez
`whoami`, `list_services`, `get_service`, `list_servers`, `get_server`, `get_catalog`, `get_balance`	Hesap, hizmetler, sunucular, paket/bölge/imaj, bakiye	okuma kapsamları
`get_container_environment`, `list_container_services`, `get_container_logs`	Kapsayıcı (ECS): ortam, servisler, loglar	okuma kapsamları
`list_vpcs`, `get_vpc`, `list_server_nics`	Özel ağ (VPC, Gyro Bulut İstanbul): VPC, subnet, bağlı sunucular, kapı, sunucu kartları	okuma kapsamları
`list_buckets`, `list_objects`, `list_dns_zones`, `list_dns_records`, `api_get`	S3 kova ve nesneleri, DNS bölge ve kayıtları, diğer tüm GET uçları	okuma kapsamları
`server_power`, `scale_container_service`, `restart_container_service`, `set_dns_record`, `create_bucket`	Değişiklik yapar — yalnız `confirm: true` ile	yazma kapsamları
`create_vpc`, `rename_vpc`, `create_subnet`, `attach_server_nic`, `set_vpc_gateway`, `add_port_forward`, `server_public_ip_on`	Özel ağ değişiklikleri — yalnız `confirm: true` ile; VPC kapısı açıkken saatlik ücretlenir	yazma kapsamları
`create_server`, `create_container_environment`, `create_storage`	Para harcar: `confirm` olmadan yalnız fiyat teklifi (dry run) döner	`cloud_order`
`delete_server`, `delete_dns_record`, `delete_container_service`, `delete_vpc`, `delete_subnet`, `detach_server_nic`, `remove_port_forward`, `server_public_ip_off`, `api_request`	Geri alınamaz (`destructiveHint` işaretli) — yalnız `confirm: true` ile	yazma / silme kapsamları

Güvenlik#

Anahtar sizin, hesap sizin. Her çağrı yapılandırdığınız anahtarla çalışır; size ait olmayan her şeye API 404 yanıtı verir. Anahtar loglara yazılmaz, sonuçlarda geri dönmez; yanıtlardaki gizli alanlar siz istemedikçe maskelenir.

Para ve silme sizin onayınızla. Değişiklik yapan araçlar confirm: true olmadan hiçbir şey yapmaz ve asistanlara önce size sormaları söylenir. Sipariş araçları önce fiyat teklifi (dry run) verir; gerçek siparişte Idempotency-Key kullanılır, tekrar denemede iki kez sipariş verilmez. Geri alınamaz araçlar destructiveHint ile işaretlidir; istemciler çalıştırmadan önce sorar.

İstem enjeksiyonu. Sunucu adları, loglar ve talep metinleri başkalarının yazdığı metin içerebilir. Her sonuç güvenilmeyen veri olarak sarılır ve asistana içindeki talimatlara asla uymaması söylenir. İhtiyacınız yoksa yazma ve silme kapsamlarını kapalı tutun.

Sınırlar. API sınırları geçerlidir (varsayılan anahtar başına dakikada 60 istek, günlük ücretli işlem sınırı). Bkz. Hesap sınırları.

Örnek istekler#

“Hangi 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?” · “example.com'a www → 203.0.113.10 A kaydı ekle.” · “GitHub deposunu Gyro Pipeline'a nasıl bağlarım?”

Uzak uç nokta (kurulumsuz)#

Aynı sunucuyu Gyro sizin için https://mcp.gyrohosting.com/mcp adresinde de çalıştırır (Streamable HTTP, durumsuz). Kurulum gerekmez: anahtarınızı Authorization: Bearer wck_… başlığıyla gönderin. Başlık yoksa yalnız belge araçları çalışır.

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

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

{
  "inputs": [
    { "type": "promptString", "id": "gyro-token", "description": "Gyro API key", "password": true }
  ],
  "servers": {
    "gyro": {
      "type": "http",
      "url": "https://mcp.gyrohosting.com/mcp",
      "headers": { "Authorization": "Bearer ${input:gyro-token}" }
    }
  }
}

Claude.ai ve Claude Desktop (özel bağlayıcı): Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle → URL https://mcp.gyrohosting.com/mcp. Anahtarsız bağlayıcı belge araçlarını verir; hesap araçları için Authorization başlığı gönderebilen bir istemci (Claude Code, Cursor, VS Code) ya da yukarıdaki yerel sunucuyu kullanın.

IP kilitli anahtarlar: Gyro API'ye çağrılar uç noktanın 45.87.174.151, 45.87.174.153, 45.87.174.154 adreslerinden gelir; bunları anahtarın IP listesine ekleyin (ya da uzak uç için ayrı bir anahtar kullanın). Sınırlar: uç noktada anahtar başına dakikada yaklaşık 120, IP başına 300 istek ve istek başına 256 KB; yukarıdaki API sınırları da geçerlidir. Anahtarınız saklanmaz ve loglanmaz; her istek ayrı işlenir.