Xata MCP server

resmi

Server MCP Xata memungkinkan asisten dan agen AI untuk berinteraksi dengan organisasi, proyek, dan cabang database Postgres Xata Anda.

Lihat di xata.io

Apa yang bisa Anda lakukan dengan Xata MCP?

Temukan operasi API — Minta asisten Anda untuk menemukan operasi Xata REST API berdasarkan maksud, seperti menampilkan daftar branch atau mengundang anggota.
Periksa skema operasi — Dapatkan parameter dan skema request/response untuk operasi Xata API tertentu sebelum memanggilnya.
Jalankan panggilan API baca-saja — Panggil operasi Xata REST API baca-saja, seperti menampilkan daftar branch, melalui asisten Anda.
Kueri branch dengan SQL — Jalankan SQL terhadap sebuah branch, secara default baca-saja, dengan operasi tulis memerlukan konfirmasi eksplisit.
Jelajahi skema branch — Tampilkan daftar tabel dan kolom sebuah branch untuk memahami strukturnya.
Cari dokumentasi Xata — Cari dokumentasi Xata atau baca halaman dokumentasi tertentu berdasarkan path.

Dokumentasi

Server MCP

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

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

Apa itu server Xata MCP?

Server MCP terkelola yang berjalan bersama Xata API — tidak ada yang perlu dipasang 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 ini 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 MCP OAuth (pendaftaran klien dinamis)
Kunci API	Otomasi, 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 tersebut mendaftarkan dirinya ke Xata, membuka jendela browser, dan meminta Anda untuk masuk ke akun Xata Anda dan menyetujui akses. Token berumur pendek dan dibatasi cakupannya untuk server MCP.

Kunci API

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

Authorization: Bearer YOUR_XATA_API_KEY

[!WARNING]

Buat kunci API khusus untuk akses MCP alih-alih menggunakan kembali kunci yang sudah ada. Simpan di variabel lingkungan atau penyimpanan rahasia klien Anda — jangan pernah melakukan commit ke kontrol sumber.

Siapkan klien MCP Anda

Cursor

[!TIP]

Cursor menawarkan tautan langsung untuk penyiapan OAuth cepat:

Tambahkan ke Cursor

Sebagai alternatif, Anda dapat menambahkannya secara manual:

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

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

Simpan file. Cursor akan meminta Anda untuk melakukan autentikasi — 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 melakukan autentikasi.

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.

Buka Command Palette (Cmd+Shift+P / Ctrl+Shift+P).
Jalankan MCP: Add Server dan pilih HTTP.
Masukkan https://api.xata.tech/mcp sebagai URL dan xata sebagai nama.

Sebagai alternatif, tambahkan ke konfigurasi Anda secara manual:

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

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

Claude (web dan desktop)

[!TIP]

Buka dialog konektor kustom Claude dengan detail Xata yang sudah terisi:

Hubungkan Xata ke Claude

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

Sebagai alternatif, tambahkan Xata sebagai konektor kustom secara manual:

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

[!NOTE]

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

ChatGPT

Hubungkan ChatGPT ke Xata menggunakan konektor kustom:

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

https://api.xata.tech/mcp

Pilih OAuth untuk autentikasi dan selesaikan alur otorisasi saat diminta.
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

[!NOTE]

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

Lakukan 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 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 lakukan 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 melakukan autentikasi di browser. Jalankan /mcp list tools untuk memastikan server terhubung.

Windsurf

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

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

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

Zed

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"
    }
  }
}

Zed akan meminta Anda untuk melakukan autentikasi terhadap server menggunakan alur OAuth MCP standar.

Cline

Buka Cline di VS Code dan klik ikon MCP Servers.
Pada 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"
    }
  }
}

[!NOTE]

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

Klien MCP lainnya

Klien MCP mana pun dapat terhubung jika mendukung:

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

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

Verifikasi koneksi

Setelah terhubung, tanyakan kepada asisten Anda:

Gunakan server Xata MCP untuk menemukan operasi REST API untuk menampilkan daftar branch.

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

Alat yang tersedia

Server Xata MCP menyediakan alat berikut:

Alat	Deskripsi
`search_operations`	Menemukan operasi REST API Xata berdasarkan maksud (misalnya, "list branches" atau "invite member").
`describe_operation`	Mengembalikan parameter dan skema permintaan/respons untuk operasi tertentu.
`call_read_operation`	Memanggil operasi REST API Xata yang hanya-baca.
`call_write_operation`	Memanggil operasi REST API Xata yang membuat atau memperbarui data.
`call_destructive_operation`	Memanggil operasi REST API Xata yang menghapus data atau mencabut akses. Memerlukan `confirm=true`.
`run_sql`	Menjalankan SQL terhadap sebuah branch. Hanya-baca secara default; pernyataan yang mengubah data memerlukan `write=true` dan `confirm=true`.
`describe_schema`	Menampilkan daftar tabel dan kolom sebuah branch.
`list_skills`	Menampilkan daftar skill Xata yang tersedia — alur kerja terpandu untuk tugas multi-langkah yang umum.
`get_skill`	Membaca instruksi untuk skill tertentu.
`search_xata`	Mencari di dokumentasi Xata.
`query_docs_filesystem_xata`	Membaca halaman dokumentasi Xata berdasarkan path.

Keamanan

Utamakan OAuth untuk klien interaktif; token berumur pendek dan dapat dicabut dengan memutuskan server di klien Anda.
Untuk otomasi, gunakan kunci API khusus dan rotasikan 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 dan confirm=true. Tinjau tindakan yang diusulkan asisten Anda sebelum menyetujuinya, dan pastikan ada manusia dalam alur untuk setiap operasi tulis atau hapus.

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.

Autentikasi menampilkan "Client not found" di browser. Klien MCP Anda mungkin memiliki pendaftaran OAuth tersimpan yang tidak lagi tersedia di server autentikasi Xata. Bergantung pada kliennya, menghapus dan menambahkan kembali server MCP mungkin membiarkan pendaftaran ini tetap utuh. Hapus pendaftaran OAuth tersimpan untuk Xata di klien Anda, lalu mulai ulang server Xata MCP dan lakukan autentikasi lagi untuk memungkinkan pendaftaran baru.

Sebagai contoh, di VS Code:

Buka Command Palette (Cmd+Shift+P / Ctrl+Shift+P).
Jalankan Authentication: Remove Dynamic Authentication Providers.
Pilih penyedia yang terkait dengan Xata, biarkan penyedia lain yang tidak terkait tidak berubah.
Mulai ulang server Xata MCP dan selesaikan autentikasi lagi.

Server terhubung tetapi tidak ada alat yang muncul. Pastikan Anda telah 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 kumpulan lengkapnya.

Klien Anda tidak dapat terhubung sama sekali. Pastikan URL-nya tepat https://api.xata.tech/mcp dan klien Anda mendukung Streamable HTTP. Klien yang hanya mendukung 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.

Dokumentasi ini dibuat dan dihosting di Mintlify, sebuah platform dokumentasi untuk developer.