Baserow

Baserow MCP

AI エージェントを Baserow に接続します。サインイン時に許可したツールだけを使って、エージェントが1つの Baserow ワークスペース内のテーブルを読み取り、変更できます。

このリポジトリは、Baserow の MCP サーバーと、エージェントに使い方を教える短いスキルをインストールします。Claude、ChatGPT、Codex、Cursor、VS Code、GitHub Copilot、Gemini CLI、OpenCode、Zed、Goose、Windsurf、Pi などのエージェントで利用できます。

サーバー URL

• baserow.io：https://api.baserow.io/mcp
• セルフホスト：バックエンドの URL の末尾に /mcp を付けます。例：https://baserow.example.com/mcp。Baserow の My settings → MCP server からコピーしてください。

以下の例では baserow.io の URL を使用しています。セルフホストの Baserow では、代わりに独自の URL を使用してください。

クイックスタート

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

add-mcp は、インストール済みのエージェントを検出し、Baserow を追加するエージェントを選べるようにします。Claude Desktop が一覧にある場合はチェックを外し、代わりにカスタムコネクターとして Baserow を追加してください。skills add は、baserow-basics スキルをエージェントのスキルフォルダーにコピーします。セルフホストの Baserow では、以下のプラグインだけにスキルが含まれているため、skills add も実行してください。

セルフホストの要件

• Baserow のバージョンが 2.4.1 より新しいこと。古いバージョンには /mcp やサインイン機能がありません。その場合はエンドポイントキーを使用してください。
• バックエンドで BASEROW_MCP_OAUTH_ENABLED=true が設定されていること。デフォルトでは無効です。
• Claude.ai や ChatGPT などのホスト型アプリが接続できる、公開 HTTPS バックエンド URL があること。また、アプリのクライアントメタデータを取得するため、バックエンドからの HTTPS アウトバウンド通信が必要です。
• リバースプロキシが /mcp と /mcp/ 配下のパス、/oauth/、/.well-known/oauth-authorization-server、/.well-known/oauth-protected-resource をバックエンドに転送すること。/mcp はプレフィックスではなく完全一致で指定してください。フロントエンドは /mcp-authorize/ でサインインページを提供します。

セルフホストの Baserow での MCP OAuth サインインを参照してください。

エージェントごとのインストール

エージェント	baserow.io	セルフホスト
Claude Code	プラグイン	同じプラグインを使用し、要求されたら URL を入力
Claude.ai、Claude Desktop	カスタムコネクター	同じ手順で URL を指定
ChatGPT	カスタム MCP サーバー	同じ手順で URL を指定
Codex	プラグイン	codex mcp add baserow --url <your url>
GitHub Copilot CLI	プラグイン	サーバーのみ
Gemini CLI	gemini extensions install https://github.com/baserow/baserow-mcp	gemini mcp add -s user -t http baserow <your url>
Cursor	Cursor に追加	設定ファイル
VS Code	VS Code に追加	設定ファイル
Goose	Goose に追加	URL を指定してクイックスタート
OpenCode、Windsurf、Zed	設定ファイル	同じ手順で URL を指定
その他のエージェント	クイックスタート	同じ手順で URL を指定

Codex、Copilot、Gemini のプラグインと「追加」ボタンは、常に baserow.io を参照します。そのため、セルフホストの Baserow では、これらのエージェントにはサーバーのみを追加してください。

Claude Code

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

URL を尋ねられたら、Esc キーを押して baserow.io をそのまま使用するか、セルフホストの URL を入力してください。後から変更するには、/plugin configure baserow@baserow を実行します。

Claude.ai と Claude Desktop

Customize → Connectors → + Add → Add custom connector の順に選択します。名前に Baserow を指定し、サーバー URL を入力してください。Team プランと Enterprise プランでは、オーナーが Organization settings → Connectors から追加します。

ChatGPT

