nocobase-mcp-setup

目標

ユーザーのコーディングエージェント CLI 用に NocoBase MCP 接続を構成し、サーバーに到達でき、認証済みであることを確認します。

ワークフロー

1. 使用するアプリのエンドポイントを確認します。
   • メインアプリ：http(s)://<host>:<port>/api/mcp
   • メイン以外のアプリ：http(s)://<host>:<port>/api/__app/<app_name>/mcp
2. NocoBase が起動していて、アクセス可能であることを確認します。
3. 認証モードを決定します。
   • API Key：API Keys プラグインと、既存の API キーが必要です
   • OAuth：IdP: OAuth プラグインが必要です
4. ユーザーの CLI 用コマンドを使用して、NocoBase MCP サーバーを追加するよう案内します。
5. 登録済みのサーバーと利用可能なツールを確認して、MCP 接続を検証します。

サービスに関する注意事項

• NocoBase MCP は streamable HTTP トランスポートプロトコルを使用します。
• NocoBase が公開するもの：
  • NocoBase コアとプラグインの API
  • コレクションを操作するための汎用 CRUD ツール

MCP の設定

ユーザーの CLI と認証モードに応じてコマンドを選択します。

API Key を使用する Codex

export NOCOBASE_API_TOKEN=<your_api_key>
codex mcp add nocobase --url http://<host>:<port>/api/mcp --bearer-token-env-var NOCOBASE_API_TOKEN

OAuth を使用する Codex

codex mcp add nocobase --url http://<host>:<port>/api/mcp
codex mcp login nocobase --scopes mcp,offline_access

API Key を使用する Claude Code

claude mcp add --transport http nocobase http://<host>:<port>/api/mcp --header "Authorization: Bearer <your_api_key>"

OAuth を使用する Claude Code

claude mcp add --transport http nocobase http://<host>:<port>/api/mcp

次に Claude を開き、MCP パネルからログインを完了します。

claude
/mcp

その他の CLI

同じエンドポイントパターンと、CLI がサポートする認証モードを使用します。

前提条件

• NocoBase がインストールされ、起動している
• 正しいアプリのエンドポイントがわかっている
• API Key 認証の場合：
  • API Keys プラグインが有効になっている
  • API キーが作成されている
• OAuth 認証の場合：
  • IdP: OAuth プラグインが有効になっている

検証

設定後、コレクションやフィールドなどの NocoBase API 操作で、NocoBase MCP ツールが利用可能であることを確認します。

Codex CLI の場合は、次を使用します。

codex mcp list
codex mcp get nocobase

Claude Code の場合は、Claude を起動して MCP エントリーを確認します。

claude
/mcp