Xata MCP server

MCP Sunucusu

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

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'si ile birlikte çalışan barındırılan bir MCP sunucusudur — yerel olarak kurulacak veya çalıştırılacak bir şey yoktur.
• Tarayıcıda OAuth veya başsız ortamlar için Xata API anahtarı ile 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. Token'lar 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ğrulaması yapabilir:

Authorization: Bearer YOUR_XATA_API_KEY

Uyarı

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 göndermeyin.

MCP istemcinizi ayarlayın

Cursor

İpucu

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

<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=xata&config=eyJ1cmwiOiJodHRwczovL2FwaS54YXRhLnRlY2gvbWNwIn0%3D" style={{ display: 'inline-flex', alignItems: 'center', gap: '8px', padding: '8px 12px', backgroundColor: '#111111', color: '#ffffff', borderRadius: '6px', fontWeight: '500', textDecoration: 'none', marginTop: '8px', marginBottom: '16px' }}>

<span style={{ color: '#ffffff' }}>Cursor'a Ekle

Alternatif olarak, manuel olarak ekleyebilirsiniz:

1. Komut paletini açın ve "Cursor Settings" ifadesini arayın.
2. Tools & MCP altında, New MCP Server seçeneğine 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 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: Add Server komutunu çalıştırın ve HTTP seçeneğini seçin.
3. URL olarak https://api.xata.tech/mcp ve ad olarak xata girin.

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

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

Sunucuyu MCP: List Servers bölümünden başlatın ve istendiğinde kimlik doğrulamasına izin verin.

Claude (web ve masaüstü)

İpucu

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

<a href="https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Xata&connectorUrl=https%3A%2F%2Fapi.xata.tech%2Fmcp" style={{ display: 'inline-flex', alignItems: 'center', padding: '8px 12px', backgroundColor: '#735adc', color: '#ffffff', borderRadius: '6px', fontWeight: '500', textDecoration: 'none', marginTop: '8px', marginBottom: '16px' }}> <span style={{ color: '#ffffff' }}>Xata'yı Claude'a Bağlayın

Claude'da bağlayıcıyı inceleyin ve onaylayın, ardından Xata ile kimlik doğrulayın.

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

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

Not

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

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

1. ChatGPT'de Settings → Connectors → Advanced settings bölümüne gidin ve Developer mode seçeneğini etkinleştirin.
2. Connectors sekmesinde, sunucu URL'si ile yeni bir bağlayıcı oluşturun:

https://api.xata.tech/mcp

3. Kimlik doğrulama için OAuth seçeneğini 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

Not

add komutu bir tarayıcı açabilir ve bir OAuth hatası bildirebilir. Bu olursa, aşağıdaki oturum açma 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 başlatın, /mcp çalıştırın ve xata öğesinin 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 bir proje için etkinleştirmek üzere, o projenin kök dizininde .agents/mcp_config.json kullanın.

agy başlatın ve /mcp girin. MCP Yöneticisinde, xata için Authenticate seçeneğini kullanın ve OAuth'u tamamlamak için istemleri 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ğ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 Configure seçeneğine tıklayın (~/.codeium/windsurf/mcp_config.json).
2. Xata sunucu girişini ekleyin:

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

3. Dosyayı kaydedin ve Cascade kenar çubuğunda Refresh seçeneğine 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çın ve Add Server → Add Remote Server seçeneğine 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 sunucuya karşı kimlik doğrulamanı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 taşıma protokolü olarak Streamable HTTP seçeneğini seçin. Veya yapılandırma JSON'unu doğrudan düzenleyin:

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

Not

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

Aşağıdakileri destekliyorsa herhangi bir MCP istemcisi bağlanabilir:

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

Uzak MCP sunucularını nereye 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:

Dalları listeleme REST API işlemini bulmak için Xata MCP sunucusunu kullanın.

Asistan, search_operations öğesini {"query":"list branches"} ile çağırmalı ve call_read_operation üzerinden çağrılabilen listBranches işlemini 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
search_operations	Amaca 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ün.
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 ifadeler hem write=true hem de confirm=true gerektirir.
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 belge sayfalarını yola göre okuyun.

Güvenlik

• Etkileşimli istemciler için OAuth'u tercih edin; token'lar 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 değiştirin.
• 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, hem write=true hem de confirm=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 bir insanı süreçte tutun.

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ışı 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 liste için Kullanılabilir araçlara bakın.

İstemciniz hiç bağlanamıyor. URL'nin tam olarak https://api.xata.tech/mcp olduğunu ve istemcinizin Streamable HTTP desteklediğini doğrulayın. Yalnızca SSE destekleyen istemciler desteklenmez.

Sunucu istemcinizde görünmüyor. İstemcinin MCP yapılandırma dosyası sözdizimini kontrol edin — JSON yapısı 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.