Plugins を開き、プラスボタンを選択してから Add custom MCP server を選び、サーバーの URL を入力します。メニュー名は頻繁に変わります。Business プランおよび Enterprise プランでは、管理者が先にカスタム MCP サーバーを許可する必要があります。

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

セルフホスト版の Baserow では、サーバーのみを追加します：copilot mcp add --transport http baserow <your url>。プラグインがインストールされている場合は、先に copilot plugin uninstall baserow でアンインストールしてください。プラグインのサーバーが警告なしに追加したサーバーを置き換えます。

Config files

プラグインを使わず、サーバーのみを追加する場合：

• 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 を設定し、その後 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、設定：

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

サインイン

エージェントはブラウザーで Baserow のページを開きます。サインインして、ワークスペースを選択し、エージェントが使用できるツールにチェックを入れてください。読み取りツールを使うと、エージェントはデータベース、テーブル、行を参照できます。書き込みツールを使うと、行の作成、更新、削除ができます。初回接続時には、読み取りツールだけにチェックが入っています。

サインインを開始する場所：

• Claude Code：/mcp を実行し、plugin:baserow:baserow を選択して認証します。
• Codex：codex mcp login baserow。
• Gemini CLI：/mcp auth baserow。
• Claude.ai、ChatGPT、Cursor、VS Code：サーバーの横にある Connect または Sign in ボタン。

ワークスペースやツールを変更するには、もう一度サインインします。エージェントでサーバーを再認証するか、Baserow の My settings → MCP server でアプリを切断してから、再接続してください。通常の再接続では、以前のサインイン情報が維持されます。

トラブルシューティング

• ツールが見つからない、またはデータベースが表示されない。 接続で使用できるのは、サインイン時に選択したワークスペースとツールのみです。上記の手順で再度サインインしてください。テーブルやフィールドを変更するツールは MCP では使用できません。
• サインインが開始されない、またはクライアントに OAuth やクライアント登録に対応していないと表示される。 セルフホスト版の Baserow では、セルフホストの要件を確認してください。
• 入力した URL で接続に失敗する。 My settings → MCP server に表示される URL をそのままコピーしてください。末尾は /mcp で、末尾にスラッシュは付きません。
• Claude Code に Baserow サーバーが 2 つ表示される。 claude mcp list にプラグインの plugin:baserow:baserow と、手動で追加した baserow サーバーの両方が表示される場合は、接続できる方を残してください。claude plugin disable baserow@baserow でプラグイン側を無効にできます。claude mcp remove baserow で手動で追加したサーバーを削除できます。

エンドポイントキー

Baserow 2.4.1 以前ではエンドポイントキーのみが受け付けられ、プラグインでは設定されません。My settings → MCP server からエンドポイント URL をコピーしてください。末尾は /sse で、キーが含まれています。Claude Code、Cursor、VS Code など、SSE サーバーに対応するエージェントに手動で追加してください。Codex と Goose は対応していません：

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

新しいバージョンでは、スクリプトに便利なように、/mcp のヘッダーとしてキーを指定する方法も使えます：

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

キーを使うと、そのワークスペースに完全にアクセスできます。-g を指定すると、現在のフォルダーではなくユーザー設定に書き込まれるため、コミットに含まれることはありません。

プライバシーとサポート

• プライバシーポリシー：https://baserow.io/privacy-policy
• 利用規約：https://baserow.io/terms-and-conditions
• ヘルプ：コミュニティフォーラムまたはお問い合わせ

開発

scripts/ で npm install を実行し、続けて npm test と npm run check を実行してください。CI でも同じチェックが実行されます。プラグインのインストール時に依存関係がインストールされないよう、ツールはこのディレクトリに置かれています。

Claude Code プラグインは .claude-plugin/plugin.json でサーバーを宣言しているため、入力した URL を使用できます。.mcp.json には、GitHub Copilot CLI や Cursor など、Claude 形式のプラグインを読み込む他のツール向けに baserow.io の URL が記載されています。

ライセンス

MIT