Xata MCP server

MCP Sunucusu

Cursor, Claude, VS Code ve diğer MCP istemcilerini Xata'ya bağlayın

Xata MCP sunucusu, yapay zekâ asistanlarının ve ajanlarının Model Context Protocol (MCP) kullanarak Xata kuruluşlarınız, projeleriniz ve dallarınızla etkileşim kurmasını sağlar.

Xata MCP sunucusu nedir?

• Xata API'sinin yanında çalışan, barındırılan bir MCP sunucusudur — yerel olarak yüklemeniz veya çalıştırmanız gerekmez.
• Tarayıcınızda OAuth ile veya başsız ortamlarda Xata API anahtarıyla kimlik doğrulaması yapar.
• Streamable HTTP üzerinden uzak sunucuları destekleyen tüm MCP istemcilerinden erişilebilir.

Sunucu URL'si:

https://api.xata.tech/mcp

Sunucu, Streamable HTTP aktarımını kullanır. SSE uç noktası ve sunucunun yerel (npm) sürümü yoktur.

Kimlik doğrulama

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

Yöntem	Kullanım durumu	İ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 üstbilgileri desteği

OAuth

OAuth destekleyen istemcilerde yalnızca sunucu URL'sine ihtiyacınız vardır. İstemciniz ilk kez bağlandığında Xata'ya kaydolur, bir tarayıcı penceresi açar ve Xata hesabınızda oturum açıp erişimi onaylamanızı ister. Belirteçlerin ömrü kısadır ve kapsamları MCP sunucusuyla sınırlıdır.

API anahtarı

Özel üstbilgileri destekleyen istemciler bunun yerine bir Xata API anahtarı ile kimlik doğrulaması yapabilir:

Authorization: Bearer YOUR_XATA_API_KEY

[!WARNING]

Mevcut bir anahtarı yeniden kullanmak yerine MCP erişimi için özel bir API anahtarı oluşturun. Anahtarı bir ortam değişkeninde veya istemcinizin gizli bilgi deposunda saklayın — kaynak denetimine asla eklemeyin.

MCP istemcinizi kurun

Cursor

[!TIP]

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

Cursor'a ekle

Alternatif olarak, sunucuyu elle ekleyebilirsiniz:

1. Komut paletini açın ve "Cursor Settings" ifadesini arayın.
2. Tools & MCP altında New MCP Server'a tıklayın.
3. Açılan yapılandırma dosyasına Xata sunucusunu ekleyin:

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

4. Dosyayı kaydedin. Cursor kimlik doğrulaması yapmanı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ğrulaması için tarayıcıdaki yönergeleri izleyin.

OAuth yerine 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ı için GitHub Copilot ve GitHub Copilot Chat uzantıları gerekir.

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

Alternatif olarak, sunucuyu yapılandırmanıza elle ekleyin:

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

Sunucuyu MCP: List Servers üzerinden başlatın ve istendiğinde kimlik doğrulamasına izin verin.

Claude (web ve masaüstü)

[!TIP]

Xata bilgileri önceden doldurulmuş olarak Claude'un özel bağlayıcı iletişim kutusunu açın:

Xata'yı Claude'a bağla

Claude'da bağlayıcıyı inceleyip onaylayın, ardından Xata ile kimlik doğrulaması yapın.

Alternatif olarak, Xata'yı özel bağlayıcı olarak elle ekleyin:

1. Settings → Connectors bölümüne gidin.
2. Add custom connector'a tıklayın.
3. Sunucu URL'si olarak https://api.xata.tech/mcp girin ve Add'e tıklayın.
4. Xata hesabınızla oturum açmak için yönergeleri izleyin.

[!NOTE]

Uzak MCP kullanan özel bağlayıcılar tüm Claude planlarında kullanılamaz ve ekip planlarında bunları eklemek için kuruluş sahibinin yetkisi 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 Settings → Connectors → Advanced settings bölümüne gidin ve Developer mode'u etkinleştirin.
2. Connectors sekmesinde, sunucu URL'sini kullanarak yeni bir bağlayıcı oluşturun:

https://api.xata.tech/mcp

3. Kimlik doğrulama yöntemi olarak 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 Add sources 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

[!NOTE]

add komutu bir tarayıcı açıp OAuth hatası bildirebilir. Böyle bir durumda aşağıdaki oturum açma komutuyla devam edin; xata sunucu girdisi zaten kaydedilmiştir.

Açık OAuth kapsamlarını kullanarak Xata'da kimlik doğrulaması yapı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'i 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:

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

Xata'yı yalnızca tek bir proje için etkinleştirmek üzere, bunun yerine o projenin kök dizininde .agents/mcp_config.json kullanın.

agy'ı başlatın ve /mcp'i girin. MCP Manager'da xata için Authenticate'i kullanın ve OAuth'u tamamlamak için yönergeleri izleyin.

OpenCode

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

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

Ardından terminalinizden kimlik doğrulaması yapı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ğrulaması yapmanız istenir. 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, ardından ham yapılandırma dosyasını açmak için Configure'a tıklayın (~/.codeium/windsurf/mcp_config.json).
2. Xata sunucu girdisini ekleyin:

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

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

Zed

1. Settings → AI → MCP Servers bölümünü açıp Add Server → Add Remote Server'a tıklayın veya ayarlar dosyanızı doğrudan düzenleyin:

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

