Baserow

Baserow MCP

AI ajanınızı Baserow ile bağlayın. Ajanınız, oturum açarken izin verdiğiniz araçları kullanarak bir Baserow çalışma alanındaki tabloları okuyabilir ve değiştirebilir.

Bu depo, Baserow'un MCP sunucusunu ve ajanın onu nasıl kullanacağını öğreten kısa bir beceriyi kurar. Claude, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, OpenCode, Zed, Goose, Windsurf, Pi ve diğer ajanlarla çalışır.

Sunucu URL'si

• baserow.io: https://api.baserow.io/mcp
• Kendi sunucunuz: arka uç URL'nizin ardından /mcp gelir, örneğin https://baserow.example.com/mcp. Bunu Baserow'da Ayarlarım → MCP sunucusu bölümünden kopyalayın.

Aşağıdaki örnekler baserow.io URL'sini kullanır. Kendi sunucunuzda Baserow kullanıyorsanız, kendi URL'nizi kullanın.

Hızlı başlangıç

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

add-mcp, kurulu ajanlarınızı bulur ve hangilerine Baserow eklemek istediğinizi sorar. Claude Desktop listeleniyorsa işaretini kaldırın ve Baserow'u oraya özel bağlayıcı olarak ekleyin. skills add, baserow-basics becerisini ajanlarınızın beceri klasörlerine kopyalar. Kendi sunucunuzda Baserow kullanıyorsanız, skills add komutunu da çalıştırın, çünkü beceri yalnızca aşağıdaki eklentilere dahildir.

Kendi sunucunuz için gereksinimler

• 2.4.1'den daha yeni bir Baserow sürümü. Eski sürümlerde /mcp veya oturum açma yoktur; orada bir uç nokta anahtarı kullanın.
• Arka uçta BASEROW_MCP_OAUTH_ENABLED=true etkin olmalıdır. Varsayılan olarak kapalıdır.
• Genel bir HTTPS arka uç URL'si, böylece Claude.ai ve ChatGPT gibi barındırılan uygulamalar ona ulaşabilir ve arka uçtan uygulamaların istemci meta verilerini getiren giden HTTPS bağlantısı.
• Ters proxy'niz /mcp ve /mcp/, /oauth/, /.well-known/oauth-authorization-server ve /.well-known/oauth-protected-resource altındaki yolları arka uca iletir. /mcp ile tam olarak eşleşmelidir, önek olarak değil: ön uç, oturum açma sayfasını /mcp-authorize/ adresinde sunar.

Kendi sunucunuzda Baserow için MCP OAuth oturum açma bölümüne bakın.

Ajan başına kurulum

Ajan	baserow.io	Kendi sunucunuz
Claude Code	Eklenti	Aynı eklenti, sorulduğunda URL'nizi girin
Claude.ai, Claude Desktop	Özel bağlayıcı	Aynı, URL'nizle
ChatGPT	Özel MCP sunucusu	Aynı, URL'nizle
Codex	Eklenti	codex mcp add baserow --url <your url>
GitHub Copilot CLI	Eklenti	Yalnızca sunucu
Gemini CLI	gemini extensions install https://github.com/baserow/baserow-mcp	gemini mcp add -s user -t http baserow <your url>
Cursor	Cursor'a ekle	Yapılandırma dosyası
VS Code	VS Code'a ekle	Yapılandırma dosyası
Goose	Goose'a ekle	Hızlı başlangıç URL'nizle
OpenCode, Windsurf, Zed	Yapılandırma dosyası	Aynı, URL'nizle
Diğer herhangi bir ajan	Hızlı başlangıç	Aynı, URL'nizle

Codex, Copilot ve Gemini eklentileri ve "Ekle" düğmeleri her zaman baserow.io'yu işaret eder, bu nedenle kendi sunucunuzda Baserow kullanıyorsanız bu ajanlar için yalnızca sunucuyu ekleyin.

Claude Code

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

URL sorulduğunda baserow.io'yu korumak için Esc tuşuna basın veya kendi sunucunuzun URL'sini girin. Daha sonra değiştirmek için /plugin configure baserow@baserow komutunu çalıştırın.

Claude.ai ve Claude Desktop

Özelleştir → Bağlayıcılar → + Ekle → Özel bağlayıcı ekle. Adını Baserow yapın ve sunucu URL'nizi girin. Team ve Enterprise planlarında bir sahip, Kuruluş ayarları → Bağlayıcılar altında ekler.

ChatGPT

Eklentiler'i açın, artı düğmesini seçin, ardından Özel MCP sunucusu ekle'yi seçin ve sunucu URL'nizi girin. Menü adları sık sık değişir. Business ve Enterprise planlarında bir yöneticinin önce özel MCP sunucularına izin vermesi gerekir.

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

