Xata MCP server

Server MCP

Hubungkan Cursor, Claude, VS Code, dan klien MCP lainnya ke Xata

Server MCP Xata memungkinkan asisten AI dan agen untuk berinteraksi dengan organisasi, proyek, dan cabang Xata Anda menggunakan Model Context Protocol (MCP).

Apa itu server MCP Xata?

• Server MCP yang di-hosting yang berjalan berdampingan dengan API Xata — tidak ada yang perlu diinstal atau dijalankan secara lokal.
• Diautentikasi melalui OAuth di browser Anda, atau dengan kunci API Xata untuk lingkungan headless.
• Dapat diakses dari klien MCP mana pun yang mendukung server jarak jauh melalui Streamable HTTP.

URL Server:

https://api.xata.tech/mcp

Server menggunakan transport Streamable HTTP. Tidak ada endpoint SSE dan tidak ada versi lokal (npm) dari server ini.

Autentikasi

Server MCP mendukung dua metode autentikasi:

Metode	Gunakan saat	Persyaratan klien
OAuth	Penggunaan interaktif di editor/chat	Dukungan untuk OAuth MCP (registrasi klien dinamis)
Kunci API	Otomatisasi, CI, agen headless	Dukungan untuk header HTTP kustom

OAuth

Dengan klien yang mendukung OAuth, Anda hanya memerlukan URL server. Saat klien Anda terhubung untuk pertama kalinya, klien akan mendaftarkan dirinya ke Xata, membuka jendela browser, dan meminta Anda untuk masuk ke akun Xata serta menyetujui akses. Token berumur pendek dan terbatas pada server MCP.

Kunci API

Klien yang mendukung header kustom dapat diautentikasi dengan kunci API Xata sebagai gantinya:

Authorization: Bearer YOUR_XATA_API_KEY

Peringatan

Buat kunci API khusus untuk akses MCP daripada menggunakan kembali kunci yang sudah ada. Simpan dalam variabel lingkungan atau penyimpanan rahasia klien Anda — jangan pernah mengirimkannya ke kontrol sumber.

Siapkan klien MCP Anda

Cursor

Tip

Cursor menawarkan tautan dalam untuk pengaturan OAuth cepat:

<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' }}>Tambahkan ke Cursor

Atau, Anda dapat menambahkannya secara manual:

1. Buka palet perintah dan cari "Cursor Settings".
2. Di bawah Tools & MCP, klik New MCP Server.
3. Tambahkan server Xata ke file konfigurasi yang terbuka:

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

4. Simpan file. Cursor akan meminta Anda untuk mengautentikasi — ikuti alur browser dan setujui akses ke akun Xata Anda.

Claude Code

Tambahkan server dari terminal Anda:

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

Kemudian mulai Claude Code dan jalankan perintah slash /mcp. Pilih server xata dan ikuti instruksi browser untuk mengautentikasi.

Untuk menggunakan kunci API alih-alih OAuth (misalnya, di CI):

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

VS Code

Server MCP di VS Code memerlukan ekstensi GitHub Copilot dan GitHub Copilot Chat.

1. Buka Palet Perintah (Cmd+Shift+P / Ctrl+Shift+P).
2. Jalankan MCP: Add Server dan pilih HTTP.
3. Masukkan https://api.xata.tech/mcp sebagai URL dan xata sebagai nama.

Atau, tambahkan ke konfigurasi Anda secara manual:

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

Mulai server dari MCP: List Servers dan izinkan untuk mengautentikasi saat diminta.

Claude (web dan desktop)

Tip

Buka dialog konektor kustom Claude dengan detail Xata yang sudah diisi sebelumnya:

<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' }}>Hubungkan Xata ke Claude

Tinjau dan konfirmasi konektor di Claude, lalu autentikasi dengan Xata.

Atau, tambahkan Xata sebagai konektor kustom secara manual:

1. Buka Settings → Connectors.
2. Klik Add custom connector.
3. Masukkan https://api.xata.tech/mcp sebagai URL server dan klik Add.
4. Ikuti petunjuk untuk masuk dengan akun Xata Anda.

Catatan

Konektor kustom yang menggunakan MCP jarak jauh tidak tersedia di semua paket Claude, dan mungkin memerlukan pemilik organisasi untuk menambahkannya di paket tim. Lihat dokumentasi Claude untuk detailnya.

ChatGPT

Hubungkan ChatGPT ke Xata menggunakan konektor kustom:

1. Di ChatGPT, buka Settings → Connectors → Advanced settings dan aktifkan Developer mode.
2. Di tab Connectors, buat konektor baru dengan URL server:

https://api.xata.tech/mcp

3. Pilih OAuth untuk autentikasi dan selesaikan alur otorisasi saat diminta.
4. Di setiap chat tempat Anda ingin menggunakan Xata, klik tombol + dan aktifkan konektor Xata di bawah Add sources.

Codex CLI

Tambahkan server Xata:

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

Catatan

Perintah add dapat membuka browser dan melaporkan kesalahan OAuth. Jika itu terjadi, lanjutkan dengan perintah login di bawah; entri server xata sudah disimpan.

Autentikasi dengan Xata menggunakan cakupan OAuth eksplisit:

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

Selesaikan otorisasi di browser. Cakupan offline_access memungkinkan Codex untuk menyegarkan sesi Xata-nya tanpa memerlukan otorisasi browser lagi.

Kemudian mulai codex, jalankan /mcp, dan verifikasi bahwa xata terhubung dan terautentikasi.

Antigravity CLI

Tambahkan Xata ke konfigurasi MCP global Anda:

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

