Xata MCP server

İçeriğin ana kısmına geç

Xata MCP sunucusu, yapay zeka asistanlarının ve ajanların Model Context Protocol (MCP) kullanarak Xata organizasyonlarınız, projeleriniz ve dallarınızla etkileşime girmesini sağlar.

​Xata MCP sunucusu nedir?

• Xata API'sinin yanında çalışan barındırılan bir MCP sunucusudur — yerel olarak kurulacak veya çalıştırılacak bir şey yoktur.
• Tarayıcıda OAuth ile veya başsız ortamlar için Xata API anahtarıyla kimlik doğrulaması yapılır.
• Streamable HTTP üzerinden uzak sunucuları destekleyen herhangi bir MCP istemcisinden erişilebilir.

Sunucu URL'si:

https://api.xata.tech/mcp

Sunucu Streamable HTTP taşıma protokolünü kullanır. SSE uç noktası veya sunucunun yerel (npm) sürümü yoktur.

​Kimlik doğrulama

MCP sunucusu iki kimlik doğrulama yöntemini destekler:

Yöntem	Ne zaman kullanılır	İstemci gereksinimi
OAuth	Bir düzenleyicide/sohbette etkileşimli kullanım	MCP OAuth desteği (dinamik istemci kaydı)
API anahtarı	Otomasyon, CI, başsız ajanlar	Özel HTTP başlıkları desteği

​OAuth

OAuth destekli istemcilerde yalnızca sunucu URL'sine ihtiyacınız vardır. İstemciniz ilk kez bağlandığında, kendisini Xata'ya kaydeder, bir tarayıcı penceresi açar ve Xata hesabınıza giriş yapmanızı ve erişimi onaylamanızı ister. Belirteçler kısa ömürlüdür ve MCP sunucusuna özeldir.

​API anahtarı

Özel başlıkları destekleyen istemciler, bunun yerine bir Xata API anahtarı ile kimlik doğrulayabilir:

Authorization: Bearer YOUR_XATA_API_KEY

Mevcut bir anahtarı yeniden kullanmak yerine MCP erişimi için özel bir API anahtarı oluşturun. Bunu bir ortam değişkeninde veya istemcinizin gizli depolama alanında saklayın — asla kaynak kontrolüne işlemeyin.

​MCP istemcinizi ayarlayın

​Cursor

Cursor, hızlı OAuth kurulumu için bir derin bağlantı sunar:Cursor'a Ekle

Alternatif olarak, manuel olarak ekleyebilirsiniz:

1. Komut paletini açın ve "Cursor Ayarları"nı arayın.
2. Araçlar ve MCP altında, Yeni MCP Sunucusu'na tıklayın.
3. Açılan yapılandırma dosyasına Xata sunucusunu ekleyin:

.cursor/mcp.json

{
  "mcpServers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

4. Dosyayı kaydedin. Cursor sizden kimlik doğrulamanızı ister — tarayıcı akışını izleyin ve Xata hesabınıza erişimi onaylayın.

​Claude Code

Sunucuyu terminalinizden ekleyin:

claude mcp add --transport http xata https://api.xata.tech/mcp

Ardından Claude Code'u başlatın ve /mcp eğik çizgi komutunu çalıştırın. xata sunucusunu seçin ve kimlik doğrulamak için tarayıcı talimatlarını izleyin. OAuth yerine bir API anahtarı kullanmak için (örneğin, CI'da):

claude mcp add --transport http xata https://api.xata.tech/mcp
  --header "Authorization: Bearer YOUR_XATA_API_KEY"

​VS Code

VS Code'daki MCP sunucuları GitHub Copilot ve GitHub Copilot Chat uzantılarını gerektirir.

1. Komut Paletini açın (Cmd+Shift+P / Ctrl+Shift+P).
2. MCP: Sunucu Ekle'yi çalıştırın ve HTTP'yi seçin.
3. URL olarak https://api.xata.tech/mcp ve ad olarak xata girin.

Alternatif olarak, yapılandırmanıza manuel olarak ekleyin:

.vscode/mcp.json