2. Zed, standart MCP OAuth akışını kullanarak sunucuda kimlik doğrulaması yapmanızı ister.

Cline

1. VS Code'da Cline'ı açın ve MCP Servers simgesine tıklayın.
2. Remote Servers sekmesinde ad olarak xata, URL olarak https://api.xata.tech/mcp girin ve aktarım yöntemi olarak Streamable HTTP'yi seçin. Ya da yapılandırma JSON'unu doğrudan düzenleyin:

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

[!NOTE]

Aktarım türü streamableHttp (camelCase) olmalıdır. Bu değerin belirtilmemesi, Cline'ın Xata MCP sunucusunun desteklemediği eski SSE aktarımına geri dönmesine neden olur.

Diğer MCP istemcileri

Aşağıdakileri destekleyen tüm MCP istemcileri bağlanabilir:

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

Uzak MCP sunucularını nerede yapılandıracağınızı öğrenmek 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 şunu sorun:

Dalları listelemeye yönelik REST API işlemini bulmak için Xata MCP sunucusunu kullan.

Asistan {"query":"list branches"} ile search_operations çağrısı yapmalı ve listBranches işlemini döndürmelidir. Bu işlem call_read_operation üzerinden çağrılabilir. Böyle olursa bağlantı çalışıyor demektir.

Kullanılabilir araçlar

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

Araç	Açıklama
search_operations	Amaca göre bir Xata REST API işlemi bulur (örneğin, "dalları listele" veya "üye davet et").
describe_operation	Belirli bir işlemin parametrelerini ve istek/yanıt şemalarını döndürür.
call_read_operation	Salt okunur bir Xata REST API işlemini çağırır.
call_write_operation	Veri oluşturan veya güncelleyen bir Xata REST API işlemini çağırır.
call_destructive_operation	Verileri silen veya erişimi iptal eden bir Xata REST API işlemini çağırır. confirm=true gerektirir.
run_sql	Bir dalda SQL çalıştırır. Varsayılan olarak salt okunurdur; verileri değiştiren ifadeler hem write=true hem de confirm=true gerektirir.
describe_schema	Bir dalın tablolarını ve sütunlarını listeler.
list_skills	Yaygın, çok adımlı görevler için rehberli iş akışları olan kullanılabilir Xata becerilerini listeler.
get_skill	Belirli bir becerinin yönergelerini okur.
search_xata	Xata belgelerinde arama yapar.
query_docs_filesystem_xata	Xata belge sayfalarını yola göre okur.

Güvenlik

• Etkileşimli istemcilerde OAuth'u tercih edin; belirteçlerin ömrü kısadır ve istemcinizde sunucunun bağlantısını keserek iptal edilebilir.
• Otomasyon için özel bir API anahtarı kullanın ve anahtarı düzenli olarak yenileyin.
• Bazı araçlar verilerinizi değiştirebilir: call_write_operation ve call_destructive_operation kaynakları değiştirebilir veya silebilir (ikincisi confirm=true gerektirir); run_sql ise hem write=true hem de confirm=true ile çağrıldığında verileri değiştirebilir. Onaylamadan önce asistanınızın önerdiği işlemleri inceleyin ve tüm yazma veya silme işlemlerinde bir insanın denetimini sağlayın.

Sorun giderme

Kimlik doğrulama sürekli başarısız oluyor veya döngüye giriyor. Xata sunucusunu istemcinizden kaldırın, istemciyi yeniden başlatın ve yeni bir OAuth akışı başlatmak için sunucuyu tekrar ekleyin.

Tarayıcıda kimlik doğrulama sırasında "Client not found" mesajı görünüyor. MCP istemcinizde, Xata'nın kimlik doğrulama sunucusunda artık bulunmayan kayıtlı bir OAuth kaydı olabilir. İstemciye bağlı olarak MCP sunucusunu kaldırıp yeniden eklemek bu kaydı silmeyebilir. İstemcinizde Xata için kaydedilmiş OAuth kaydını temizleyin, ardından yeni bir kayıt oluşturulmasını sağlamak için Xata MCP sunucusunu yeniden başlatıp tekrar kimlik doğrulaması yapın.

Örneğin, VS Code'da:

1. Komut Paleti'ni açın (Cmd+Shift+P / Ctrl+Shift+P).
2. Authentication: Remove Dynamic Authentication Providers komutunu çalıştırın.
3. Xata ile ilişkili sağlayıcıyı seçin; ilgisiz sağlayıcılara dokunmayın.
4. Xata MCP sunucusunu yeniden başlatın ve kimlik doğrulamasını tekrar tamamlayın.

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 ve araç listesini yenileyin. Tüm araçlar 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 destekleyen istemciler desteklenmez.

Sunucu istemcinizde görünmüyor. İstemcinin MCP yapılandırma dosyasının sözdizimini kontrol edin — JSON yapısı istemciler arasında farklılık gösterir (mcpServers ile servers ile context_servers, url ile serverUrl) — ve istemcinin günlüklerini inceleyin. Çoğu istemcide yapılandırma değişikliklerinden sonra istemciyi tamamen yeniden başlatmak gerekir.

Bu belgeler, geliştirici dokümantasyon platformu olan Mintlify ile oluşturulup barındırılmaktadır.