Der Merlin Project MCP-Server

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Assistenten eine strukturierte und sichere Verbindung zu externen Anwendungen ermöglicht. Statt Screenshots einzufügen oder Daten manuell hin- und herzukopieren, kann Ihr KI-Assistent Informationen direkt aus Merlin Project auslesen – das aktive Projekt einsehen, Vorgänge, Meilensteine, Ressourcen oder Zuweisungen abfragen und diesen Kontext nutzen, um Ihre Fragen zu beantworten oder Berichte für Sie zu erstellen.

Typische Anwendungsfälle

In der Regel müssen Sie nicht angeben, welches Tool die KI aufrufen soll – das entscheidet der KI-Assistent anhand Ihrer Eingabe selbst. Hier einige Beispiele für Anfragen, die Sie stellen können:

Fassen Sie den aktuellen Status des aktiven Projekts zusammen und heben Sie erreichte Meilensteine sowie bevorstehende Termine hervor.
Erstellen Sie aus den aktuellen Projektdaten einen Statusbericht oder ein Stakeholder-Update.
Identifizieren Sie Vorgänge, die nach aktueller Planung in Verzug zu geraten drohen.
Listen Sie alle nicht zugewiesenen Vorgänge oder alle Vorgänge einer bestimmten Ressource auf.
Erklären Sie den kritischen Pfad und welche Vorgänge das Projektende bestimmen.
Prüfen Sie das Projekt auf Inkonsistenzen, etwa fehlende Abhängigkeiten oder unrealistische Dauern.
Übersetzen Sie alle Vorgangstitel des aktuellen Projekts in eine andere Sprache (nur als Ausgabe).
Exportieren Sie alle Vorgänge einer ausgewählten Gruppe als Checkliste oder Markdown-Tabelle.

Die obigen Beispiele sind nur Anregungen. Eine gute Aufforderung enthält in der Regel mehr Details, gliedert die Aufgabe in klar definierte Schritte, gibt Regeln für den KI-Assistenten vor und schlägt vor, wie sich das Ergebnis überprüfen lässt.

Sicherheit

Der MCP-Server läuft lokal auf Ihrem Mac und ist nicht aus der Ferne erreichbar. Jeder Aufruf wird lokal von Merlin Project selbst verarbeitet, und die Ergebnisse werden zur weiteren Verarbeitung an den KI-Assistenten zurückgegeben. Sie behalten die volle Kontrolle darüber, wann und wie sich externe KI-Assistenten verbinden dürfen.

Zugriff auf ein Projekt freigeben

Standardmäßig sind die Inhalte eines Merlin-Projekt-Dokuments für keinen KI-Assistenten verfügbar – auch dann nicht, wenn der MCP-Server installiert ist und läuft. Der Zugriff muss für jedes Projekt, das ein KI-Assistent auslesen soll, ausdrücklich freigegeben werden.

Um den Zugriff für das aktive Dokument freizugeben, klicken Sie in der Symbolleiste des Dokuments auf KI-Tools. Es öffnet sich ein Dialog mit einer Auswahlbox, über die Sie den Zugriff für MCP-Server erlauben können. Sobald die Box aktiviert ist, wird das Symbol in der Symbolleiste ausgefüllt dargestellt und zeigt damit an, dass der Zugriff aktiv ist. Während ein KI-Assistent gerade über einen MCP-Server mit dem Projekt verbunden ist, erscheint das Symbol zusätzlich in einer blauen Akzentfarbe .

Sie können den Zugriff jederzeit wieder entziehen, indem Sie das Popover erneut öffnen und die Auswahlbox deaktivieren.

So verbinden Sie Ihren KI-Assistenten

Die folgenden Abschnitte beschreiben, wie Sie den Merlin Project MCP-Server mit verschiedenen KI-Assistenten verbinden.

Claude Desktop

Öffnen Sie in der Claude-Desktop-App Claude Einstellungen Entwickler und klicken Sie auf Config bearbeiten.
Die Datei claude_desktop_config.json wird im Finder hervorgehoben
Öffnen Sie die Datei mit einem Texteditor wie TextEdit.

Fügen Sie folgenden Eintrag in die Datei ein und speichern Sie:

{
  "mcpServers": {
    "merlin-project": {
      "command": "/usr/local/bin/merlinproject-mcp"
    }
  }
}

Falls die Datei bereits Inhalte enthält – etwa andere MCP-Server, Einstellungen oder weitere Konfiguration – überschreiben Sie sie nicht. Lassen Sie alle vorhandenen Schlüssel auf oberster Ebene unverändert, stellen Sie sicher, dass dort ein "mcpServers"-Objekt existiert (legen Sie es ggf. an), und fügen Sie den Eintrag "merlin-project" darin ein – durch ein Komma von vorhandenen Geschwistereinträgen getrennt. So bleibt die Datei gültiges JSON. Ist die Datei leer oder noch nicht vorhanden, können Sie den obigen Ausschnitt unverändert einfügen.

