MCP Playground: Führen Sie die Tools Ihrer Agenten live aus — direkt aus der Doku

Letzte Woche haben wir MCP-Tools zu einem vollwertigen API Contract gemacht: Richten Sie Archyl auf einen laufenden MCP-Server, und es entdeckt jedes Tool samt Eingabeschema — dokumentiert und mit Ihrem C4-Modell verknüpft wie jeder REST- oder GraphQL-Contract.

Das beantwortete die erste Frage: Was können meine Agenten tun?

Heute beantworten wir die zweite: Tut es das wirklich?

Der MCP Playground — ein neuer Tab auf jedem Live-MCP-Contract, mit dem Sie jedes Tool gegen den echten Server aufrufen und das echte Ergebnis inspizieren können. Kein Client-Setup, kein JSON-RPC von Hand, ohne die Architekturdoku zu verlassen.

Vom Schema zum Formular, automatisch

Öffnen Sie einen Live-MCP-Contract und Sie finden neben dem Schema einen Playground-Tab. Wählen Sie ein Tool aus der Liste — derselben durchsuchbaren Liste, die Sie dokumentiert haben — und Archyl macht aus seinem inputSchema ein Formular:

  • Strings, Zahlen und Booleans werden zu typisierten Feldern.
  • Enums werden zu Dropdowns mit den erlaubten Werten.
  • Pflichtparameter sind markiert und werden validiert, bevor irgendetwas gesendet wird.
  • Verschachtelte Objekte und Arrays bekommen ein Roh-JSON-Feld, validiert beim Absenden.

Ausfüllen, Tool ausführen klicken, und das Ergebnis kommt mit seiner Laufzeit zurück — dargestellt, wie Ergebnisse dargestellt gehören. Die Ansicht Formatiert zeigt die Antwort als sauberes, eingerücktes JSON. Die Ansicht Baum macht große Payloads navigierbar: Klappen Sie zu, was Sie nicht interessiert, und auf, was zählt. Text, Bilder und Ressourcen, die ein Tool zurückgibt, werden nativ gerendert.

Gibt das Tool einen Fehler zurück, sehen Sie genau das, was ein Agent sehen würde — Fehler-Flag und Payload, rot hervorgehoben, nie verschluckt.

Ihr Token verlässt nie Ihren Browser

Der Playground folgt demselben Sicherheitsmodell wie die Live-Discovery — und das ist es wert, wiederholt zu werden, denn genau darum geht es:

Jeder Aufruf läuft aus Ihrem Browser. Wenn Sie Tool ausführen klicken, spricht Ihr Browser direkt mit Ihrem MCP-Server. Archyls Backend ist nicht im Pfad.

  • Das Token wird nie gespeichert. Sie geben es für die Sitzung ein; es lebt auf der Seite und nirgendwo sonst.
  • Ergebnisse werden nie persistiert. Was zurückkommt, wird gerendert, gelesen — und ist weg, sobald Sie den Tab schließen.
  • Kein serverseitiger Zugriff auf Ihr Netzwerk. Da die Anfrage von Ihrer Maschine ausgeht, erreicht der Playground localhost und private Server — und es gibt keinen serverseitigen Anfragepfad, den man missbrauchen könnte.

Der einzige Kompromiss, wie bei der Discovery, ist CORS: Der Zielserver muss Archyls Origin erlauben. Für Server, die Sie kontrollieren, ist das eine Zeile Konfiguration.

Warum das wichtig ist

MCP-Tools sind die Schnittstelle, die Ihre KI-Agenten tatsächlich benutzen. Bisher bedeutete das Prüfen eines Tools: einen Client aufsetzen, einen JSON-RPC-Umschlag basteln — oder schlicht der Beschreibung vertrauen.

Jetzt ist die Dokumentation der Prüfstand:

  • Sie reviewen eine Agenten-Oberfläche? Führen Sie die Tools aus und sehen Sie echte Antwortformen, nicht beschriebene.
  • Sie debuggen einen fehlgeschlagenen Agenten-Aufruf? Reproduzieren Sie ihn in zwei Klicks mit exakt denselben Argumenten.
  • Sie onboarden jemanden auf einen Service? Schicken Sie den Contract — jedes Tool lässt sich lesen und ausprobieren.

Das meinen wir mit lebender Dokumentation. Eine Spezifikation, die ausgeführt werden kann, driftet nicht leise ab; sie fliegt in dem Moment auf, in dem sie lügt.

Dogfooding, wie immer

Archyl ist selbst ein MCP-Server — 181 Tools, Stand diese Woche. Der erste Nutzer des Playgrounds war unser eigener Contract: Wir führen list_projects, get_project_c4_model und Co. täglich gegen unseren eigenen Endpoint aus, aus unserer eigenen Doku. Der Screenshot oben ist genau das.

Probieren Sie es aus

Projekt öffnen → API Contracts → ein MCP-Contract mit Live-Endpoint → Playground. Token eingeben, Tool wählen, ausführen.

Ihre Architekturdoku hat gerade gelernt, sich auszuführen.

Testen Sie den MCP Playground auf archyl.com