Untuk mengaktifkan Xata hanya untuk satu proyek, gunakan .agents/mcp_config.json di root proyek tersebut sebagai gantinya.

Mulai agy dan masukkan /mcp. Di MCP Manager, gunakan Authenticate untuk xata dan ikuti petunjuk untuk menyelesaikan OAuth.

OpenCode

Tambahkan server Xata ke file konfigurasi OpenCode Anda:

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

Kemudian autentikasi dari terminal Anda:

opencode mcp auth xata

Amp

Tambahkan server dari terminal Anda:

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

Kemudian mulai amp — Anda akan diminta untuk mengautentikasi di browser. Jalankan /mcp list tools untuk mengonfirmasi bahwa server terhubung.

Windsurf

1. Di Windsurf, buka panel Cascade dan klik ikon MCP (palu), lalu Configure untuk membuka file konfigurasi mentah (~/.codeium/windsurf/mcp_config.json).
2. Tambahkan entri server Xata:

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

3. Simpan file dan klik Refresh di sidebar Cascade. Selesaikan alur OAuth saat jendela browser terbuka.

Zed

1. Buka Settings → AI → MCP Servers dan klik Add Server → Add Remote Server, atau edit file pengaturan Anda secara langsung:

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

2. Zed akan meminta Anda untuk mengautentikasi terhadap server menggunakan alur OAuth MCP standar.

Cline

1. Buka Cline di VS Code dan klik ikon MCP Servers.
2. Di tab Remote Servers, masukkan xata sebagai nama, https://api.xata.tech/mcp sebagai URL, dan pilih Streamable HTTP sebagai transport. Atau edit JSON konfigurasi secara langsung:

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

Catatan

Jenis transport harus streamableHttp (camelCase). Mengabaikannya menyebabkan Cline kembali ke transport SSE lama, yang tidak didukung oleh server MCP Xata.

Klien MCP lainnya

Klien MCP mana pun dapat terhubung jika mendukung:

• Server MCP jarak jauh melalui Streamable HTTP (bukan SSE)
• OAuth dengan registrasi klien dinamis, atau header HTTP kustom untuk autentikasi kunci API

Konsultasikan dokumentasi klien Anda untuk tempat mengonfigurasi server MCP jarak jauh, dan gunakan https://api.xata.tech/mcp sebagai URL.

Verifikasi koneksi

Setelah terhubung, tanyakan asisten Anda:

Gunakan server MCP Xata untuk menemukan operasi API REST untuk membuat daftar cabang.

Asisten harus memanggil search_operations dengan {"query":"list branches"} dan mengembalikan operasi listBranches, yang dapat dipanggil melalui call_read_operation. Jika berhasil, koneksi berfungsi.

Alat yang tersedia

Server MCP Xata mengekspos alat-alat berikut:

Alat	Deskripsi
search_operations	Temukan operasi API REST Xata berdasarkan niat (misalnya, "daftar cabang" atau "undang anggota").
describe_operation	Mengembalikan parameter dan skema permintaan/respons untuk operasi tertentu.
call_read_operation	Memanggil operasi API REST Xata hanya-baca.
call_write_operation	Memanggil operasi API REST Xata yang membuat atau memperbarui data.
call_destructive_operation	Memanggil operasi API REST Xata yang menghancurkan data atau mencabut akses. Memerlukan confirm=true.
run_sql	Menjalankan SQL terhadap cabang. Hanya-baca secara default; pernyataan yang mengubah data memerlukan write=true dan confirm=true.
describe_schema	Daftar tabel dan kolom dari sebuah cabang.
list_skills	Daftar keterampilan Xata yang tersedia — alur kerja terpandu untuk tugas multi-langkah umum.
get_skill	Baca instruksi untuk keterampilan tertentu.
search_xata	Cari dokumentasi Xata.
query_docs_filesystem_xata	Baca halaman dokumentasi Xata berdasarkan jalur.

Keamanan

• Utamakan OAuth untuk klien interaktif; token berumur pendek dan dapat dicabut dengan memutuskan server di klien Anda.
• Untuk otomatisasi, gunakan kunci API khusus dan rotasi secara teratur.
• Beberapa alat dapat mengubah data Anda: call_write_operation dan call_destructive_operation dapat mengubah atau menghapus sumber daya (yang terakhir memerlukan confirm=true), dan run_sql dapat mengubah data saat dipanggil dengan write=true dan confirm=true. Tinjau tindakan yang diusulkan asisten Anda sebelum menyetujuinya, dan libatkan manusia untuk setiap penulisan atau penghapusan.

Pemecahan masalah

Autentikasi terus gagal atau berulang. Hapus server Xata dari klien Anda, mulai ulang klien, dan tambahkan server lagi untuk memicu alur OAuth baru.

Server terhubung tetapi tidak ada alat yang muncul. Pastikan Anda menyelesaikan langkah autentikasi — sebagian besar alat memerlukan sesi yang valid sebelum muncul. Jalankan ulang alur autentikasi klien Anda, lalu segarkan daftar alatnya. Lihat Alat yang tersedia untuk daftar lengkap.

Klien Anda tidak dapat terhubung sama sekali. Konfirmasi bahwa URL persis https://api.xata.tech/mcp dan klien Anda mendukung Streamable HTTP. Klien khusus SSE tidak didukung.

Server tidak muncul di klien Anda. Periksa sintaks file konfigurasi MCP klien — bentuk JSON berbeda antar klien (mcpServers vs servers vs context_servers, url vs serverUrl) — dan periksa log klien. Sebagian besar klien memerlukan mulai ulang penuh setelah perubahan konfigurasi.