Beenden Sie die Claude-Desktop-App und starten Sie sie neu.

Claude Code

Claude Code muss installiert sein und in Ihrem Terminal laufen, bevor Sie eine Verbindung zum Merlin Project MCP-Server herstellen können. Falls Sie Claude Code noch nicht eingerichtet haben, installieren Sie es zuerst.

Installieren Sie den Merlin MCP-Server über Hauptmenü Merlin Project MCP-Server installieren.
Verbinden Sie Claude Code mit dem Merlin Project MCP-Server, indem Sie folgenden Befehl im Terminal ausführen:
```
claude mcp add --transport stdio merlin-project -- /usr/local/bin/merlinproject-mcp
```
Überprüfen Sie, ob Claude Code mit dem Server verbunden ist:
```
claude mcp get merlin-project
```

Visual Studio Code

Installieren Sie den Merlin MCP-Server über Hauptmenü Merlin Project MCP-Server installieren.
Drücken Sie ⌘+⇧+P, um die Befehlspalette zu öffnen, und geben Sie MCP Add ein.
Wählen Sie die Option MCP: Add Server.
Wenn der Server-Typ abgefragt wird, wählen Sie Command (stdio).
Fügen Sie als auszuführenden Befehl folgenden Pfad ein:
```
/usr/local/bin/merlin-project
```
Vergeben Sie einen Namen für den Server, zum Beispiel merlin-project.
Drücken Sie ⌘+⇧+I, um einen neuen Copilot-Chat im Agent-Modus zu öffnen.

Cursor

Installieren Sie den Merlin MCP-Server über Hauptmenü Merlin Project MCP-Server installieren.
Öffnen Sie Cursor Preferences Cursor Settings.
Wechseln Sie zum Tab Tools & MCPs.
Klicken Sie auf New MCP Server.

Fügen Sie folgenden Eintrag in die automatisch erzeugte Datei mcp.json ein:

{
  "mcpServers": {
    "merlin-project": {
      "command": "/usr/local/bin/merlinproject-mcp"
    }
  }
}

Falls die Datei bereits Inhalte enthält – etwa andere MCP-Server, Einstellungen oder weitere Konfiguration – überschreiben Sie sie nicht. Lassen Sie alle vorhandenen Schlüssel auf oberster Ebene unverändert, stellen Sie sicher, dass dort ein "mcpServers"-Objekt existiert (legen Sie es ggf. an), und fügen Sie den Eintrag "merlin-project" darin ein – durch ein Komma von vorhandenen Geschwistereinträgen getrennt. So bleibt die Datei gültiges JSON. Ist die Datei leer oder noch nicht vorhanden, können Sie den obigen Ausschnitt unverändert einfügen.

Codex

Installieren Sie den Merlin MCP-Server über Hauptmenü Merlin Project MCP-Server installieren.
Verbinden Sie Codex mit dem Merlin Project MCP-Server, indem Sie folgenden Befehl ausführen:
```
codex mcp add merlin-project -- /usr/local/bin/merlinproject-mcp
```
Starten Sie Codex, geben Sie /mcp ein und überprüfen Sie, ob der Merlin Project MCP-Server als aktiv aufgeführt wird.

Antigravity

Installieren Sie den Merlin MCP-Server über Hauptmenü Merlin Project MCP-Server installieren.
Öffnen Sie eine Agent-Sitzung in Antigravity.
Klicken Sie auf das Menü … oben im Seitenpanel und wählen Sie MCP Servers.
Klicken Sie oben im MCP Store auf Manage MCP Servers und anschließend auf View raw config.

Ergänzen Sie die Datei mcp_config.json um folgenden Eintrag:

{
  "mcpServers": {
    "merlin-project": {
      "command": "/usr/local/bin/merlinproject-mcp"
    }
  }
}

Falls die Datei bereits Inhalte enthält – etwa andere MCP-Server, Einstellungen oder weitere Konfiguration – überschreiben Sie sie nicht. Lassen Sie alle vorhandenen Schlüssel auf oberster Ebene unverändert, stellen Sie sicher, dass dort ein "mcpServers"-Objekt existiert (legen Sie es ggf. an), und fügen Sie den Eintrag "merlin-project" darin ein – durch ein Komma von vorhandenen Geschwistereinträgen getrennt. So bleibt die Datei gültiges JSON. Ist die Datei leer oder noch nicht vorhanden, können Sie den obigen Ausschnitt unverändert einfügen.

Speichern Sie die Datei und starten Sie Antigravity neu, damit der MCP-Server geladen wird.