Xata MCP server

Lewati ke konten utama

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

​Apa itu server MCP Xata?

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

URL Server:

https://api.xata.tech/mcp

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

​Autentikasi

Server MCP mendukung dua metode autentikasi:

Metode	Gunakan saat	Persyaratan klien
OAuth	Penggunaan interaktif di editor/chat	Dukungan untuk MCP OAuth (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 peramban, dan meminta Anda untuk masuk ke akun Xata dan menyetujui akses. Token bersifat jangka pendek dan dibatasi untuk server MCP.

​Kunci API

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

Authorization: Bearer YOUR_XATA_API_KEY

Buat kunci API khusus untuk akses MCP daripada menggunakan kembali kunci yang sudah ada. Simpan di variabel lingkungan atau penyimpanan rahasia klien Anda — jangan pernah commit ke source control.

​Siapkan klien MCP Anda

​Cursor

Cursor menawarkan deep link untuk pengaturan OAuth cepat:Tambahkan ke Cursor

Atau, Anda dapat menambahkannya secara manual:

1. Buka command palette dan cari “Cursor Settings”.
2. Di bawah Tools & MCP, klik New MCP Server.
3. Tambahkan server Xata ke file konfigurasi yang terbuka:

.cursor/mcp.json

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

4. Simpan file. Cursor akan meminta Anda untuk mengautentikasi — ikuti alur peramban 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 peramban 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 Command Palette (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:

.vscode/mcp.json

{
  "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)

Tambahkan Xata sebagai konektor kustom:

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.

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 di mana 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

Perintah add mungkin membuka peramban 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 peramban. Cakupan offline_access memungkinkan Codex untuk menyegarkan sesi Xata-nya tanpa memerlukan otorisasi peramban lain. Kemudian mulai codex, jalankan /mcp, dan verifikasi bahwa xata terhubung dan terautentikasi.

​Antigravity CLI

Tambahkan Xata ke konfigurasi MCP global Anda:

~/.gemini/config/mcp_config.json

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

Untuk mengaktifkan Xata hanya untuk satu proyek, gunakan .agents/mcp_config.json di root proyek tersebut. 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:

~/.config/opencode/opencode.json

{
  "$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 peramban. Jalankan /mcp list tools untuk mengonfirmasi 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:

~/.codeium/windsurf/mcp_config.json

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

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

​Zed

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

settings.json

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

2. Zed 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"
    }
  }
}

Tipe transport harus streamableHttp (camelCase). Menghilangkannya menyebabkan Cline jatuh kembali ke transport SSE lawas, yang tidak didukung oleh server MCP Xata.

​Klien MCP lainnya

Klien MCP mana pun dapat terhubung jika mendukung:

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

Lihat 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 memberi tahu saya sebagai siapa saya terautentikasi.

Asisten harus memanggil alat user_info dan mengembalikan identitas pengguna Anda (atau identitas kunci API, jika Anda mengautentikasi dengan kunci). Jika ya, koneksi berfungsi.

​Alat yang tersedia

Server MCP Xata menyediakan alat-alat berikut:

Alat	Deskripsi
user_info	Mengembalikan identitas pemanggil yang terautentikasi — ID pengguna dan email Anda untuk OAuth, atau ID kunci API.
search_operations	Temukan operasi REST API Xata berdasarkan intent (misalnya, “list branches” atau “invite member”).
describe_operation	Mengembalikan parameter dan skema permintaan/respons untuk operasi tertentu.
call_read_operation	Panggil operasi REST API Xata hanya-baca.
call_write_operation	Panggil operasi REST API Xata yang membuat atau memperbarui data.
call_destructive_operation	Panggil operasi REST API Xata yang menghancurkan data atau mencabut akses. Memerlukan confirm=true.
run_sql	Jalankan SQL terhadap cabang. Hanya-baca secara default; berikan write=true untuk menjalankan pernyataan yang mengubah data.
describe_schema	Tampilkan tabel dan kolom dari suatu cabang.
list_skills	Tampilkan 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 bersifat jangka pendek dan dapat dicabut dengan memutuskan server di klien Anda.
• Untuk otomatisasi, gunakan kunci API khusus dan rotasi secara berkala.
• 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. Tinjau tindakan yang diusulkan asisten Anda sebelum menyetujuinya, dan pertahankan manusia dalam lingkaran 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 kembali alur autentikasi klien Anda, lalu segarkan daftar alatnya. Lihat Alat yang tersedia untuk set lengkapnya. Klien Anda tidak dapat terhubung sama sekali. Konfirmasi URL tepat https://api.xata.tech/mcp dan klien Anda mendukung HTTP Streamable. 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.

Apakah halaman ini membantu?

Sebelumnya

Organisasi

Berikutnya