{
  "servers": {
    "xata": {
      "type": "http",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Sunucuyu MCP: Sunucuları Listele'den başlatın ve istendiğinde kimlik doğrulamasına izin verin.

​Claude (web ve masaüstü)

Xata'yı özel bir bağlayıcı olarak ekleyin:

1. Ayarlar → Bağlayıcılar'a gidin.
2. Özel bağlayıcı ekle'ye tıklayın.
3. Sunucu URL'si olarak https://api.xata.tech/mcp girin ve Ekle'ye tıklayın.
4. Xata hesabınızla oturum açmak için istemleri izleyin.

Uzak MCP kullanan özel bağlayıcılar tüm Claude planlarında kullanılamaz ve ekip planlarında bunları eklemek için bir organizasyon sahibi gerekebilir. Ayrıntılar için Claude belgelerine bakın.

​ChatGPT

Özel bir bağlayıcı kullanarak ChatGPT'yi Xata'ya bağlayın:

1. ChatGPT'de Ayarlar → Bağlayıcılar → Gelişmiş ayarlar'a gidin ve Geliştirici modunu etkinleştirin.
2. Bağlayıcılar sekmesinde, sunucu URL'si ile yeni bir bağlayıcı oluşturun:

https://api.xata.tech/mcp

3. Kimlik doğrulama için OAuth'u seçin ve istendiğinde yetkilendirme akışını tamamlayın.
4. Xata'yı kullanmak istediğiniz her sohbette, + düğmesine tıklayın ve Kaynak ekle altında Xata bağlayıcısını etkinleştirin.

​Codex CLI

Xata sunucusunu ekleyin:

codex mcp add xata --url https://api.xata.tech/mcp

add komutu bir tarayıcı açabilir ve bir OAuth hatası bildirebilir. Bu olursa, aşağıdaki giriş komutuyla devam edin; xata sunucu girişi zaten kaydedilmiştir.

Açık OAuth kapsamlarıyla Xata ile kimlik doğrulayın:

codex mcp login xata --scopes mcp-client,offline_access

Tarayıcıda yetkilendirmeyi tamamlayın. offline_access kapsamı, Codex'in başka bir tarayıcı yetkilendirmesi gerektirmeden Xata oturumunu yenilemesine olanak tanır. Ardından codex'yı başlatın, /mcp'yi çalıştırın ve xata'in bağlı ve kimliği doğrulanmış olduğunu doğrulayın.

​Antigravity CLI

Xata'yı genel MCP yapılandırmanıza ekleyin:

~/.gemini/config/mcp_config.json

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

Xata'yı yalnızca bir proje için etkinleştirmek için, o projenin kökünde .agents/mcp_config.json kullanın. agy'yı başlatın ve /mcp girin. MCP Yöneticisi'nde, xata için Kimlik Doğrula'yı kullanın ve OAuth'u tamamlamak için istemleri izleyin.

​OpenCode

Xata sunucusunu OpenCode yapılandırma dosyanıza ekleyin:

~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xata": {
      "type": "remote",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Ardından terminalinizden kimlik doğrulayın:

opencode mcp auth xata

​Amp

Sunucuyu terminalinizden ekleyin:

amp mcp add xata https://api.xata.tech/mcp

Ardından amp'ü başlatın — tarayıcıda kimlik doğrulamanız istenmelidir. Sunucunun bağlı olduğunu doğrulamak için /mcp list tools'ü çalıştırın.

​Windsurf

1. Windsurf'te Cascade panelini açın ve MCP (çekiç) simgesine tıklayın, ardından ham yapılandırma dosyasını açmak için Yapılandır'a tıklayın (~/.codeium/windsurf/mcp_config.json).
2. Xata sunucusu girişini ekleyin:

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

3. Dosyayı kaydedin ve Cascade kenar çubuğunda Yenile'ye tıklayın. Tarayıcı penceresi açıldığında OAuth akışını tamamlayın.

​Zed

1. Ayarlar → AI → MCP Sunucuları'nı açın ve Sunucu Ekle → Uzak Sunucu Ekle'ye tıklayın veya ayarlar dosyanızı doğrudan düzenleyin:

settings.json

{
  "context_servers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

2. Zed, standart MCP OAuth akışını kullanarak sunucuya karşı kimlik doğrulamanızı ister.

​Cline

1. VS Code'da Cline'ı açın ve MCP Sunucuları simgesine tıklayın.
2. Uzak Sunucular sekmesinde, ad olarak xata, URL olarak https://api.xata.tech/mcp girin ve taşıma protokolü olarak Streamable HTTP'yi seçin. Veya yapılandırma JSON'ını doğrudan düzenleyin:

{
  "mcpServers": {
    "xata": {
      "type": "streamableHttp",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Taşıma protokolü türü streamableHttp (camelCase) olmalıdır. Atlanması, Cline'ın Xata MCP sunucusunun desteklemediği eski SSE taşıma protokolüne geri dönmesine neden olur.

​Diğer MCP istemcileri

Herhangi bir MCP istemcisi şunları destekliyorsa bağlanabilir:

• Streamable HTTP üzerinden uzak MCP sunucuları (SSE değil)
• Dinamik istemci kaydı ile OAuth veya API anahtarı kimlik doğrulaması için özel HTTP başlıkları

Uzak MCP sunucularını nerede yapılandıracağınız için istemcinizin belgelerine bakın ve URL olarak https://api.xata.tech/mcp kullanın.

​Bağlantıyı doğrulayın

Bağlandıktan sonra asistanınıza sorun:

Xata MCP sunucusunu kullanarak bana kim olarak kimlik doğrulandığımı söyle.

Asistan, user_info aracını çağırmalı ve kullanıcı kimliğinizi (veya bir anahtarla kimlik doğruladıysanız API anahtarı kimliğini) döndürmelidir. Bunu yaparsa, bağlantı çalışıyor demektir.

​Kullanılabilir araçlar

Xata MCP sunucusu aşağıdaki araçları sunar:

Araç	Açıklama
user_info	Kimliği doğrulanmış çağıranın kimliğini döndürür — OAuth için kullanıcı kimliğiniz ve e-postanız veya API anahtarı kimliği.
search_operations	Niyete göre bir Xata REST API işlemi bulun (örneğin, "dalları listele" veya "üye davet et").
describe_operation	Belirli bir işlem için parametreleri ve istek/yanıt şemalarını döndürür.
call_read_operation	Salt okunur bir Xata REST API işlemini çağırın.
call_write_operation	Veri oluşturan veya güncelleyen bir Xata REST API işlemini çağırın.
call_destructive_operation	Verileri yok eden veya erişimi iptal eden bir Xata REST API işlemini çağırın. confirm=true gerektirir.
run_sql	Bir dala karşı SQL çalıştırın. Varsayılan olarak salt okunur; verileri değiştiren ifadeleri çalıştırmak için write=true geçirin.
describe_schema	Bir dalın tablolarını ve sütunlarını listeleyin.
list_skills	Kullanılabilir Xata becerilerini listeleyin — yaygın çok adımlı görevler için rehberli iş akışları.
get_skill	Belirli bir beceri için talimatları okuyun.
search_xata	Xata belgelerinde arama yapın.
query_docs_filesystem_xata	Xata belgeleri sayfalarını yola göre okuyun.

​Güvenlik

• Etkileşimli istemciler için OAuth'u tercih edin; belirteçler kısa ömürlüdür ve istemcinizde sunucunun bağlantısını keserek iptal edilebilir.
• Otomasyon için özel bir API anahtarı kullanın ve düzenli olarak döndürün.
• Bazı araçlar verilerinizi değiştirebilir: call_write_operation ve call_destructive_operation kaynakları değiştirebilir veya silebilir (ikincisi confirm=true gerektirir) ve run_sql, write=true ile çağrıldığında verileri değiştirebilir. Asistanınızın önerdiği eylemleri onaylamadan önce inceleyin ve herhangi bir yazma veya silme işlemi için döngüde bir insan bulundurun.

​Sorun giderme

Kimlik doğrulama başarısız olmaya devam ediyor veya döngüye giriyor. Xata sunucusunu istemcinizden kaldırın, istemciyi yeniden başlatın ve yeni bir OAuth akışı tetiklemek için sunucuyu tekrar ekleyin. Sunucu bağlanıyor ancak hiçbir araç görünmüyor. Kimlik doğrulama adımını tamamladığınızdan emin olun — çoğu araç görünmeden önce geçerli bir oturum gerektirir. İstemcinizin kimlik doğrulama akışını yeniden çalıştırın, ardından araç listesini yenileyin. Tam set için Kullanılabilir araçlar bölümüne bakın. İstemciniz hiç bağlanamıyor. URL'nin tam olarak https://api.xata.tech/mcp olduğunu ve istemcinizin Streamable HTTP'yi desteklediğini doğrulayın. Yalnızca SSE destekli istemciler desteklenmez. Sunucu istemcinizde görünmüyor. İstemcinin MCP yapılandırma dosyası sözdizimini kontrol edin — JSON şekli istemciler arasında farklılık gösterir (mcpServers vs servers vs context_servers, url vs serverUrl) — ve istemcinin günlüklerini kontrol edin. Çoğu istemci, yapılandırma değişikliklerinden sonra tam bir yeniden başlatma gerektirir.

Bu sayfa yardımcı oldu mu?

Önceki

Organizasyonlar

Sonraki