ClaudeやCursorからn8nのMCPを呼ぶ設定：インスタンスレベルのMCPとMCP Server Triggerを、画面と設定値の順で（その2）

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。手順は「公式の手順を順に並べたもの」で、設定例は「公式の例（要約を介して取得したため、全文は公式ページで確認）」か、「公式の記載に合わせて、この記事で組んだ例（動作は確かめていません）」のどちらかを、そのつど書きます。システムに設定や権限を登録する操作は、原文を見て写すようにしてください。画面の表記は版によって変わるので、手元の画面と照らして読んでください。

先に結論

• 2つの入り口は、役割が違います。 公式は、インスタンスレベルのMCPを「インスタンスに1つの接続、認証の一元化、有効にするワークフローの選択」、MCP Server Triggerを「1本のワークフローの中で、そのワークフローのツールだけ出す」ものと説明しています。
• MCPを有効にする人は、オーナーか管理者です。 「Settings > Instance-level MCP」で「Enable MCP access」を選びます。
• 認証は、OAuth（公式が recommended と書く）と、APIキー（個人のアクセストークン）の2通りです。
• 「何も公開されていない」が出発点です。 公式は、インスタンスで有効にしたうえで、ワークフローやエージェントを1つずつ有効にする、と書いています。例外が、ワークフローの「プレビュー」を返す search_workflows です。

前提：用語をそろえる

• MCP（Model Context Protocol）：AIのツールが、外のデータや機能につながるための共通の規格です。
• MCPサーバー／クライアント：機能を出す側がサーバー、使う側がクライアントです。この記事では、n8nが「サーバー」になります（Claude CodeやCursorがクライアント）。
• OAuth：画面で「許可する」を押して、つなぐ許可を出す方式です。
• Bearerトークン：HTTPのヘッダー Authorization: Bearer <トークン> で渡す、合言葉の文字列です。
• SSE／ストリーミングHTTP：サーバーからクライアントへ、つなぎっぱなしで流す通信方式です。
• リバースプロキシ：n8nの前に置く、中継のサーバーです。HTTPSを受けて、n8nに渡します。
• コールバックURL：OAuthで、許可のあとにブラウザーが戻る先のURLです。
• オーナー／管理者：n8nで、インスタンスの設定を変えられる権限の人です。

連携の地図

I：インスタンスレベルのMCPサーバー（外のAIが、n8nを呼ぶ）

公式の「Connect to n8n MCP server」の記述です。Cloudとセルフホストの両方に当てはまります。プランやエディションごとの可否は、読んだページには書かれていませんでした。

I-1. 版の目安（公式の本文の記述から）

2.33.0より前は、設定ページが簡素で、クライアントごとの手順がありません。その場合は、公式の「MCP client connection examples」の手動の設定を使う、と書かれています。

I-2. 有効にする

1. オーナーか管理者でログインする。
2. 「Settings > Instance-level MCP」を開く。
3. 「Enable MCP access」を選ぶ。

有効にすると、3つのセクションが出ます。「Connection details」（「MCP status」と「Connect」ボタン）、「Access」（公開しているワークフロー［とエージェント］の数。オーナーと管理者は「Allowed callback URLs」も）、「Connected clients」（つないだクライアントを最大3件プレビュー）。

無効にするには、「Connection details」の「MCP status」で「Disable」を選び、確認します。すべてのクライアントが切れ、アクセスが取り消されます。あとで再び有効にできます。セルフホストでは、N8N_DISABLED_MODULES=mcp で、MCPのエンドポイントと関連のUIを、まるごと外せます（公式の記述）。

I-3. クライアントをつなぐ：OAuth

1. 「Settings > Instance-level MCP」で「Connect」を選ぶ。「Connect a client」のダイアログが開く。
2. 「OAuth (recommended)」のタブで、「Your client」から選ぶ。クライアントの分類は、CLI（Claude Code、Codex、Gemini CLI）、Web（Claude.ai、ChatGPT、Mistral Vibe）、IDE（Cursor、VS Code、Windsurf）。
3. 種類ごとの続き：
4. Webのクライアント：「One-click setup」を選ぶか、「Server URL」をコピーして、クライアントのコネクターの設定に入れる。
5. CLIのクライアント：表示されたインストールのコマンドを実行するか、設定ファイルに設定の断片を足す。最後に「Authenticate」の手順。
6. IDEのクライアント：エディターが対応していれば、ワンクリックのリンクを使う。そうでなければ、「Server URL」と設定の断片を自分で入れる。
7. クライアントから、n8nに戻されたら、アクセスを承認する。

サーバーのURLは、/mcp-server/http で終わります（公式の記述）。公式の例のプレースホルダー <your-n8n-domain> は、https:// を除いたドメインです。素のHTTPで動かす場合（たとえば http://localhost:5678）は、http:// を使います。

