NodaroAccount
Nodaro ドキュメント
ドキュメントノードリファレンスモデルテンプレートAI エージェント(MCP)開発者向けセルフホスティングリサーチ比較

セルフホスティング環境での MCP

セルフホスティング環境の Nodaro で MCP サーバーを有効にし、Claude、Cursor、ChatGPT などの MCP クライアントが、MCP のホスト名またはパスから OAuth で環境を使えるようにします。

Nodaro の MCP サーバーを使うと、Claude、Cursor、Cline、Continue、Goose、ChatGPT などの AI クライアントが、ユーザーに代わってセルフホスティング環境のツールを使えるようになります。MCP サーバーは、デフォルトではオフです。有効にするには、MCP 専用のホスト名を用意してそのホスト名を API にルーティングし、2 つの変数を設定します。その後、ユーザーは自分のクライアントから OAuth で環境にログインします。

MCP の提供のしくみ

  • MCP は API が提供します。nodaro コンテナ内のポート 9000 で、パス /mcp に応答します。
  • ポート 3000 の Web サーバーは、MCP のリクエストを拒否します。アプリのメインのアドレスで /mcp にリクエストすると、405 とエラー wrong_mcp_host、そして本来のエンドポイントのアドレスが返されます。
  • そのため、MCP には専用のホスト名が必要です。mcp.nodaro.example.com のように、トラフィックが API に直接届くホスト名を用意します。 Business と Cloud エディションでは、代わりに自身のホストでパスで提供できます。
  • ログインはメインのドメインのままです。OAuth のディスカバリードキュメント /.well-known/oauth-authorization-server と同意画面は、PUBLIC_URL で提供されます。

MCP を有効にする

MCP のホスト名を API にルーティングする

mcp.<your-domain> の DNS レコードを作成し、自分のサーバーに解決されるようにします。CDN を経由してプロキシしないでください。プロキシを通すと、MCP が使う長時間の Server-Sent Events 接続が切断されます。

Compose ファイルは、API のポートを公開していません。nodaro サービスの下で、ループバックインターフェイスに公開します。

  nodaro:
    ports:
      - "3000:3000"
      - "127.0.0.1:9000:9000"

次に、リバースプロキシに MCP ホスト用の 2 つ目のサイトを追加し、127.0.0.1:3000 ではなく 127.0.0.1:9000 に転送するようにします。nginx の例と同じように、レスポンスのバッファリングはオフのままにします。

MCP のホスト名を、backend サービスのカスタムドメインとして追加します。

railway domain add mcp.your-domain.com --service backend

または、Railway のダッシュボードで、プロジェクト › backend サービス › Settings(設定)› Domains(ドメイン)› Add custom domain(カスタムドメインを追加)を開きます。その後、DNS プロバイダーで CNAME レコードを追加します。

変数を設定する

MCP_ENABLED=true                              # required; the default is off
MCP_PUBLIC_URL=https://mcp.your-domain.com    # the hostname from step 1

Compose スタックでは、どちらも nodaro サービスの environment: の下に追加します。Compose ファイルは、これらを .env から渡さないためです。その後、docker compose -f docker-compose.community.yml up -d を実行します。

MCP_PUBLIC_URL は、ディスカバリーエンドポイントが保護されたリソース(RFC 9728)の識別子として公開する値で、ツールが返すアップロードリンクのベースにもなります。設定しないと、環境は Nodaro Cloud の MCP ホストを公開してしまいます。サブドメインではなくメインのドメインで MCP を提供する場合は、PUBLIC_URL と同じ値を設定します。その場合も、/mcp へのリクエストは API のポートに直接届く必要があります。

ディスカバリーエンドポイントを確認する

curl https://mcp.your-domain.com/.well-known/oauth-protected-resource
curl https://your-domain.com/.well-known/oauth-authorization-server

どちらも、ステータス 200 で JSON を返す必要があります。

クライアントにコネクタを追加する

