MCP-Anfragen

Eine MCP-Anfrage ist ein gesicherter Aufruf an einen der MCP-Server des Arbeitsbereichs: ein Tool-Aufruf, das Lesen einer Ressource, ein Prompt oder eine beliebige JSON-RPC-Methode. Sichere die Aufrufe, die du oft machst, füge Prüfungen hinzu und führe sie in der Ausführung aus wie jede andere Anfrage.

Aufruf auf der Seite „MCP-Server“ ausprobierenCopy Anchor Link

Am schnellsten beginnst du direkt am Server:

1. Öffne die Seite MCP-Server und wähle einen Server, etwa Alpenglow MCP, der auf https://demo.echolot.dev/mcp zeigt.
2. Wähle Prüfung, falls er noch nicht geprüft wurde. Die Seite listet die Tools, Ressourcen und Prompts des Servers auf.
3. Klicke auf ein Tool, eine Ressource oder einen Prompt. Ein Blatt mit den Argumenten öffnet sich.
4. Fülle sie aus, als Formular, das aus dem Eingabeschema gebaut wird, oder als JSON, und wähle Aufrufen.
5. Das Ergebnis erscheint darunter, mit Ergebnis oder Fehler und der Dauer.
6. Wähle Als Anfrage sichern, um den Aufruf mit seinen Argumenten als MCP-Anfrage zu behalten.

MCP-Anfrage erstellenCopy Anchor Link

Wähle Neuer MCP-Aufruf im Menü + neben Anfragen in der Seitenleiste. Die Leiste des Editors enthält den Aufruf:

1. Wähle den Server im Menü an ihrem Anfang. MCP-Server … im selben Menü öffnet die Seite „MCP-Server“.
2. Wähle, was aufgerufen wird: Tool, Ressource, Prompt oder Methode.
3. Tippe das Ziel: den Tool-Namen, den Ressourcen-URI, den Prompt-Namen oder eine JSON-RPC-Methode wie ping. Namen aus der letzten Prüfung des Servers werden beim Tippen unter Vom Server angeboten.
4. Wähle Aufrufen (⌘R). Während der Aufruf läuft, stoppt Abbrechen (⌘.) ihn.

Der Editor hat diese Tabs: Doku, Argumente, Variablen, Tests und Einstellungen. MCP-Anfragen haben keine eigenen Header, keine Auth und keine Skripte: Die Verbindungseinstellungen des Servers, seine Header und seine Anmeldung liegen auf der Seite „MCP-Server“. Siehe Server hinzufügen.

ArgumenteCopy Anchor Link

Der Tab Argumente enthält ein JSON-Objekt, mit {{variables}}:

{
  "query": "ultralight tent",
  "limit": 3
}

Kennt die letzte Prüfung des Servers das Tool, zeigt der Tab über dem Editor seine Beschreibung und darunter seine Felder, etwa Fields: query*, limit; ein Stern markiert ein Pflichtfeld. Aus Schema füllen ersetzt die Argumente durch jedes Feld des Eingabeschemas des Tools, als Ausgangspunkt.

Der Alpenglow-Arbeitsbereich hat zwei Aufrufe in Agent tools: search_catalog mit den obigen Argumenten und order_status, das {"order_id": "ord_7Hk2Lw"} nachschlägt.

ErgebnisseCopy Anchor Link

Der Antwortbereich zeigt das Ergebnis als JSON im Tab Body, wie jede Antwort. Das Badge in der Zusammenfassung der Antwort zeigt Ergebnis in Grün oder Fehler in Rot, mit der Protokollversion, die der Server spricht. Zeige darauf, um zu sehen, wer geantwortet hat oder was schiefging.

Ein Aufruf kann auf zwei Arten scheitern, und Echolot hält sie auseinander:

• Der Server antwortet mit einem Fehler: ein als Fehler markiertes Tool-Ergebnis oder ein JSON-RPC-Fehler. Das Badge zeigt Fehler, und der Body enthält, was der Server gesagt hat.
• Der Aufruf bekommt nie eine Antwort: Der Server ist nicht erreichbar, startet nicht oder verletzt das Protokoll. Der Antwortbereich sagt warum. Prüfe den Server auf der Seite „MCP-Server“: Sein Nachrichtenlog zeigt jede Nachricht der letzten Prüfung.

Jeder Aufruf wird im Verlauf behalten.

Prüfungen für MCPCopy Anchor Link

Im Tab Tests:

• MCP-Fehler gleich false besteht, wenn der Aufruf erfolgreich war. Ein Fehlschlag zeigt die Meldung des Servers.
• Ausgabeschema des Tools prüft den structuredContent des Ergebnisses gegen das outputSchema, das das Tool deklariert. Es schlägt fehl, wenn das Tool keines deklariert oder das Ergebnis keinen structuredContent hat.
• JSON-Wert prüft einen beliebigen Wert des Ergebnisses, etwa $.structuredContent.results.length ist größer als 0 oder $.content[0].type ist gleich text.

Alle Prüfungen und Vergleiche stehen unter Skripte und Tests.

In der BefehlszeileCopy Anchor Link

echolot run führt gesicherte MCP-Anfragen mit ihren Prüfungen aus, und echolot mcp check untersucht einen Server. Siehe echolot mcp.