KI-Agent verbinden (MCP)

Was der MCP-Server ist

Der dForge-MCP-Server (@dforge-core/dforge-mcp) stellt die gesamte Moduloberfläche einem KI-Agenten als strukturierte Tools bereit. Statt das Modell Metadaten-JSON von Hand schreiben zu lassen und auf Gültigkeit zu hoffen, ruft der Agent echte, typisierte Tools auf — Entität hinzufügen, Feld hinzufügen, Ansicht bauen, Rolle verdrahten, Aktion schreiben, verpacken, installieren — jeweils gegen die kanonischen dForge-Schemas validiert.

Er funktioniert mit jedem MCP-fähigen Editor: Claude Code, Cursor, Zed und weiteren. Der Server bringt einen Wizard-Skill (dforge-mcp-author) mit, der den Agenten durch einen geführten, sechsphasigen Authoring-Ablauf leitet.

Lieber ein vollständig integriertes Editor-Erlebnis? Die VS-Code-Erweiterung bündelt dieselbe Tool-Oberfläche hinter Seitenleiste und Chat — beginnen Sie dort, wenn Sie in VS Code arbeiten. Diese Anleitung beschreibt das Einbinden des MCP-Servers in jeden anderen KI-Agenten.

Einfach ausprobieren, ganz ohne Einrichtung? Sie müssen nichts installieren. Die browserbasierte Vorlage öffnet eine fertige Cloud-Arbeitsumgebung, in der MCP-Server und Authoring-Skill bereits verdrahtet sind — beschreiben Sie einfach Ihr Modul und los geht’s. Diese Anleitung ist für das Ausführen derselben Tools in Ihrem lokalen Editor.

Bevor Sie beginnen

1. Node.js 18+ auf Ihrem PATH — der Server läuft über npx.
2. Ein MCP-fähiger KI-Editor — Claude Code, Cursor oder Zed.
3. Ein dForge-Mandant zum Installieren — nur dessen Web-Adresse. Beim Installieren melden Sie sich über den Browser an (siehe unten); es gibt kein API-Token zu kopieren.

Sie müssen die CLI nicht separat installieren. Das native dforge-cli-Binary, das verpackt und installiert, ist als Abhängigkeit des MCP-Servers enthalten.

In Claude Code installieren

Der empfohlene Weg schreibt die Konfiguration für Sie:

claude mcp add dforge --scope user -- npx -y @dforge-core/dforge-mcp

Damit wird der Server an ~/.claude.json (Ihre globale Konfiguration) angehängt. Starten Sie Claude Code neu; die erste Sitzung, die den Server aktiviert, fragt „Approve MCP server ‘dforge’?“ — bestätigen Sie das.

Manuell — pro Projekt

Wenn Sie den Server lieber auf ein Repo beschränken, schreiben Sie eine .mcp.json im Repo-Stammverzeichnis (nicht unter .claude/):

{
  "mcpServers": {
    "dforge": {
      "command": "npx",
      "args": ["-y", "@dforge-core/dforge-mcp"]
    }
  }
}

Starten Sie Claude Code neu und bestätigen Sie bei der ersten Abfrage.

Verbindung prüfen

claude mcp list
# dforge — npx -y @dforge-core/dforge-mcp — connected

Oder tippen Sie in einer Sitzung /mcp, um verbundene Server und ihre Tools aufzulisten. Sie sollten den dforge_*-Toolsatz sehen.

Den Authoring-Skill installieren

Der MCP-Server bringt einen Wizard-Skill mit, der dem Agenten jede dForge-Konvention beibringt — er wird jedoch nicht automatisch installiert: Claude Code sucht Skills in ~/.claude/skills/, nicht in node_modules. Synchronisieren Sie ihn einmalig:

# Aktuelle veröffentlichte Version ermitteln und die CDN-URL darauf festnageln
# (der @latest-CDN-Alias cacht stundenlang und kann veraltete Inhalte liefern).
VERSION=$(npm view @dforge-core/dforge-mcp version)
BASE="https://cdn.jsdelivr.net/npm/@dforge-core/dforge-mcp@${VERSION}/skills/dforge-mcp-author"

mkdir -p ~/.claude/skills/dforge-mcp-author
curl -fsSL "$BASE/SKILL.md" -o ~/.claude/skills/dforge-mcp-author/SKILL.md

Starten Sie Claude Code neu. Mit dem Skill an Ort und Stelle greift der Agent automatisch darauf zu, sobald Sie ihn bitten, ein Modul zu bauen.

Bei Ihrem Mandanten anmelden

Das Verpacken läuft offline, das Installieren benötigt jedoch einen Ziel-Mandanten. Melden Sie sich einmal mit der mitgelieferten CLI an — sie öffnet Ihren Browser, Sie loggen sich wie gewohnt ein, und die Sitzung wird lokal pro Mandant gespeichert:

npx @dforge-core/dforge-cli auth login --url https://ihr-mandant.dforge.app

Sie übergeben nur die Web-Adresse Ihres Mandanten — die Auth- und API-Endpunkte werden für Sie ermittelt. Es gibt keinen API-Schlüssel und kein Token zu kopieren. Danach nutzen die Installationsaufrufe des Agenten die gespeicherte Sitzung; führen Sie den Befehl erneut aus, falls sie abläuft.

Cursor und Zed

Beide verwenden dieselbe command- + args-Form — npx -y @dforge-core/dforge-mcp — in ihren eigenen MCP-Konfigurationsdateien; den genauen Ort finden Sie in der Doku des jeweiligen Editors. Prüfen Sie über deren Tool-Listen und synchronisieren Sie den Skill auf die gleiche Weise, sofern der Editor Skills unterstützt.

Jetzt ein Modul bauen

Mit verbundenem Server und installiertem Skill beschreiben Sie einfach, was Sie brauchen:

„Baue mir einen Support-Ticket-Tracker mit Priorität, einem SLA-Timer und Zuweisung an einen Benutzer.“

Der Agent durchläuft den geführten Ablauf — Intake, Entitäten und Felder, Verhalten, Ansichten, Sicherheit —, hält an jedem Gate für Ihre Freigabe an und verpackt und installiert anschließend. Eine Beschreibung der sechs Phasen und ihrer Ergebnisse finden Sie unter Module mit der VS-Code-Erweiterung erstellen — derselbe Ablauf läuft über MCP.

Verwandt

• Module mit der VS-Code-Erweiterung erstellen — derselbe Authoring-Ablauf in VS Code
• Erste Schritte — Registrieren, ein Modul installieren und die Grundlagen
• Kernkonzepte — Entitäten, Ansichten, Ordner, Rollen und das Metadatenmodell
• Sicherheitsmodell — Rollen, Berechtigungen und Ordner-Scoping