Baserow

Baserow MCP

Hubungkan agen AI Anda ke Baserow. Agen Anda dapat membaca dan mengubah tabel di satu ruang kerja Baserow, hanya menggunakan alat yang Anda izinkan saat masuk.

Repositori ini menginstal server MCP Baserow dan keterampilan singkat yang mengajarkan agen cara menggunakannya. Ini berfungsi dengan Claude, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, OpenCode, Zed, Goose, Windsurf, Pi, dan agen lainnya.

URL Server

• baserow.io: https://api.baserow.io/mcp
• Self-hosted: URL backend Anda diikuti oleh /mcp, misalnya https://baserow.example.com/mcp. Salin dari Pengaturan saya → Server MCP di Baserow.

Contoh di bawah menggunakan URL baserow.io. Pada Baserow self-hosted, gunakan URL Anda sendiri sebagai gantinya.

Mulai Cepat

npx add-mcp https://api.baserow.io/mcp -n baserow -g
npx skills add baserow/baserow-mcp

add-mcp menemukan agen yang telah Anda instal dan menanyakan agen mana yang akan ditambahkan Baserow. Hapus centang Claude Desktop jika terdaftar dan tambahkan Baserow di sana sebagai konektor khusus sebagai gantinya. skills add menyalin keterampilan baserow-basics ke folder keterampilan agen Anda. Pada Baserow self-hosted, jalankan juga skills add, karena hanya plugin di bawah yang menyertakan keterampilan tersebut.

Persyaratan Self-hosted

• Versi Baserow yang lebih baru dari 2.4.1. Versi lama tidak memiliki /mcp atau masuk; gunakan kunci endpoint di sana.
• BASEROW_MCP_OAUTH_ENABLED=true di backend. Ini nonaktif secara default.
• URL backend HTTPS publik, sehingga aplikasi yang dihosting seperti Claude.ai dan ChatGPT dapat menjangkaunya, dan HTTPS keluar dari backend, yang mengambil metadata klien aplikasi.
• Proksi balik Anda mengirim /mcp dan jalur di bawah /mcp/, /oauth/, /.well-known/oauth-authorization-server, dan /.well-known/oauth-protected-resource ke backend. Cocokkan /mcp dengan tepat, bukan sebagai awalan: frontend menyajikan halaman masuk di /mcp-authorize/.

Lihat Masuk OAuth MCP untuk Baserow self-hosted.

Instal per Agen

Agen	baserow.io	Self-hosted
Claude Code	Plugin	Plugin yang sama, masukkan URL Anda saat diminta
Claude.ai, Claude Desktop	Konektor khusus	Sama, dengan URL Anda
ChatGPT	Server MCP khusus	Sama, dengan URL Anda
Codex	Plugin	codex mcp add baserow --url <your url>
GitHub Copilot CLI	Plugin	Server saja
Gemini CLI	gemini extensions install https://github.com/baserow/baserow-mcp	gemini mcp add -s user -t http baserow <your url>
Cursor	Tambahkan ke Cursor	File konfigurasi
VS Code	Tambahkan ke VS Code	File konfigurasi
Goose	Tambahkan ke Goose	Mulai cepat dengan URL Anda
OpenCode, Windsurf, Zed	File konfigurasi	Sama, dengan URL Anda
Agen lainnya	Mulai cepat	Sama, dengan URL Anda

Plugin Codex, Copilot, dan Gemini serta tombol Tambahkan selalu mengarah ke baserow.io, jadi pada Baserow self-hosted, tambahkan hanya server untuk agen tersebut.

Claude Code

/plugin marketplace add baserow/baserow-mcp
/plugin install baserow@baserow

Saat diminta URL, tekan Esc untuk tetap menggunakan baserow.io, atau masukkan URL self-hosted Anda. Untuk mengubahnya nanti, jalankan /plugin configure baserow@baserow.

Claude.ai dan Claude Desktop

Kustomisasi → Konektor → + Tambah → Tambahkan konektor khusus. Beri nama Baserow dan masukkan URL server Anda. Pada paket Tim dan Perusahaan, pemilik menambahkannya di bawah Pengaturan organisasi → Konektor.

ChatGPT

Buka Plugin, pilih tombol plus, lalu Tambahkan server MCP khusus, dan masukkan URL server Anda. Nama menu sering berubah. Pada paket Bisnis dan Perusahaan, admin harus mengizinkan server MCP khusus terlebih dahulu.

Codex

codex plugin marketplace add baserow/baserow-mcp
codex plugin add baserow@baserow
codex mcp login baserow

GitHub Copilot CLI

copilot plugin marketplace add baserow/baserow-mcp
copilot plugin install baserow@baserow

