NocoDB MCP サーバーで表とレコードを閲覧

💡 インストール不要。cloud.anythingmcp.com をそのままご利用ください。 サインインして Connectors → NocoDB をクリックし、認証情報を貼り付けて MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要です。

NocoDB

NocoDB Cloud またはセルフホスト版の NocoDB から、ワークスペース、ベース、テーブル、レコードを読み取ります。v3 REST API に対して xc-token API キー認証を使う、読み取り専用ツールを 7 つ提供します。

セットアップ

セットアップにかかる時間は約 2 分です。NocoDB のアドレスと API トークンが必要です。

1. NocoDB で Team & Settings → API Tokens を開き、トークンを作成します。可能であれば読み取り専用のトークンを使ってください。トークンを NOCODB_API_TOKEN にコピーします。
2. NOCODB_URL には、末尾にスラッシュを付けずに NocoDB のルートホストを設定します。NocoDB Cloud の場合は https://app.nocodb.com、自前のホストの場合は https://nocodb.example.com のようになります。
3. コネクタをインストールして nocodb_list_workspaces を実行します。トークンで参照できるワークスペースが一覧表示されます。

トークンのスコープ: NocoDB の API トークンは NocoDB インスタンス全体に適用され、xc-token ヘッダーで送信されます。AI が参照できる範囲を制限するには、必要な権限だけを持つユーザーアカウントでトークンを作成してください。

NocoDB の稼働場所: AnythingMCP Cloud から到達できるのは、公開されている NocoDB インスタンスのみです。NocoDB のホストがプライベートネットワーク内にある場合、またはプライベートアドレス空間に解決される場合は、同じネットワーク上で AnythingMCP をセルフホストし、SSRF_ALLOWED_HOSTS でそのホストを許可してください。許可しないと、送信ガードによってリクエストがブロックされます。

読み取れる内容: NocoDB v3 API を通じて、ワークスペース、ベース、テーブル、テーブルのカラム(名前と型)、レコード、数値の行 ID による単一レコード、レコード数を読み取れます。ID は連鎖しています。nocodb_list_workspaces はワークスペース ID(w で始まる)を、nocodb_list_bases はベース ID(p で始まる)を、nocodb_list_tables はテーブル ID を返します。フィルタリングやソートの前に、AI は nocodb_get_table を呼び出して正確なフィールド名を取得します。フィルターは NocoDB の構文を使い(例: (Status,eq,Open)~and(Priority,eq,High))、ソートは JSON で指定します(例: [{"field":"CreatedAt","direction":"desc"}])。

Community Edition: ライセンスなしのセルフホスト版 NocoDB には暗黙のワークスペースが 1 つだけある場合があり、その場合 nocodb_list_workspaces は 1 件のみ、または空のリストを返すことがあります。そのときは、ワークスペース ID が分かっていれば nocodb_list_bases に、ベース ID が分かっていればテーブルの取得に直接進んでください。

制限: pageSize は、NocoDB Cloud では 100、セルフホスト版では 1000 に黙って上限が設定されます。大きなテーブルをページングする前に、nocodb_count_records で合計件数を確認できます。NocoDB はユーザーあたり毎秒約 5 リクエストまで許可し、この上限はそのユーザーのすべてのトークンで共有されます。上限を超えると、Retry-After ヘッダー付きで HTTP 429 が返されます。

このコネクタは読み取り専用です。レコード、テーブル、ベース、ワークスペースの作成、更新、削除は行わず、ビュー(プラン制限あり)、添付ファイル、Webhook、非推奨の v1 および v2 API も使用しません。

前提条件: NOCODB_URL, NOCODB_API_TOKEN

コネクタをローカルにインストールする

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

http://localhost:3000/connectors/store を開き、NocoDB を選んで、前提条件に記載した環境変数を貼り付けます。

利用可能なツール

次のステップ

• Claude に接続する
• ChatGPT に接続する