Kendi sunucunuzda Baserow kullanıyorsanız, yalnızca sunucuyu ekleyin: copilot mcp add --transport http baserow <your url>. Eklenti kuruluysa, önce copilot plugin uninstall baserow ile kaldırın; eklentinin sunucusu sizinkini uyarı vermeden değiştirir.

Yapılandırma dosyaları

Eklenti olmadan yalnızca sunucuyu eklemek için:

• 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, ardından 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, ayarlar:

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

Oturum açma

Ajanınız tarayıcınızda bir Baserow sayfası açar. Oturum açın, çalışma alanını seçin ve ajanın kullanabileceği araçları işaretleyin. Okuma araçları, ajanın veritabanlarını, tabloları ve satırları incelemesine izin verir; yazma araçları, satır oluşturmasına, güncellemesine ve silmesine izin verir. İlk bağlantıda yalnızca okuma araçları işaretlenir.

Oturum açmanın başladığı yer:

• Claude Code: /mcp komutunu çalıştırın, plugin:baserow:baserow seçin ve kimlik doğrulayın.
• Codex: codex mcp login baserow.
• Gemini CLI: /mcp auth baserow.
• Claude.ai, ChatGPT, Cursor ve VS Code: sunucunun yanındaki Bağlan veya Oturum aç düğmesi.

Çalışma alanını veya araçları değiştirmek için tekrar oturum açın: ajanınızda sunucunun kimliğini yeniden doğrulayın veya Baserow'da Ayarlarım → MCP sunucusu altındaki uygulamanın bağlantısını kesin ve yeniden bağlanın. Düz bir yeniden bağlantı eski oturum açmayı korur.

Sorun giderme

• Bir araç eksik veya veritabanı listelenmiyor. Bağlantı yalnızca oturum açarken seçtiğiniz çalışma alanına ve araçlara sahiptir. Yukarıda açıklandığı gibi tekrar oturum açın. Tabloları veya alanları değiştiren araçlar MCP üzerinden kullanılamaz.
• Oturum açma hiç başlamıyor veya istemci sunucunun OAuth veya istemci kaydını desteklemediğini söylüyor. Kendi sunucunuzda Baserow kullanıyorsanız, kendi sunucunuz için gereksinimler bölümünü kontrol edin.
• Yazdığınız bir URL ile bağlantı başarısız oluyor. URL'yi Ayarlarım → MCP sunucusu bölümünün gösterdiği gibi tam olarak kopyalayın. /mcp ile biter, sondaki eğik çizgi olmadan.
• Claude Code'da iki Baserow sunucusu. claude mcp list, eklentinin plugin:baserow:baserow ve elle eklediğiniz bir baserow sunucusunu gösteriyorsa, bağlananı koruyun. claude plugin disable baserow@baserow eklentinin sunucusunu kapatır; claude mcp remove baserow sizinkini kaldırır.

Uç nokta anahtarları

Baserow 2.4.1 ve daha eski sürümler yalnızca bir uç nokta anahtarı kabul eder ve eklenti bunu ayarlamaz. Uç nokta URL'sini Ayarlarım → MCP sunucusu bölümünden kopyalayın. /sse ile biter ve anahtarınızı içerir. SSE sunucularını destekleyen bir ajana elle ekleyin, örneğin Claude Code, Cursor veya VS Code; Codex ve Goose desteklemez:

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

Daha yeni sürümler ayrıca anahtarı /mcp üzerinde bir başlık olarak kabul eder, bu da komut dosyaları için kullanışlıdır:

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

Anahtar, çalışma alanına tam erişim sağlar. -g onu geçerli klasör yerine kullanıcı yapılandırmanıza yazar, böylece bir taahhüde dahil edilemez.

Gizlilik ve destek

• Gizlilik politikası: https://baserow.io/privacy-policy
• Şartlar: https://baserow.io/terms-and-conditions
• Yardım: topluluk forumu veya bize ulaşın

Geliştirme

scripts/ içinde npm install komutunu, ardından npm test ve npm run check komutlarını çalıştırın. CI aynı kontrolleri çalıştırır. Araçlar orada bulunur, böylece eklenti kurulumları bağımlılıklarını kurmaz.

Claude Code eklentisi sunucusunu .claude-plugin/plugin.json içinde bildirir, böylece girdiğiniz URL'yi kullanabilir. .mcp.json, GitHub Copilot CLI ve Cursor gibi Claude formatındaki eklentileri okuyan diğer araçlar için baserow.io URL'sini tutar.

Lisans

MIT