n8n-mcp-tools-expert

n8n MCP ツールのエキスパートガイド

ワークフローの構築に n8n-mcp MCP サーバーのツールを使用するための総合ガイドです。

詳細ガイド

このスキルを実行する前に、詳細ガイドをお読みください。完全な手順と参考資料が記載されています。安全性、前提条件、検証要件は必須事項として扱ってください。特定の作業では該当するセクションを読み、最初から最後まで作業する場合はガイド全体をお読みください。

使用する場面

• n8n-mcp ツールセットを使用して、ノードの検索、設定の検証、ワークフローの管理を行う場合。
• 適切な MCP ツールの選択や、想定されるパラメーターと使用パターンの理解が必要な場合。
• n8n の UI だけでなく、n8n MCP を通じたワークフローの作成や編集に関するガイダンスが必要な場合。

---

ツールの使用パターン

パターン 1：ノードの検索（最も一般的）

使用例です。所要時間や成功率のベンチマークは確立されていません。

// Step 1: Search (fast!)
const results = await search_nodes({
  query: "slack",
  mode: "OR",  // Default: any word matches
  limit: 20
});
// → Returns: nodes-base.slack, nodes-base.slackTrigger

// Step 2: Get details (~18s later, user reviewing results)
const details = await get_node({
  nodeType: "nodes-base.slack",
  includeExamples: true  // Get real template configs
});
// → Returns: operations, properties, metadata

パターン 2：検証ループ

使用例です。所要時間や成功率のベンチマークは確立されていません。

// Step 1: Validate
const result = await validate_node({
  nodeType: "nodes-base.slack",
  config: {
    resource: "channel",
    operation: "create"
  },
  profile: "runtime"
});

// Step 2: Check errors (~23s thinking)
if (!result.valid) {
  console.log(result.errors);  // "Missing required field: name"
}

// Step 3: Fix config (~58s fixing)
const config = { resource: "channel", operation: "create", name: "general" };

// Step 4: Validate again
await validate_node({ nodeType: "nodes-base.slack", config, profile: "runtime" });  // Repeat until clean

パターン 3：ワークフローの編集

使用例です。所要時間や成功率のベンチマークは確立されていません。

// Iterative workflow building (NOT one-shot!)
// Edit 1
await n8n_update_partial_workflow({
  id: "workflow-id",
  intent: "Add webhook trigger",
  operations: [{type: "addNode", node: {...}}]
});

// ~56s later...

// Edit 2
await n8n_update_partial_workflow({
  id: "workflow-id",
  intent: "Connect webhook to processor",
  operations: [{type: "addConnection", source: "...", target: "..."}]
});

// ~56s later...

// Edit 3 (validation)
await n8n_validate_workflow({id: "workflow-id"});

// Only after authorized staging test, credential review and production activation approval:
await n8n_update_partial_workflow({
  id: "workflow-id",
  intent: "Activate workflow for production",
  operations: [{type: "activateWorkflow"}]
});

---

テンプレートの使用

テンプレートを検索する

// Search by keyword (default mode)
search_templates({
  query: "webhook slack",
  limit: 20
});

// Search by node types
search_templates({
  searchMode: "by_nodes",
  nodeTypes: ["n8n-nodes-base.httpRequest", "n8n-nodes-base.slack"]
});

// Search by task type
search_templates({
  searchMode: "by_task",
  task: "webhook_processing"
});

// Search by metadata (complexity, setup time)
search_templates({
  searchMode: "by_metadata",
  complexity: "simple",
  maxSetupMinutes: 15
});

テンプレートの詳細を取得する

get_template({
  templateId: 2947,
  mode: "structure"  // nodes+connections only
});

get_template({
  templateId: 2947,
  mode: "full"  // complete workflow JSON
});

テンプレートを直接デプロイする

// Deploy template to your n8n instance
n8n_deploy_template({
  templateId: 2947,
  name: "My Weather to Slack",  // Custom name (optional)
  autoFix: true,  // Auto-fix common issues (default)
  autoUpgradeVersions: true  // Upgrade node versions (default)
});
// Returns: workflow ID, required credentials, fixes applied

---

制限事項

• このスキルは、タスクが上記の範囲に明確に該当する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認してください。

インストール済みサーバーと副作用の境界

このバンドルに含まれるのは、このエントリーポイントと詳細ガイドのみです。SEARCH_GUIDE.md、VALIDATION_GUIDE.md、WORKFLOW_GUIDE.md は、外部参照として存在しません。ツール名、プロファイル、操作、返される nodeType の形式、デフォルト値は、特定の n8n-mcp サーバーにおける例であり、n8n コア API の保証ではありません。使用する前に、実際に接続されたツールと現在のスキーマやドキュメントを確認し、利用できないツールがあれば報告してください。上記の所要時間、ペイロードサイズ、成功率、テンプレート数、95％のカバレッジを示す数値は、検証されていない例示であり、測定済みのベンチマークではありません。

現在のワークフローを読み取るかエクスポートし、対象となるインスタンスやワークフローを特定して、変更前に最小限の差分を確認してください。更新時には、サニタイズやバージョンアップによって、依頼された編集の対象外のノードにも影響する場合があります。認証情報への参照を保持し、診断情報から機密情報を削除してください。テンプレートは、HTTP の送信先、式、コミュニティノード、スケジュールなどを含む、信頼できないサードパーティー製のワークフローコードです。まず内容を確認し、可能であれば非アクティブな状態でデプロイし、互換性を確認するまで自動アップグレードを無効にしてください。検証を行っても、認証情報、ビジネスロジック、実行時の安全性が保証されるわけではありません。テストによってメッセージが送信されたり、費用が発生したりする場合があります。合成のステージング用認証情報やデータを使用し、承認済みの副作用予算を守ってください。有効化、削除、本番環境への置き換えは、既存の明示的な対象範囲の承認が必要であり、自動的な最終手順にしてはなりません。