MCP-Server für KI-Agenten

Mockzilla bringt einen MCP-Server mit, damit ein Coding-Agent Mock-APIs für dich startet. Bitte ihn, eine Spec zu mocken, und er installiert die CLI, startet einen Server und reicht dir die URL, ohne dass du den Editor verlässt.

Er läuft über npx und braucht Node 18 oder neuer. Sonst nichts. Die lokale Hälfte funktioniert ganz ohne Mockzilla-Konto.

In deinen Agenten einbauen

Claude Code:

claude mcp add -s user mockzilla -- npx -y @mockzilla/mcp@latest

Gemini CLI:

gemini mcp add -s user mockzilla npx -y @mockzilla/mcp@latest

Claude Desktop und Cursor nehmen eine Konfigurationsdatei. Bei Claude Desktop ist das ~/Library/Application Support/Claude/claude_desktop_config.json, bei Cursor ~/.cursor/mcp.json, und beide wollen denselben Block:

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

Starte die App nach dem Bearbeiten neu. In Cursor geht es auch über Settings -> MCP Servers -> Add new MCP server.

Lass @latest im Befehl stehen. Ohne das nutzt npx weiter die Version, die es zuerst aufgelöst hat, und auch ein Neustart holt keine neuere.

Was dein Agent ohne Konto kann

Alles davon läuft auf deinem eigenen Rechner:

• Einrichten: check_cli sucht die CLI auf deinem Rechner, install_cli holt sie in den eigenen Cache der Bridge, und bridge_status meldet, ob eine neuere Bridge veröffentlicht wurde.
• Specs lesen: peek_openapi fasst eine zusammen, info gibt ihre vollständige Pfadliste aus, und discover_specs durchsucht einen Ordner und meldet, was sich daraus mocken lässt.
• Specs umformen: simplify kürzt eine Spec, die zu schwer zum sauberen Mocken ist, und pack macht aus einem Ordner voller Services ein .mockz-Archiv.
• Mocks ausführen: serve_locally startet einen Server über eine oder mehrere Specs, stop_locally stoppt ihn, und call_endpoint schickt eine Anfrage, damit der Agent dir die Antwort zeigen kann.
• Mocken ohne Spec: mock_endpoint pinnt einen einzelnen Pfad auf eine Antwort, die du beschreibst, daneben stehen list_mock_endpoints und clear_mock_endpoints.
• Die Engine-Doku lesen: mockzilla_docs_topics, mockzilla_docs_search und mockzilla_docs_read, damit Antworten zur Konfiguration aus der Dokumentation kommen und nicht aus dem Gedächtnis des Modells.

install_cli fasst deinen PATH nie an. Es hält seine eigene Kopie, eine brew-Installation bleibt also unberührt.

Dein Konto verbinden

Mit einem Schlüssel erreicht der Agent auch deine Organisation: Er kann auflisten, was du deployt hast, den Katalog durchsuchen und eine gehostete Simulation deployen, die weiter antwortet, wenn der Agent längst aufgehört hat.

Lege zuerst den Schlüssel an. Öffne Einstellungen, dann den Tab API-Schlüssel, und klicke auf Schlüssel erstellen. Gib ihm die Rolle Editor, wenn der Agent deployen soll, Viewer, wenn er nur lesen soll. Der Schlüssel wird nur einmal angezeigt.

Übergib ihn dann als MOCKZILLA_TOKEN. In Claude Code:

claude mcp add -s user mockzilla -e MOCKZILLA_TOKEN=mz_... -- npx -y @mockzilla/mcp@latest

In einer Konfigurationsdatei:

{
  "mcpServers": {
    "mockzilla": {
      "command": "npx",
      "args": ["-y", "@mockzilla/mcp@latest"],
      "env": { "MOCKZILLA_TOKEN": "mz_..." }
    }
  }
}

Sieben weitere Werkzeuge erscheinen, sobald er gesetzt ist:

• get_context meldet, auf welche Organisation und welche Rolle der Schlüssel läuft.
• list_sims blättert durch die Simulationen, die du sehen kannst, mit ihren URLs und Status.
• list_catalog_products durchsucht den Katalog.
• deploy_mock_from_catalog, deploy_mock_from_spec und deploy_mock_from_url legen eine gehostete Simulation an, aus einem Katalogeintrag, einer eingefügten Spec oder einer Spec-URL.
• wait_for_deploy wartet, bis eine davon aktiv ist, und gibt ihre Live-URL zurück.

Ein Deploy durch einen Agenten ist ein Deploy wie jeder andere: Er zählt gegen deinen Plan und taucht in der App auf.

Einstellungen

Vier Umgebungsvariablen, alle optional:

• MOCKZILLA_TOKEN ist dein API-Schlüssel. Die gehosteten Werkzeuge erscheinen nur, wenn er gesetzt ist.
• MOCKZILLA_MCP_URL schickt gehostete Aufrufe an eine andere Adresse als https://platform.mockzilla.org/mcp/.
• MOCKZILLA_BIN_VERSION legt fest, welche CLI-Version install_cli holt. Standardmäßig folgt sie der Bridge.
• MOCKZILLA_MANAGED_PORT ist der bevorzugte Port für den mock_endpoint-Server, standardmäßig 2200. Ist er belegt, wird ein freier genommen.

Wo seine Dateien liegen

Alles, was die Bridge behält, liegt unter ~/.cache/mockzilla-mcp/: die CLI, die sie installiert hat, und die Endpunkte, die mock_endpoint geschrieben hat. Diesen Ordner zu löschen setzt sie vollständig zurück, und eine brew-Installation der CLI ist davon nicht betroffen.

Willst du nur die gemockten Endpunkte loswerden, lass den Agenten clear_mock_endpoints ausführen.

Wie es weitergeht

• CLI-Referenz
• Aus dem Katalog starten
• Deploy und URLs

Die Bridge ist Open Source: mockzilla/mockzilla-mcp.