MCP のエンドポイントは https://mcp.your-domain.com/mcp です。Claude では、Settings(設定)› Connectors(コネクタ)› Add custom connector(カスタムコネクタを追加)を開き、この URL を入力します。ほかのクライアントについては、クライアントを接続を参照し、Nodaro Cloud の URL の代わりに自分の MCP の URL を使ってください。

パスで提供する MCP(専用の MCP ホストなし)

Business と Cloud エディションのみです。これはサーフェスプロファイルのキーで、Community エディションでは無視されます。mcp.<your-domain> に使えるホスト名がないデプロイメントや、ネットワークで自身の登録済みホストしか許可されないデプロイメントでは、同じ MCP エンドポイントをパスで提供できます。

NODARO_SURFACE_PROFILE={"mcp":{"byPath":true}}
  • 応答する場所:デプロイメントが自身のホストとして宣言している各ホストの https://<host>/v1/mcp です。宣言しているのは PUBLIC_URL と、CORS_ORIGIN のすべてのエントリーです。mcp.path で別のパスを設定できます。/v1/mcp かその下の小文字のパスで、末尾のスラッシュなし、64 文字までです。ほかのパスは、警告を出して /v1/mcp に戻ります。
  • 必要なもの:MCP_ENABLED=true と、デプロイメント自身のアドレスを設定した PUBLIC_URL です。PUBLIC_URL がない場合、サーバーは警告をログに出し、MCP を /mcp のままにします。
  • プロキシの変更は不要:同梱のプロキシは、すでに /v1/* と /.well-known/oauth-* を API に転送します。MCP_PUBLIC_URL も必要ありません。
  • すべてのアドレスがホストに従う:401 チャレンジ、OAuth の検出用ドキュメント、同意画面、ツールが返すリンクは、どれもクライアントが接続した宣言済みのホストを示します。ユーザーは、今いるサイトでログインします。宣言されていないホストへのリクエストには、PUBLIC_URL のアドレスが返ります。
  • 1 回のログインですべてのホストで使える:デプロイメントのホストの 1 つでログインしたクライアントは、同じトークンを別のホストでも使えます。
  • パスが /mcp の代わりになる:このモードの間は、/mcp と、その /.well-known/…/mcp ドキュメントは提供されません。以前の /mcp アドレスで設定したクライアントは、パスで接続し直します。

CORS_ORIGIN には、このデプロイメントが提供するオリジンだけを登録してください。このモードの間は、どれも自身のホストとして扱われます。モードがオフ(デフォルト)の場合、MCP の応答は何も変わりません。

確認するには、次を実行します。

curl https://your-domain.com/.well-known/oauth-protected-resource/v1/mcp

resource は https://your-domain.com/v1/mcp でなければなりません。ユーザーは、コネクタの URL として https://your-domain.com/v1/mcp を追加します。

登録できるクライアント

MCP クライアントは、OAuth でログインします。対応しているクライアントは、動的クライアント登録(RFC 7591)によって、自分自身を環境に登録します。登録は 2 つの変数で制御でき、ほとんどの環境ではデフォルトのままで問題ありません。

変数デフォルト説明
MCP_DYNAMIC_REGISTRATIONallowlistallowlist は、MCP_DCR_ALLOWLIST にあるクライアント名だけを受け付けます。open は、任意のクライアントを受け付けます。off は、動的登録を無効にします。
MCP_DCR_ALLOWLIST既知の 14 のクライアントallowlist モードで受け付けるクライアント名を、カンマ区切りで指定します。

デフォルトの許可リストは、Claude、Claude Code、Cursor、Cline、Continue、Goose、ChatGPT、OpenAI、Lovable、Gemini、Gemini CLI、Codex、MCP Inspector、mcp-inspector です。独自のクライアントを追加するには、リスト全体を設定します。

MCP_DCR_ALLOWLIST=Claude,Cursor,Cline,Continue,Goose,YourCustomClient

推奨のモードは allowlist です。MCP_ALLOWED_CLIENT_IDS を設定している場合、これらの変数の内容にかかわらず、動的登録は off として応答します。自分のクライアントだけで使う MCP を参照してください。

自分のクライアントだけで使う MCP

環境は、MCP エンドポイントに、自分で設定したクライアントからだけアクセスできるようにできます。たとえば、自分のチャットアプリケーションです。ユーザーは環境のサインインでサインインし、同意画面でクライアントを一度承認します。どのエディションも、1 つの変数を読み込みます。

MCP_ALLOWED_CLIENT_IDS=app_0123456789abcdef0123456789abcdef

これは、開発者アプリの client_id をカンマで区切ったリストです。リストに指定するのは名前ではなく ID です。どのクライアントも自分の名前を自由に選べますが、client_id を発行するのはあなたの環境だけだからです。各エントリーは、開発者アプリの ID(app_ と 32 文字の小文字の 16 進数)でなければなりません。自己登録した ndr_dcr_… の ID など、それ以外のエントリーがあると、エントリーの位置を示して起動が止まります。未設定または空の場合、リストはありません。変更を反映するには再起動してください。

リストを設定すると、次のようになります。

  • MCP エンドポイントは、リストにある有効な開発者アプリに発行されたアクセストークンだけを受け付けます。ほかのクライアントのトークン、サインイン中のセッション、個人用 API トークンなど、それ以外の認証情報は 403 mcp_client_not_allowed で拒否されます。拒否のメッセージは、クライアントを示しません。トークンのないリクエストには、これまでどおり 401 のチャレンジが返されるので、クライアントはサインインを見つけられます。
  • チェックは呼び出しのたびに実行されます:再起動でクライアントをリストから外すと、そのトークンは、次の呼び出しから MCP エンドポイントで使えなくなります。クライアントを照会できない場合、呼び出しは 503 mcp_client_check_failed で拒否されます。
  • サインインは、MCP を求めるほかのクライアントを拒否します:拒否は同意画面の前に行われます。ユーザーは、error=unauthorized_client とともにそのままクライアントに戻されます。リストになく、MCP を求めない開発者アプリは、引き続き REST API のためにサインインできますが、そのトークンは MCP エンドポイントで拒否されます。
  • 動的クライアント登録は、MCP_DYNAMIC_REGISTRATION=off の場合と同じく、403 dcr_disabled を返します。
  • ワークフロー Copilot は引き続き動作します:Copilot はサーバーの中で同じツールを実行し、エンドポイントの MCP クライアントではありません。

アクセストークンの有効期間は 90 日で、リフレッシュトークンはありません。新しいトークンは、常にサインインを通じて取得します。または、そのために指定した 1 つのアプリケーションでは、アサーションの交換を通じて取得します。

自分のチャットアプリケーションのためにクライアントを 1 つ設定するには、次のようにします。

開発者アプリの管理を管理者だけに許可する

Business エディションでは、サーフェスプロファイルで {"developerApps":{"manage":"admin"}} を設定します。すると、ユーザーをサインインさせられるクライアントは、あなたが作成したものだけになります。

クライアントを作成する

管理者としてサインインし、設定 › 開発者アプリを開くか、POST /v1/developer-apps を呼び出します。redirectUris にチャットアプリケーションのコールバックを、scopesRequested に必要なスコープを指定します。client_id と、一度だけ表示されるクライアントシークレットをコピーします。

クライアントをリストに入れて再起動する

MCP_ALLOWED_CLIENT_IDS に client_id を設定し、わかりやすくするために MCP_DYNAMIC_REGISTRATION=off も設定します。バックエンドを再起動します。

チャットアプリケーションを設定する

MCP のアドレス、client_id、シークレットまたは PKCE、コールバックを設定します。そのユーザーは環境を通じてサインインし、アプリを一度承認します。

Claude.ai や Cursor など、ほかの MCP クライアントは、サインインの時点で unauthorized_client とともに戻されるか、すでにトークンを持っている場合は 403 mcp_client_not_allowed を受け取ります。MCP のトラブルシューティングを参照してください。

同意のクリックなしで使う MCP:アサーションの交換

チャットアプリケーションが、ユーザーがサインインに使う ID プロバイダーでもある場合、そのサーバーは、同意画面なしで、どのユーザーの MCP トークンでも取得できます。このプロバイダーは、シングルサインオンの assertion プロバイダーです。サーバーは、ユーザーを示すアサーションに署名し、RFC 7523 の JWT-bearer グラントで、POST /v1/oauth/token でそれを交換します。OAuth のクライアント側については、OAuth アプリを参照してください。

交換は、次の 3 つがすべて設定されていない限りオフで、設定されている場合も、指定したクライアントでだけオンになります。

  1. MCP_ALLOWED_CLIENT_IDS に、アプリケーションのクライアントが入っていること。クライアントは、シークレットを持つ機密クライアントの開発者アプリでなければなりません。PKCE だけのクライアントは、交換を使えません。
  2. MCP_ASSERTION_EXCHANGE_CLIENT_IDS に、アプリケーションの client_id が指定されていること。すべてのエントリーが MCP_ALLOWED_CLIENT_IDS にも入っている必要があり、そうでなければ起動が止まります。
  3. EXTERNAL_SSO_PROVIDERS のプロバイダーのエントリーに、exchangeAudience が設定されていること。アプリケーションは、交換用のアサーションの aud にこの値を入れます。この値はプロバイダーのサインイン用の audience と異なる必要があり、設定できるのは 1 つのプロバイダーだけです。プロバイダーのフィールドを参照してください。

クライアントを指定していても、exchangeAudience を設定したプロバイダーがない場合は、起動が止まります。exchangeAudience があっても、指定したクライアントがないプロバイダーは単にオフなので、変数を 1 つ消せば交換はオフになります。

MCP_ALLOWED_CLIENT_IDS=app_0123456789abcdef0123456789abcdef
MCP_ASSERTION_EXCHANGE_CLIENT_IDS=app_0123456789abcdef0123456789abcdef
MCP_ASSERTION_EXCHANGE_TOKEN_TTL_SECONDS=3600   # optional: 300 to 86400
EXTERNAL_SSO_PROVIDERS=@/etc/nodaro/sso-providers.json
# in that file, the provider's entry gains:  "exchangeAudience": "nodaro-mcp-exchange"

交換がオフの場合、POST /v1/oauth/token は、このグラントを不明なグラントタイプとして扱います。オンの場合、認可サーバーのメタデータは、grant_types_supported に urn:ietf:params:oauth:grant-type:jwt-bearer を記載します。

  • サインインと同じチェック:アサーションは、サインインのアサーションと同じように、交換用のオーディエンスに対して検証されます。各 jti は、サインインと交換を合わせて一度だけ受け付けられます。ユーザーは、同じアカウントのリンクのルールで特定されます。
  • 新しいユーザーにはアカウントが作成されます:アカウントのない確認済みのメールアドレスをプロバイダーが示した場合、初回のサインインと同じように、アカウントが作成されてリンクされます。
  • トークン:そのユーザーのための通常のアプリのトークンで、アプリケーションが求めるスコープを持ち、クライアントの scopesRequested を超えることはありません。有効期間は MCP_ASSERTION_EXCHANGE_TOKEN_TTL_SECONDS で、デフォルトは 1 時間です。リフレッシュトークンはなく、アプリケーションはもう一度交換します。
  • 接続済みアプリ:ユーザーの設定 › 接続済みアプリには、そのアプリがサインイン経由で接続済みと表示されます。ユーザーがそこでアプリを取り消すと、そのトークンはすぐに使えなくなり、交換はそのユーザーの新しいトークンを発行しなくなります。もう一度接続できるのは、通常のサインインを通じたユーザー自身の同意だけです。
  • 制限:交換は、ネットワークごとに 1 分あたり 300 回、クライアントごとに 300 回までです。どちらかを超えると、Retry-After とともに 429 が返されます。交換には Redis が必要で、Redis に接続できない場合は 503 が返されます。
  • ログ:交換ごとに 1 行のログが出力され、クライアントと結果を示し、トークンを発行した場合はユーザーも示します。アサーション、トークン、シークレットが含まれることはありません。

交換をオンにすると、アプリケーションは、プロバイダーが示すどのユーザーのトークンでも、そのユーザーのクリックなしで取得します。プロバイダーの secret とクライアントのシークレットがそろうと、プロバイダーがサインインさせられるすべてのアカウントの鍵になります。どちらもアプリケーションのサーバーだけに保管し、ブラウザーやモバイルアプリには決して置かないでください。どちらかが漏えいした可能性がある場合は、ローテーションしてください。クライアントのシークレットは設定 › 開発者アプリで、プロバイダーのシークレットは EXTERNAL_SSO_PROVIDERS で変更して再起動します。ユーザーには同意画面が表示されないので、アプリケーションがアカウントで何をするかを伝えてください。

クライアントでできること

MCP サーバーには、画像、動画、音声、キャラクター、ロケーション、オブジェクトの生成ツールと、ギャラリー、ワークフロー、アプリ、保存したコンポーネント、モデルのためのツールがあります。各ユーザーは、環境上の自分のアカウントとして操作します。

ツールの一覧は、環境が提供するものに従います:サーフェスプロファイルでノード、モデル、ワールド、リンクからのインポートを制限でき、管理者はノードをオフにできます。その場合、MCP セッションは、ツールに必要なものがすべてそのセッションのユーザーに提供されているときにだけ、そのツールを一覧に表示します。一覧にないツールを呼び出すと、何かが作成される前に、403 node_not_available など、実行が受けるのと同じエラーで拒否されます。ユーザー自身のデータを読み取るツール、保存したワークフローやアプリを実行するツール、ドキュメントを提供するツールは、常に一覧に表示されます。許可リストを参照してください。

MCP ツールのリファレンスと、MCP のトラブルシューティングを参照してください。

よくある質問

セルフホスティング環境の Nodaro では、MCP はデフォルトでオンですか?

いいえ。MCP_ENABLED=true と MCP_PUBLIC_URL を設定し、MCP 用のホスト名を API にルーティングしてから再起動します。Compose スタックでは、この 2 つの変数を nodaro サービスの environment ブロックに追加します。Compose ファイルは、これらを .env から渡さないためです。

MCP クライアントに 405 wrong_mcp_host が返されるのはなぜですか?

クライアントがアプリのメインのアドレスを使っており、そこでは Web サーバーが MCP のリクエストを拒否するためです。クライアントの接続先を、MCP ホストの https://your-mcp-host/mcp に変更してください。MCP ホストは、ポート 9000 の API に直接届く必要があります。

自分の環境に登録できる MCP クライアントはどれですか?

デフォルトでは、Claude、Claude Code、Cursor、Cline、Continue、Goose、ChatGPT、Codex など、既知の 14 のクライアントです。ほかのクライアントを許可するには MCP_DCR_ALLOWLIST に名前を追加し、任意のクライアントを受け付けるには MCP_DYNAMIC_REGISTRATION=open を設定します。

専用の MCP ホスト名なしで MCP を提供できますか?

Business と Cloud エディションでは、できます。サーフェスプロファイルで mcp.byPath を true にすると、MCP はデプロイメント自身のホストの https://your-host/v1/mcp で応答します。プロキシの変更も MCP_PUBLIC_URL も必要ありません。

自分のチャットアプリケーションだけに MCP の使用を許可できますか?

はい。そのための開発者アプリを作成し、その client_id を MCP_ALLOWED_CLIENT_IDS に指定してから、再起動します。ほかのすべての MCP クライアントはサインインの時点で拒否され、ほかのクライアントのトークンには 403 mcp_client_not_allowed が返されます。

MCP ホストの前に CDN を置けますか?

トラフィックをプロキシする CDN は置けません。MCP は Server-Sent Events の接続を長時間開いたままにするため、プロキシする CDN はその接続を切断してしまいます。DNS は、サーバーを直接指すように設定してください。

最終更新

目次