MCP-Setup: Merlin Project mit Antigravity verbinden

Antigravity ist der agentische Editor von Google und nutzt für MCP-Server dieselbe Art Konfiguration wie Claude Desktop: einen Block in einer JSON-Datei, der dem Editor sagt, welches Programm er starten soll. Eine Eigenheit unterscheidet Antigravity von den anderen Clients. Es liest diese Datei nur beim Start, und wer nach dem Speichern keine Verbindung sieht, sucht den Fehler deshalb oft in einer Datei, die längst stimmt. Nachlesen können Sie hier den Klickpfad zur Konfiguration, den Block zum Kopieren und den Neustart, ohne den nichts passiert.

Das Video zum Artikel

Das brauchen Sie

• Merlin Project in der aktuellen Version, MCP-Server installiert, Projekt freigegeben
• Antigravity für den Mac

Die Merlin-Seite ist bei allen Clients gleich:

1. Server installieren. Wählen Sie in Merlin Project im Menü Merlin Project den Punkt MCP-Server installieren. Merlin legt ein kleines Programm auf Ihrem Mac ab, die Brücke zwischen KI-Client und Plan. Den Pfad zeigt der Installer an; er lautet /usr/local/bin/merlinproject-mcp.
2. Projekt freigeben. Öffnen Sie das Projekt und klicken Sie in der Symbolleiste auf KI-Tools. Setzen Sie das Häkchen bei KI-Tools Interaktion mit Dokument erlauben; das Symbol wird ausgefüllt dargestellt. Die Freigabe gilt nur für dieses eine Projekt, alle anderen bleiben für den Server unsichtbar. Sobald ein Client verbunden ist, färbt sich das Symbol blau.

lokal · read-only · nicht aus der Ferne erreichbar. Der Server liest nur die Projekte, die Sie freigeben, ändert nichts an Ihren Daten, und von außen kommt niemand an ihn heran. Was ein Cloud-Client von den gelesenen Daten sieht, erklärt der Artikel zum Datenschutz.

Schritt 1: die Config eintragen

Der Weg zur Konfigurationsdatei führt über die Agent-Sitzung:

1. Öffnen Sie in Antigravity eine Agent-Sitzung.
2. Klicken Sie im Seitenpanel auf das Menü … und wählen Sie MCP Servers.
3. Klicken Sie oben im MCP Store auf Manage MCP Servers und anschließend auf View raw config. Die Datei mcp_config.json öffnet sich.
4. Ergänzen Sie den folgenden Block und speichern Sie.

Config-Block für merlin-project mcp_config.json

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

Ergänzen Sie die Datei nur. Steht schon etwas darin, löschen Sie nichts davon, sonst verliert Antigravity andere Server, die Sie bereits eingerichtet haben.

Schritt 2: Antigravity neu starten

Speichern Sie, und schauen Sie in die MCP-Liste: Merlin fehlt. Die Config steht, und Antigravity zeigt keine Verbindung. Der Grund: Antigravity liest diese Datei nur beim Start. Solange die App läuft, weiß sie von Ihrem Eintrag nichts, egal wie oft Sie speichern.

Deshalb ist der zweite Schritt ein kompletter Neustart. Fenster schließen reicht nicht; beenden Sie Antigravity über Cmd+Q und öffnen Sie es neu. Danach steht merlin-project in der Liste der verbundenen Server. Wer diesen Schritt auslässt, sieht keine Verbindung und sucht den Fehler in einer Datei, die längst stimmt.

Die erste Frage: eine Phase als Checkliste

Nach dem Neustart können Sie fragen. Im Video wird eine Vorgangsgruppe als Checkliste ausgegeben, so dass sie direkt ans Team gehen kann:

Prompt: Wie mache ich aus einer Phase eine Checkliste?

Exportiere alle Vorgänge der Gruppe {PHASE} aus dem aktiven Projekt als Markdown-Checkliste: eine Zeile je Vorgang mit Checkbox, zugewiesener Ressource und Datum. Markiere bereits abgeschlossene Vorgänge als erledigt. Die Liste soll sich direkt in Notizen oder ein Wiki einfügen lassen.

Zum Prompt in der Bibliothek ›

Ersetzen Sie den Platzhalter durch den Namen der Phase, etwa „4 Go-to-Market". Antigravity liest die Vorgänge, die Zuweisungen und den Fortschritt aus dem Plan und liefert Checkliste und Tabelle, beides direkt weiterverwendbar.

Wenn trotz Neustart nichts zu sehen ist

• JSON prüfen. Ein fehlendes Komma reicht, damit Antigravity die Datei verwirft. Block von dieser Seite kopieren.
• Pfad prüfen. Der Installer in Merlin Project zeigt den Pfad an; er muss exakt mit dem Wert in der Datei übereinstimmen.
• Freigabe prüfen. Ist das Projekt in Merlin über „KI-Tools" freigegeben?
• Wirklich beendet? Ein rotes Schließen-Symbol beendet die App nicht. Im Dock prüfen, ob Antigravity noch läuft, dann Cmd+Q.

Checkliste

Zum Üben eignet sich das Beispielprojekt Produktlaunch Phoenix. Weitere Exportformate stehen in der Prompt-Bibliothek. Alle Setup-Anleitungen:

• Claude Desktop: Ein Block in einer Datei, Neustart
• LM Studio: Modell laden, ein Block in einer Datei
• Claude Code: Ein Befehl
• Codex: Ein Befehl
• Antigravity (dieser Artikel): Ein Block in einer Datei, kompletter Neustart
• ChatGPT: Kopierbrücke oder Intelligenter Assistent
• Welcher KI-Client passt zu Ihnen?

Haben Sie Fragen zu diesem Blogartikel oder möchten darüber diskutieren, freuen wir uns auf Ihren Beitrag bei uns im Forum.