Geliştiriciler

MCP sunucusu

Xide APP'i yapay zekâ asistanlarına bağla: hesabınla (OAuth) ya da API anahtarıyla bağlantı ve araç referansı.

Yapay zekâ asistanları (MCP)

Xide APP'i Cursor, Claude ya da VS Code'a bağla; asistanın senin kredinle görsel, video ve ses üretsin.

MCP sunucu adresi

https://xide.app/api/mcp

Hesabınla bağlan

Bağlayıcı destekleyen uygulamalarda yalnızca sunucu adresini ekle; Xide APP'te açılan onay ekranında izinleri ve günlük tavanı seçip onayla. Anahtar kopyalaman gerekmez.

Claude (web ve masaüstü):
Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle → adresi yapıştır → Bağlan
ChatGPT:
Ayarlar → Uygulamalar ve bağlayıcılar → Gelişmiş → Geliştirici modu → Oluştur → adresi yapıştır, kimlik doğrulama: OAuth

Anahtarla yapılandır

Cursor, Claude Code ve VS Code da adresi ekleyince aynı onay ekranını açar. Anahtarla bağlanmak istersen yapılandırmayı kopyala.

~/.cursor/mcp.json dosyasına ekle

Cursor
{
  "mcpServers": {
    "xide": {
      "url": "https://xide.app/api/mcp",
      "headers": {
        "Authorization": "Bearer xide_live_..."
      }
    }
  }
}

Yapılandırmadaki xide_live_… yerine kendi anahtarını yaz.

Asistanın kullanabileceği araçlar

  • list_models — Modelleri ve tahmini kredi aralıklarını listeler
  • get_model — Bir modelin girdilerini ve çözünürlük seçeneklerini gösterir
  • estimate_cost — Üretimin kesin kredi tutarını hesaplar
  • generate — Üretimi başlatır; 40 sn'ye kadar bekleyip sonucu ya da iş kimliğini döndürür
  • get_job — İşin durumunu ve çıktılarını getirir
  • cancel_job — Kuyruktaki işi iptal eder, kredi iade edilir
  • list_jobs — Son işleri listeler
  • get_balance — Bakiyeyi ve bugünkü kullanımı gösterir
  • upload_from_url — Herkese açık bir adresten dosya yükler

Anahtarın yetkileri asistan için de geçerlidir: "Üretim" yetkisi olmayan anahtarla kredi harcanamaz. Asistanlara verdiğin anahtarlarda günlük kredi tavanı kullanmanı öneririz.

Hesabınla bağlantı nasıl çalışır?

  1. 1Uygulamaya MCP sunucu adresini eklersin; uygulama kendini Xide APP'e kaydeder.
  2. 2Xide APP'te onay ekranı açılır: izinleri (üretim, okuma, yükleme, hesap) ve isteğe bağlı günlük kredi tavanını seçip onaylarsın.
  3. 3Uygulama yalnızca seçtiğin izinlere sahip bir anahtar alır. Bu bağlantıyı API ve MCP sayfasından istediğin an kaldırabilirsin.

Araç referansı

Asistanın çağırabildiği araçlar, gereken yetki ve parametreler.

  • list_modelsYetki: Okuma

    Modelleri ve tahmini kredi aralıklarını listeler

    category : image | edit | video | audio | lipsync | icon | utility | recast
    Only models of this category.
    search : string
    Filter by id or name, e.g. "kling" or "flux".
    limit : integer (1–100)
    Maximum number of models to return (default 40).
  • get_modelYetki: Okuma

    Bir modelin girdilerini ve çözünürlük seçeneklerini gösterir

    model : string*
    Model id from list_models, e.g. "text-to-image-flux-2-pro". Resolution variants have their own ids (see get_model).
  • estimate_costYetki: Okuma

    Üretimin kesin kredi tutarını hesaplar

    model : string*
    Model id from list_models, e.g. "text-to-image-flux-2-pro". Resolution variants have their own ids (see get_model).
    inputs : object
    Model inputs as returned by get_model, e.g. { "prompt": "...", "aspect_ratio": "16:9" }.
  • generateYetki: Üretim

    Üretimi başlatır; 40 sn'ye kadar bekleyip sonucu ya da iş kimliğini döndürür

    model : string*
    Model id from list_models, e.g. "text-to-image-flux-2-pro". Resolution variants have their own ids (see get_model).
    inputs : object*
    Model inputs as returned by get_model, e.g. { "prompt": "...", "aspect_ratio": "16:9" }.
    wait_seconds : integer (0–45)
    Seconds to wait for the job to finish (0-45). Default 40.
  • get_jobYetki: Okuma

    İşin durumunu ve çıktılarını getirir

    job_id : string*
    Job id returned by generate.
    wait_seconds : integer (0–45)
    Seconds to wait for the job to finish (0-45). Default 0.
  • cancel_jobYetki: Üretim

    Kuyruktaki işi iptal eder, kredi iade edilir

    job_id : string*
    Job id returned by generate.
  • list_jobsYetki: Okuma

    Son işleri listeler

    limit : integer (1–50)
    Number of jobs (default 10).
    status : queued | processing | completed | failed | cancelled
    Only jobs with this status.
  • get_balanceYetki: Hesap

    Bakiyeyi ve bugünkü kullanımı gösterir

    Parametre almaz.

  • upload_from_urlYetki: Yükleme

    Herkese açık bir adresten dosya yükler

    url : string*
    Public https URL of the file (max 256 MB).

* zorunlu parametre

MCP sunucusu dokümantasyonu | Xide APP