MockzillaMockzilla

MCP-Server für KI-Agenten

Aktualisiert 29. Sept. 2026·6 Min. Lesezeit

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 gibt dir die URL zurück, ohne dass du den Editor verlässt.

Er läuft über npx und braucht Node 18 oder neuer. Sonst musst du nichts installieren. 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: info fasst eine Spec oder ein .mockz-Paket samt vollständiger Pfadliste zusammen, lint findet Schemas, die keine Antwort erfüllen kann, 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 und kann bei einer einzelnen Spec Latenz oder Fehlerantworten einbauen. stop_locally stoppt ihn, und call_endpoint schickt einen Request, damit der Agent dir die Antwort zeigen kann.
  • Mocken ohne Spec: mock_endpoint legt für einen einzelnen Pfad eine Antwort fest, die du beschreibst. Daneben stehen list_mock_endpoints und clear_mock_endpoints.
  • Die Doku lesen: mockzilla_docs_topics, mockzilla_docs_search und mockzilla_docs_read geben dem Agenten die Doku dieser Website und die Engine-Doku. Sie kommen mit der Bridge, also braucht das Lesen weder Internetzugang noch eine Anmeldung.

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

Dein Konto verbinden

Sobald du angemeldet bist, 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.

Bitte deinen Agenten, dich bei Mockzilla anzumelden, oder bitte ihn um etwas Gehostetes. Er ruft das Werkzeug login auf, und dein Browser öffnet die Mockzilla-Anmeldung.

Melde dich an, falls du es noch nicht bist.

Die Mockzilla-Anmeldung

Wähle die Organisation, in der der Agent arbeiten soll.

Die Organisationsauswahl

Wähle Nur lesen oder Lesen und schreiben. Mit Lesen und schreiben darf der Agent deployen. Als Viewer kannst du nur „Nur lesen“ wählen.

Die Zugriffsauswahl

Klicke auf Erlauben.

Die Seite vor dem Klick auf Erlauben

Die Anmeldung bleibt auf deinem Rechner und erneuert sich selbst, du machst das also nur einmal.

Sobald du angemeldet bist, kann dein Agent diese Werkzeuge nutzen:

  • get_context meldet, mit welcher Organisation und welchem Zugriff der Agent arbeitet.
  • list_sims blättert durch die Simulationen, die du sehen kannst, mit ihren URLs und Status.
  • list_catalog_products durchsucht den Katalog.
  • wait_for_deploy wartet, bis ein Deploy aktiv ist, und gibt seine Live-URL zurück.
  • 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. Die kann nur eine Anmeldung mit Lesen und schreiben nutzen.

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

Um Organisation oder Zugriff zu wechseln, bitte den Agenten, dich abzumelden. Er ruft dafür logout auf. Melde dich danach neu an. Jede App, die du verbunden hast, steht in den Einstellungen im Tab Verbundene Apps, wo du sie auch widerrufen kannst.

Stattdessen einen API-Schlüssel verwenden

Ein Rechner ohne Browser, etwa ein CI-Runner oder ein entfernter Server, kann die Anmeldeseite nicht öffnen. Gib dem Agenten dort einen API-Schlüssel.

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.

Ein Schlüssel für den Agenten
API-Schlüssel gehören zu Plänen, die sie enthalten.

Ü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_..." }
    }
  }
}

Mit gesetztem Schlüssel fragt der Agent nie nach einer Anmeldung.

Einstellungen

Diese Umgebungsvariablen sind alle optional:

  • MOCKZILLA_TOKEN ist ein API-Schlüssel, den der Agent statt einer Anmeldung verwendet.
  • MOCKZILLA_NO_BROWSER auf 1 gesetzt hält login davon ab, einen Browser zu öffnen. Der Agent gibt dir stattdessen den Anmeldelink.
  • 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

Die Bridge legt die CLI, die sie installiert hat, und die Endpunkte, die mock_endpoint geschrieben hat, unter ~/.cache/mockzilla-mcp/ ab. 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.

Deine Anmeldung liegt unter ~/.config/mockzilla-mcp/. Beim Abmelden wird sie gelöscht.

Wie es weitergeht

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

War diese Seite hilfreich?