NocoDBをMicrosoft Copilotと接続（MCP）

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

NocoDB + Microsoft Copilot

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

前提条件

コネクターに組み込まれているセットアップ手順の全文を確認してください（アプリ内ストアでコネクターを選択すると表示されます）。このコネクターに必要な環境変数は次のとおりです。

NOCODB_URL, NOCODB_API_TOKEN

ステップ 1 — 認証情報を取得する

セットアップには約 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 を指定した 1 件のレコード、レコード数を読み取れます。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 も使用しません。

ステップ 2 — アダプターをインストールする

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

ステップ 3 — Microsoft Copilot にコネクターを追加する

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Microsoft Copilot は、Copilot Studio で作成したエージェントを通じて MCP サーバーを使います。AnythingMCP をツールとしてエージェントに追加し、そのエージェントを Microsoft 365 Copilot と Teams に公開します。Copilot Studio は Microsoft のクラウドから Streamable HTTP で接続し、AnythingMCP はこれに対応しています。

1. Copilot Studio でエージェントを開き（または新規作成し）、Tools で Add a tool → New tool → Model Context Protocol を選びます。
2. Server name（例: AnythingMCP）、コネクタでできることを説明する Server description、Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を入力します。Copilot Studio はこの説明をもとに、いつサーバーを呼び出すかを判断します。
3. 認証で API key を選び、Type を Header、ヘッダー名を X-API-Key にして Create を選びます。
4. Add tool で Create a new connection を選び、AnythingMCP の MCP API キー（MCP Servers → 対象のサーバー → API keys）を貼り付けて Add to agent を選びます。
5. エージェントの Test ウィンドウで試します。NocoDB のツールが必要になる依頼をしてみましょう。
6. Publish を選び、Channels → Microsoft 365 and Microsoft Teams で Make agent available in Microsoft Copilot を選択したまま Add channel を選びます。See agent in Teams で自分用にインストールされます。Microsoft 365 Copilot では @ を入力してエージェントを選びます。

ユーザーごとにサインインさせたい場合は、API キーの代わりに OAuth 2.0 → Dynamic discovery を選びます。各ユーザーは、エージェントが初めて呼び出すときに AnythingMCP にサインインします。

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Copilot Studio は Microsoft のクラウドから接続するため、localhost は使えません。

利用可能なツール

FAQ

どの Copilot が対象ですか? 職場で使う Microsoft 365 Copilot で、Copilot Studio のエージェントを通じて利用します。個人アカウント向けの Microsoft Copilot アプリでは、独自の MCP サーバーを追加できません。

何が必要ですか? エージェントを作成するために、Copilot Studio を利用できる職場アカウント（ライセンスまたは試用版）が必要です。Microsoft 365 Copilot や Teams でエージェントを使う人には、エージェントへのアクセス権が必要です。共有するか、管理者に組織向けに公開してもらってください。組織が Power Platform コネクタにデータ ポリシーを適用している場合は、MCP サーバーにも適用されます。

エージェントがツールを呼び出しません。 ヘッダー名が正確に X-API-Key であること、キーが URL と同じ MCP サーバーのものであることを確認し、Server description を具体的に書いてください。Copilot Studio はこの説明をもとにサーバーを呼び出すかどうかを判断します。変更のたびにエージェントを再公開し、開いているチャットでは "start over" と入力すると新しいバージョンになります。

次のステップ

• コネクターのランディングページ
• Claude に接続する
• ChatGPT に接続する