Dokumentation

MCP Fusion/Integrations and federation/n8n-Konnektor

n8n-Konnektor

Frag die KI über Vinkius

Stellen Sie markierte n8n-Workflows als MCP-Tools bereit: Webhooks automatisch erkennen, Eingabeschemas ableiten und die Tool-Liste des Agents bei Änderungen aktualisieren.

n8n enthält die Automatisierungslogik bereits. MCP Fusion macht diese Workflows zu einem agentenorientierten Konnektor, ohne dass Sie jeden Workflow in TypeScript neu schreiben müssen. Das n8n-Paket entdeckt Webhooks, leitet ihre Eingabeform ab und erzeugt gruppierte Tools.

Markierte Workflows automatisch erkennen

typescript
import { createN8nConnector } from '@mcpfusion/n8n';

const n8n = await createN8nConnector({
  url: process.env.N8N_URL!,
  apiKey: process.env.N8N_API_KEY!,
  includeTags: ['ai-enabled'],
  pollInterval: 60_000,
  onChange: () => server.notification({
    method: 'notifications/tools/list_changed',
  }),
});

for (const tool of n8n.tools()) {
  registry.register(defineTool(tool.name, tool.config));
}

Die Quellkonfiguration ist bewusst klein: url und apiKey sind erforderlich; includeTags, excludeTags, timeout, pollInterval und onChange sind optional. Die Tag-Filterung erfolgt während der Erkennung, daher gelangen interne Workflows nie in die Oberfläche des Konnektors.

Was die Erkennung tut

WorkflowDiscovery liest die n8n-Workflows und identifiziert webhook-ausgelöste Abläufe. inferSchema wandelt die Webhook-Payload in Parameterdefinitionen um. synthesizeTool erstellt ein Tool und synthesizeAll erstellt die vollständige Menge. toToolName gibt dem Workflow einen deterministischen MCP-Namen.

Wenn die Abfrage einen geänderten Workflow erkennt, rufen Sie notifications/tools/list_changed über onChange auf. Der Client lädt die Oberfläche neu, ohne den Konnektorcode erneut bereitzustellen.

Manuelle Tool-Definition

Die Erkennung ist praktisch, aber einen stabilen öffentlichen Vertrag schreiben Sie möglicherweise besser von Hand:

typescript
import { defineN8nTool } from '@mcpfusion/n8n';

const sendInvoice = defineN8nTool({
  name: 'billing.send_invoice',
  workflowId: 'workflow_42',
  webhookPath: 'billing/send-invoice',
  method: 'POST',
  description: 'Send an invoice through the approved workflow',
  params: {
    invoice_id: { type: 'string', required: true },
    notify_customer: { type: 'boolean', required: false },
  },
  tags: ['billing'],
});

Die manuelle Konfiguration akzeptiert workflowId, webhookPath, die optionale HTTP-Methode, description, params, annotations und tags. Sie bestimmen den Tool-Namen und das Schema; n8n übernimmt die Workflow-Ausführung.

Sicherheitsgrenze

Der API-Schlüssel ist eine Konnektor-Anmeldedaten, kein Modellargument. Speichern Sie ihn mit BYOC credentials, niemals in einem Prompt oder einem generierten Tool-Schema. Ergänzen Sie Authentifizierungs-Middleware um die erzeugten Tools, filtern Sie Tags nach Bereitstellung und binden Sie Presenters ein, wenn ein Workflow Domänendatensätze zurückgibt. n8n leitet Ihre Tenant-Richtlinie nicht automatisch ab und redigiert keine beliebigen Antwortfelder.

Nächste Schritte