ワークフローを直すたびにブラウザを開いていた。
n8nのGUIを開き、ノードをクリックして、JSONを手で修正して、テスト実行ボタンを押して、ログを確認する。またコードに戻って、また開いて——。ターミナルとブラウザの間で1日に何十回も往復していた。
ある日、npx n8n-mcp というコマンドを知った。Claude CodeにMCP（Model Context Protocol）でn8nを直接繋ぐ方法だ。
繋いでみたら、ブラウザを開かなくなった。
何が変わったか
n8n MCPは21本のツールを提供する。ワークフローの一覧取得、詳細確認、作成、更新、テスト実行、実行履歴の確認、ヘルスチェック——全部ターミナルから操作できる。
Before: ターミナル（コード書く）→ ブラウザ（n8n GUI）→ ターミナル（ログ確認）→ ブラウザ（修正）→ …
After: ターミナルだけ。
これがどれだけ楽か、具体的に書いていく。
セットアップ: 5分で終わる
Claude Codeの .mcp.json に以下を追加するだけだ。
{
"mcpServers": {
"n8n-mcp": {
"command": "npx",
"args": ["-y", "n8n-mcp"],
"env": {
"N8N_MODE": "true",
"MCP_MODE": "stdio",
"N8N_API_URL": "http://your-n8n-host:5678",
"N8N_API_KEY": "your-api-key-here",
"LOG_LEVEL": "error",
"DISABLE_CONSOLE_OUTPUT": "true"
},
"timeout": 60000
}
}
}
N8N_API_URL にn8nのホスト、N8N_API_KEY にAPIキーをセットする。APIキーはn8nのSettings → API → Create API Keyで発行できる。
再起動するとClaude Codeに20本のツールが生える。
20本のツール: 何ができるか
全ツール一覧を載せる。
| ツール | 用途 |
|---|---|
n8n_list_workflows |
WF一覧（active/inactive絞り込み可） |
n8n_get_workflow |
WF詳細（全ノード構成） |
n8n_create_workflow |
WF新規作成 |
n8n_update_full_workflow |
WF全体更新 |
n8n_update_partial_workflow |
WF差分更新（ノード追加・削除・変更） |
n8n_delete_workflow |
WF削除 |
n8n_validate_workflow |
構成検証（ノード・接続・式） |
n8n_autofix_workflow |
自動修正 |
n8n_test_workflow |
テスト実行 |
n8n_executions |
実行履歴 |
n8n_health_check |
ヘルスチェック |
n8n_workflow_versions |
バージョン履歴・ロールバック |
n8n_deploy_template |
テンプレート直デプロイ |
n8n_manage_datatable |
データテーブルCRUD |
search_nodes |
ノード検索（500+種類） |
get_node |
ノード詳細 |
validate_node |
ノード設定検証 |
search_templates |
テンプレート検索 |
get_template |
テンプレート詳細 |
tools_documentation |
MCPツールのドキュメント |
20本。日常的に使うのは上半分の10本程度だ。
実践: 「WFが壊れた」をターミナルで直す
実際の使い方を見せる。
ステップ1: 何が起きてるか確認
「Chatwork通知のWFが動いてないみたいだけど、確認して」
Claude Codeが n8n_list_workflows(active=true) でアクティブなWF一覧を取得し、該当WFを n8n_get_workflow で詳細を引く。ノード構成、接続、設定値が全部見える。
GUIでノードを一つずつクリックして回る作業が消えた。
ステップ2: テスト実行
「テスト実行して結果見せて」
n8n_test_workflow を叩く。Webhookトリガーのワークフローなら自動でテストデータを生成してくれるし、スケジュールトリガーなら直接実行してくれる。実行結果もその場で返ってくる。
ブラウザでテスト実行ボタンを押して、実行完了を待って、ログタブを開いて——という手順がゼロになる。
ステップ3: 修正して再テスト
「HTTPノードのURLが間違ってる。正しいのはhttps://api.example.com/v2/notifyだ。直してテストして」
n8n_update_partial_workflow で該当ノードだけ差分更新。全体を書き換える必要がない。更新後に n8n_test_workflow で再テスト。成功を確認して完了。
GUIを一度も開いていない。
地味に便利: ヘルスチェックとバージョン管理
ヘルスチェック
「n8nの調子が悪い気がする。診断して」
n8n_health_check(mode="diagnostic") で詳細診断。ワーカー状態、キュー長、メモリ使用量、DB接続状態が返ってくる。「なんか遅いな」の原因切り分けがターミナルで完結する。
バージョン管理
n8n_workflow_versions でWFの変更履歴を確認できる。「昨日のあの変更を戻したい」はロールバック一発。
これは地味だが、本番のWFを触るとき心理的安全性が段違いになる。失敗してもすぐ戻せるとわかっていれば、修正への躊躇がなくなる。
n8n_autofix: AIにWFを直させる
一番面白いのがこれだ。
壊れたワークフローを n8n_autofix_workflow に渡すと、ノードの接続ミスや設定エラーを自動で修正してくれる。完璧ではないが、明らかな構文エラーや型不一致は大抵直る。
人間がGUIでぽちぽちデバッグしていた作業を、MCPツール経由でAIが自律的にやる。ワークフローを「作る→壊す→直す→テストする」のサイクルが、ターミナルの中で回り続ける。
テンプレートから一発デプロイ
n8nには公式テンプレートが大量にある。search_templates で検索して、n8n_deploy_template でVPSに直接デプロイ。
「Slackの通知をGoogleスプレッドシートに記録するWFを作りたい」
テンプレートを検索→選択→デプロイ→credential設定→テスト。全部ターミナル。
新しいワークフローのプロトタイピングが圧倒的に速くなった。テンプレートを土台にして、必要なノードだけ n8n_update_partial_workflow で差し替えていく。
注意点: 3つのハマりどころ
1. APIキーの有効期限
n8nのAPIキーには有効期限がある。期限が切れるとMCPツールが全部使えなくなる。エラーメッセージが不親切で、最初は何が起きたかわからなかった。
対策: APIキーの有効期限をカレンダーに入れておく。切れる前にn8n UIで再発行する。
2. 作成したWFはデフォルトinactive
n8n_create_workflow で作ったWFはデフォルトでinactive。これを忘れると「作ったのに動かない」で混乱する。
対策: 作成後に n8n_update_partial_workflow でactive化するのをセットにする。
3. n8n_delete_workflowは取り消せない
名前の通り。削除したら戻せない。n8n_workflow_versions でバージョン管理していても、WF自体を消したら全バージョンが消える。
対策: 削除する前に n8n_get_workflow でJSONをエクスポートしておく。あるいはそもそも削除せずinactiveにする。
開発スタイルの変化
n8n MCPを導入してから、ワークフロー開発のスタイルが変わった。
Before:
- ターミナルでコードを書く
- ブラウザでn8n GUIを開く
- GUIでノードを配置・設定
- テスト実行ボタンを押す
- ログを確認
- ターミナルに戻る
- 1-6を繰り返す
After:
- ターミナルで全部やる
コンテキストスイッチが消えた。ブラウザとターミナルの往復で失われていた集中力が、そのまま開発に使える。
俺は現在、VPS上のDockerでn8nを動かしていて、28本のワークフローを運用している。以前はWFの修正が面倒で後回しにしがちだったが、今はターミナルから「あのWF直して」と言うだけで直る。メンテナンスのハードルが下がった結果、WFの品質が上がった。
まとめ
n8n MCPは「n8nをGUIなしで操作する」ツールだ。
ワークフローの作成・修正・テスト・デバッグ・デプロイがターミナルで完結する。ブラウザを開く回数がゼロになった。日本語の情報がほとんどないが、セットアップは5分で終わる。n8nをCLI/APIで操作したい人、CI/CDに組み込みたい人にはかなり刺さると思う。
ブラウザを閉じて、ターミナルに帰ろう。