Zum Inhalt springen
Sprache

Quickstart

Von null zum ersten Live-Trace, in wenigen Minuten

Kein Account, keine Anmeldung, keine API-Keys. Öffne die Demo, kopier eine Config, richte deinen MCP-Client darauf und sieh zu, wie sich der Trace füllt, während dein Agent Tools aufruft. HubSpot ist heute das einzige Live-Mock. Alles unten nutzt es.

1. Öffne die Demo unter /try

Geh auf /try. Dort wird sofort eine anonyme, temporäre Session erstellt: keine E-Mail, kein Passwort, keine Kreditkarte.

Diese Session zeigt aktuell auf das HubSpot-Mock: Kontakte, Firmen, Deals, Tickets und Notizen, über dieselben Tools mit denselben Namen, Beschreibungen und JSON-Schemas wie der echte HubSpot-MCP-Server. Die genaue Tool-Liste steht im Katalog. Jede Antwort ist synthetisch und deterministisch. Dahinter steckt kein echter HubSpot-Account und keine echten Daten.

2. Kopiere die Connection-Config

Die Demo gibt dir ein fertiges Snippet, im Format eines claude_desktop_config.json-Eintrags:

claude_desktop_config.json
{
  "mcpServers": {
    "mockd-hubspot": {
      "url": "https://mock.mock-d.com/s/<session-token>/mcp"
    }
  }
}
  • "url" ist dein persönlicher Mockd-Endpunkt für diesen Lauf. Er spricht MCP genau wie ein echter Server.
  • Der Token in der Adresse identifiziert deine anonyme Session. Es ist kein API-Key für einen echten Dienst, nur ein Verweis auf deine abgeschottete Session. Behandle ihn trotzdem wie ein Geheimnis.
  • Der Name des Eintrags ist frei wählbar. Er taucht nur in deinem Client auf.

3. In deinen MCP-Client einfügen und den Agenten laufen lassen

Füge das Snippet in den mcpServers-Bereich des MCP-Clients ein, den du schon nutzt: Claude, Cursor, das OpenAI Agents SDK, LangGraph oder jeden anderen MCP-Client. Kein SDK zu installieren, kein Code zu ändern.

Lass deinen Agenten dann ganz normal laufen. Jeder Tool-Call, den er macht (Kontakte suchen, einen Deal anlegen, eine Notiz hinzufügen), wird an den Mockd-Endpoint geleitet und mit realistischen, deterministischen Daten beantwortet, statt einen echten HubSpot-Account anzufassen.

4. Trace beobachten, dann einen Fehler injizieren

Öffne den Trace-Viewer und sieh zu, wie die Calls eintreffen, während dein Agent sie macht: die genauen Argumente, die er gesendet hat, die Antwort, die zurückkam, sowie Latenz und Status jedes Calls.

Um zu sehen, wie dein Agent mit rauen Kanten umgeht, injizierst du auf Abruf einen Fehler: ein Rate-Limit (HTTP 429), einen Timeout, ein leeres Ergebnis oder zusätzliche Latenz. Beobachte im selben Trace, ob er es erneut versucht und sich fängt.

Und dann? Dein eigener Server, gleicher Trace-Viewer

Hast du schon einen eigenen MCP-Server? Bring Your Own MCP wird denselben Endpunkt auf ihn richten und jeden Call im selben Trace-Viewer aufzeichnen, den du gerade benutzt hast. Das wird gerade gebaut und ist noch nicht nutzbar. Der Stand steht auf der Roadmap.

Was heute schon geht: Der Trace-Viewer ist die zentrale Stelle, um jeden Tool-Call deines Agenten nachzuvollziehen, und die Mocks, gegen die er läuft, sind live.