Baserow
公式Baserowのテーブルへの読み取りおよび書き込みアクセス。
Baserow MCPで何ができますか？
- Baserowデータの参照 — 接続されたワークスペースからデータベース、テーブル、行を一覧表示するようアシスタントに依頼します。
- テーブル内容の読み取り — 承認した特定のテーブルからデータを取得し、要約するようアシスタントに指示します。
- 新しい行の作成 — 有効にした書き込みツールを使用して、テーブルにレコードを追加するようアシスタントに指示します。
- 既存の行の更新 — 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の「マイ設定 → MCPサーバー」からコピーしてください。
以下の例では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も実行してください。
セルフホストの要件
- 2.4.1より新しいBaserowバージョン。古いバージョンには
/mcpまたはサインイン機能がないため、エンドポイントキーを使用してください。 - バックエンドで
BASEROW_MCP_OAUTH_ENABLED=trueを有効にすること。デフォルトではオフです。 - 公開HTTPSバックエンドURL。Claude.aiやChatGPTなどのホスト型アプリが到達できるようにするためです。また、アプリのクライアントメタデータを取得するためのバックエンドからのアウトバウンド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
カスタマイズ → コネクタ → + 追加 → カスタムコネクタを追加。Baserowという名前を付け、サーバーURLを入力します。TeamプランとEnterpriseプランでは、所有者が「組織設定 → コネクタ」で追加します。
ChatGPT
プラグインを開き、プラスボタンを選択して「カスタムMCPサーバーを追加」を選択し、サーバー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でアンインストールしてください。プラグインのサーバーが警告なしにあなたのサーバーを置き換えます。
設定ファイル
プラグインなしでサーバーのみを追加する場合:
- 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: サーバー横の「接続」または「サインイン」ボタン。
ワークスペースやツールを変更するには、再度サインインします。エージェントでサーバーを再認証するか、Baserowの「マイ設定 → MCPサーバー」でアプリを切断して再接続します。単純な再接続では古いサインインが維持されます。
トラブルシューティング
- ツールがない、またはデータベースが一覧表示されない。 接続には、サインイン時に選択したワークスペースとツールのみが含まれます。上記の手順で再度サインインしてください。テーブルやフィールドを変更するツールはMCPでは利用できません。
- サインインが開始されない、またはクライアントがOAuthやクライアント登録をサーバーがサポートしていないと表示する。 セルフホストのBaserowでは、セルフホストの要件を確認してください。
- 入力したURLで接続が失敗する。 「マイ設定 → MCPサーバー」に表示されている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以前ではエンドポイントキーのみを受け付け、プラグインはこれを設定しません。「マイ設定 → MCPサーバー」からエンドポイントURLをコピーしてください。末尾は/sseで、キーが含まれています。SSEサーバーをサポートするエージェント（Claude Code、Cursor、VS Codeなど）に手動で追加してください。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