I-4. クライアントごとの設定（公式の「MCP client connection examples」）

以下は、公式の例です。要約を介して取得したため、書き写して使う前に、公式ページの原文と照らしてください。<your-n8n-domain> と <YOUR_N8N_MCP_TOKEN> は、公式のプレースホルダーです。

Claude Codeの設定ファイルの例（公式の記述の要点）は、mcpServers の下に、名前（n8n）、type が http、url がサーバーのURL、という形です。公式の表記は、ファイル名を claude.json としています。Claude Code側の実際の置き場所は、Claude Codeの説明で確かめてください。

I-5. クライアントをつなぐ：APIキー

1. 「Connect a client」で「API key」のタブに切り替える。
2. 初めて開くと、n8nが、自分のユーザーに紐づく個人のアクセストークンを自動で作る。
3. 「Configuration JSON」のブロック（サーバーのURLと Authorization: Bearer のヘッダーが入っている）をコピーするか、「Server URL」とトークンを別々にコピーする（CodexのTOMLのように形式が違うクライアント向け）。
4. クライアントの設定に貼る。このタブは、クライアントごとの内容ではありません。

タブを離れると、トークンは伏せ字だけになり、もう一度コピーできません。作り直す（rotate）と、前のトークンはすぐ無効になります。使っているクライアントすべてを、新しい値に更新する必要があります。APIキーでつないだクライアントは、「Connected clients」の一覧に出ません。

I-6. 見せるワークフローを選ぶ

search_workflows は、ユーザーが見られるすべてのワークフローの「プレビュー」を返します。ワークフローの全データの読み取り、実行、変更は、ワークフローを有効にしたものだけです。

また、ワークフローの「説明」は、クライアントがワークフローを見分けるために使われます。「Workflows enabled」のページの「Edit description」か、エディターの「Workflow menu」>「Edit description」で付けます。

エージェント（Preview）も、「Agents exposed」から別に有効にします。エージェントは、公式がPreviewと書き、変わりうるとしています。

I-7. つないだクライアントを確認し、取り消す

1. 「Settings > Instance-level MCP」を開く。
2. 「Connected clients」で、クライアントを選んで詳細を見るか、「View all」で一覧を見る。
3. 「Revoke access」を選び、確認する。クライアントはすぐに切れ、再び使うには、つなぎ直してサインインが要る。

各クライアントは、つなぐときに許可された権限だけをもつ、と書かれています（たとえば、読むだけで、作ったり動かしたりはできない）。「all-users」の表示に切り替えると、ほかのユーザーのクライアントも見られる、と書かれています。どの役割が使えるかは、読んだページに明記がありません。

I-8. OAuthのコールバックURLを絞る

既定では、n8nは、どのコールバックURLも受け付けます（公式は「less secure」と書く）。オーナーと管理者は、次の手順で絞れます。

1. 「Settings > Instance-level MCP」。
2. 「Access」で「Allowed callback URLs」を選ぶ。
3. 「All callback URLs」か「Only trusted URLs」を選ぶ。
4. 後者なら、信頼するURLを1つずつ入れて「Save」。

I-9. 渡るデータと、見える範囲

• クライアントは、有効にしたワークフローを、見つけ、動かし、テストし、作り、編集できます。データテーブルも扱えます（公式の概要）。
• 公式は、アクセスは「インスタンス全体」で、特定のクライアントにだけ特定のワークフローを見せることはできない、と書いています。
• 見えるのは、そのユーザーに権限があり、MCPを有効にしたワークフローです。
• 多くのツールは、公開前（下書き）のワークフローにも動きます。execute_workflow について、公式の「Connect to n8n MCP server」は、既定は本番（公開した版）で、manual にすると公開前の今の版が動く、と書いています。一方、ツール一覧のページは、executionMode が必須で既定はなく、manual は今の版、production は公開した版（公開済みであること）と書いています。2つのページで書き方が違うので、手元の版で確かめてください。
• list_credentials は、秘密のデータを返しません。get_workflow_details は、認証情報を id と name に絞って返します（公式のツール一覧）。
• ツールの例：search_workflows（最大200件）、get_workflow_details、execute_workflow、test_workflow、publish_workflow、unpublish_workflow、search_workflow_executions、list_credentials、ワークフローを作る search_nodes、get_node_types など。execute_workflow は、複数ステップのフォームや、人の確認が要る流れに対応していません。
• 2.34.0で、ツールの名前がいくつか変わっています（たとえば get_execution が get_workflow_execution に）。

I-10. うまくいかないときの確認点（公式の記述から）

J：MCP Server Trigger（1本のワークフローを、外に出す）

