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

https://www.gyrohosting.com/bilgi-bankasi/makale/gyro-mcp-sunucusu

- **Bu rehberde ne öğreneceksiniz**: Gyro MCP sunucusunu yapay zeka asistanınıza eklemeyi, asistanın Gyro belgelerinde arama yapmasını ve hesabınızı kendi API anahtarınızla güvenle yönetmesini.
- **Süre**: 5 dakika
- **Kimin için**: Claude, Cursor, VS Code gibi MCP destekli araç kullanan geliştiriciler ve sistem yöneticileri.
- **Gerekenler**: Node.js 18.17 ya da üstü, MCP destekli bir asistan; hesap işlemleri için Gyro API anahtarı.

## 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:

| Araçlar | Ne yapar | API anahtarı |
| --- | --- | --- |
| Belge araçları | Gyro geliştirici belgelerinde arama, bir API ucunun tam tanımı, ürün listesi, hesap sınırları | Gerekmez |
| Hesap araçları | Hizmetler, bulut sunucular, kapsayıcı ortamları ve logları, S3 kovaları, DNS kayıtları, bakiye; onayınızla güç, ölçekleme, DNS kaydı, sipariş ve silme | Kendi anahtarınız |

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

**Anahtarsız kullanabilir miyim?**

Evet. Anahtar vermezseniz yalnız belge araçları çalışır; hesabınızda hiçbir şey görülmez ya da değiştirilmez.

**Asistan benim haberim olmadan sipariş verebilir mi?**

Hayır. Sipariş araçları `confirm` olmadan yalnız fiyat teklifi döner. Ayrıca anahtarınıza `cloud_order` kapsamını vermezseniz sipariş hiç mümkün olmaz.

**Hangi sınırlar geçerli?**

API sınırları: varsayılan anahtar başına dakikada 60 istek ve günlük ücretli işlem sınırı. Tümü: [Hesap sınırları ve kotalar](https://www.gyrohosting.com/bilgi-bankasi/makale/hesap-sinirlari-ve-kotalar).

**Uzak (barındırılan) MCP adresi var mı?**

Evet: `https://mcp.gyrohosting.com/mcp`. Kurulum gerekmez; ayrıntılar Bölüm 3'teki "Kurulumsuz: uzak bağlantı" kısmında.

> **Biliyor muydunuz?**
> 
> Asistanınız Gyro'nun tüm API'sini de okuyabilir: OpenAPI tanımı [geliştirici belgelerinin OpenAPI sayfasında](https://www.gyrohosting.com/developers/tr/openapi.html).

## Sıradaki adım

- MCP kurulumu ve araç listesi: [Gyro geliştirici belgeleri: MCP](https://www.gyrohosting.com/developers/tr/mcp.html)
- İlk API isteği: [Gyro API'ye ilk adım](https://www.gyrohosting.com/bilgi-bankasi/makale/gyro-api-ilk-adim)