Pada Baserow self-hosted, tambahkan hanya server: copilot mcp add --transport http baserow <your url>. Jika plugin terinstal, hapus instalan terlebih dahulu dengan copilot plugin uninstall baserow; server-nya menggantikan milik Anda tanpa peringatan.

File Konfigurasi

Untuk menambahkan hanya server, tanpa plugin:

• Cursor, ~/.cursor/mcp.json:

  { "mcpServers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }
  

• VS Code, .vscode/mcp.json:

  { "servers": { "baserow": { "type": "http", "url": "https://api.baserow.io/mcp" } } }
  

• OpenCode, opencode.json, lalu opencode mcp auth baserow:

  { "mcp": { "baserow": { "type": "remote", "url": "https://api.baserow.io/mcp" } } }
  

• Windsurf, ~/.codeium/windsurf/mcp_config.json:

  { "mcpServers": { "baserow": { "serverUrl": "https://api.baserow.io/mcp" } } }
  

• Zed, pengaturan:

  { "context_servers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }
  

Masuk

Agen Anda membuka halaman Baserow di browser Anda. Masuk, pilih ruang kerja, dan centang alat yang boleh digunakan agen. Alat baca memungkinkan agen menjelajahi database, tabel, dan baris; alat tulis memungkinkannya membuat, memperbarui, dan menghapus baris. Hanya alat baca yang dicentang pada koneksi pertama.

Tempat masuk dimulai:

• Claude Code: jalankan /mcp, pilih plugin:baserow:baserow, dan autentikasi.
• Codex: codex mcp login baserow.
• Gemini CLI: /mcp auth baserow.
• Claude.ai, ChatGPT, Cursor, dan VS Code: tombol Hubungkan atau Masuk di samping server.

Untuk mengubah ruang kerja atau alat, masuk lagi: autentikasi ulang server di agen Anda, atau putuskan aplikasi di bawah Pengaturan saya → Server MCP di Baserow dan sambungkan lagi. Sambungan ulang biasa mempertahankan masuk lama.

Pemecahan Masalah

• Alat hilang, atau tidak ada database yang terdaftar. Koneksi hanya memiliki ruang kerja dan alat yang Anda pilih saat masuk. Masuk lagi seperti dijelaskan di atas. Alat yang mengubah tabel atau bidang tidak tersedia melalui MCP.
• Masuk tidak pernah dimulai, atau klien mengatakan server tidak mendukung OAuth atau pendaftaran klien. Pada Baserow self-hosted, periksa persyaratan self-hosted.
• Koneksi gagal dengan URL yang Anda ketik. Salin URL persis seperti yang ditampilkan Pengaturan saya → Server MCP. Ini diakhiri dengan /mcp, tanpa garis miring di akhir.
• Dua server Baserow di Claude Code. Jika claude mcp list menampilkan plugin:baserow:baserow plugin dan server baserow yang Anda tambahkan secara manual, pertahankan yang terhubung. claude plugin disable baserow@baserow mematikan milik plugin; claude mcp remove baserow menghapus milik Anda.

Kunci Endpoint

Baserow 2.4.1 dan yang lebih lama hanya menerima kunci endpoint, dan plugin tidak mengatur ini. Salin URL endpoint dari Pengaturan saya → Server MCP. Ini diakhiri dengan /sse dan berisi kunci Anda. Tambahkan secara manual ke agen yang mendukung server SSE, seperti Claude Code, Cursor, atau VS Code; Codex dan Goose tidak:

npx add-mcp "<endpoint url>" -t sse -n baserow -g -a claude-code

Versi yang lebih baru juga menerima kunci sebagai header pada /mcp, yang berguna untuk skrip:

npx add-mcp https://baserow.example.com/mcp -n baserow -g -a claude-code -h "Authorization: Bearer <key>"

Kunci memberikan akses penuh ke ruang kerjanya. -g menulisnya ke konfigurasi pengguna Anda alih-alih folder saat ini, sehingga tidak dapat berakhir di commit.

Privasi dan Dukungan

• Kebijakan privasi: https://baserow.io/privacy-policy
• Ketentuan: https://baserow.io/terms-and-conditions
• Bantuan: forum komunitas atau hubungi kami

Pengembangan

Di scripts/, jalankan npm install, lalu npm test dan npm run check. CI menjalankan pemeriksaan yang sama. Perkakas berada di sana sehingga instalasi plugin tidak menginstal dependensinya.

Plugin Claude Code mendeklarasikan server-nya di .claude-plugin/plugin.json, sehingga dapat menggunakan URL yang Anda masukkan. .mcp.json menyimpan URL baserow.io untuk alat lain yang membaca plugin format Claude, seperti GitHub Copilot CLI dan Cursor.

Lisensi

MIT