公式の「MCP Server Trigger」の記述です。n8nを、MCPサーバーにするトリガーのノードです。普通のトリガーと違い、出力を次のノードに渡さず、つないだ「ツール」のノードだけを動かします。

J-1. 手順

1. 新しいワークフローに、「MCP Server Trigger」を足す。
2. ノードに、ツールのノードを足す。ワークフローを出したいときは、「Custom n8n Workflow Tool」のノードで付ける（06の「Call n8n Workflow Tool」とは、公式のページで呼び名が違います。同じものかは、公式の記述では確認できていません）。
3. 「Authentication」を選ぶ：「None」「Bearer auth」「Header auth」。認証情報の項目は、HTTP Requestの認証情報に準じる（Bearerは「Bearer Token」、Headerは「Name」と「Value」）。
4. 「Path」：既定は、ほかのMCP Server Triggerと衝突しない、ランダムな文字列。自分で決めることもできる。
5. 「Test URL」と「Production URL」の切り替えで、2つのMCPのURLを見る。
6. Test URL：「Listen for Test Event」か「Execute workflow」で（ワークフローが有効でないとき）登録される。呼び出しは、エディターに表示される。
7. Production URL：ワークフローを公開すると登録される。データはエディターに出ず、「Executions」のタブで見る。
8. クライアントに、MCPのURLを教える。

対応する通信方式は、SSEとストリーミングHTTPで、標準入出力（stdio）には対応していません。

J-2. Claude Desktopから使う公式の例

公式は、SSEを標準入出力のサーバーに変換する外部のパッケージ mcp-remote を、npx で動かす形を示しています。設定は、mcpServers の下に名前（公式の例は n8n）、command を npx、args に mcp-remote、MCPのURL、--header、Authorization: Bearer ${AUTH_TOKEN} を並べ、env に AUTH_TOKEN としてトークンを入れる形です。JSONの全文は、公式ページで確認してください。公式の要約を取得した際、${AUTH_TOKEN} が args の中で展開されるかは、ページに書かれていないと注記されました。うまくいかないときは、公式やmcp-remoteの説明で確かめる必要があります。mcp-remoteは、n8nの外のパッケージで、作った人は、読んだ範囲では確認できていません。

J-3. 注意（公式の記述）

• claude.aiのカスタムコネクタは、認証が「None」でも、n8nへのサインインを求めることがある。claude.aiだけがこうなる、と書かれている。
• キューモードで、Webhook用のレプリカが複数あるときは、/mcp* のリクエストを、MCP専用の1つのレプリカに集める設定が要る。そうしないと、SSEやストリーミングHTTPの接続が壊れることがある（公式の記述）。
• リバースプロキシ（nginxなど）の後ろでは、MCPのパスで、バッファリングを切る（proxy_buffering off）、gzipを切る（gzip off）、チャンク転送を切る（chunked_transfer_encoding off）、Connection ヘッダーを空にする（proxy_set_header Connection ''）、proxy_http_version 1.1 が要る。公式の例は location /mcp/ { ... } のブロックです。全文は公式ページで確認してください。

J-4. 外し方

ワークフローの公開を外す（「Publish」の隣の矢印から、または「Workflows」の一覧から）と、本番のURLは使えなくなる、という読みになりますが、公式のMCP Server Triggerのページに、公開を外したときの動きの明記は見つかりませんでした。確実に止めるには、認証を付ける、ノードを消す、といった操作があります（ノードの操作は06の場面2）。

渡るデータの整理（外から呼ぶ向き）

外し方の整理

気をつけること

• この記事は、実際に使って確かめた記録ではありません。公式の資料を読んだ範囲です。
• MCPの設定画面は、2.33.0以降の形です。ツールの名前は2.34.0で複数が改名されています。自分の版で確かめてください。
• 「Auto-expose new workflows」は、公式が「順次提供」と書き、すべてのインスタンスに出ていない可能性があります。
• supergateway と mcp-remote は、npx で取ってくる外部のパッケージです。公式の資料では、誰が作ったかを確認できていません。
• Claude Codeなどの設定ファイルの置き場所は、公式の表記と、各クライアントの説明が一致しないことがあります。クライアント側の説明で確かめてください。
• Webhook、Slack、セルフホストの設定は、続きの09にあります。
• 規約や契約の解釈は、必要なら専門家や公式に確認してください。この記事は法律の助言ではありません。

出典

• Connect to n8n MCP server（n8n Docs、確認日 2026-10-25）
• MCP client connection examples（n8n Docs、確認日 2026-10-25）
• MCP server tools reference（n8n Docs、確認日 2026-10-25）
• MCP Server Trigger（n8n Docs、確認日 2026-10-25）
• Save and publish workflows（n8n Docs、確認日 2026-10-25）
• Configure workflow settings（n8n Docs、確認日 2026-10-25）