echolot mcp

echolot mcp arbeitet mit MCP-Servern in zwei Richtungen. check und sign-in sprechen mit dem Server von jemand anderem, wie es die Seite „MCP-Server“ tut. serve und setup machen deinen Arbeitsbereich zu einem MCP-Server, sodass KI-Agenten wie Claude Code oder Cursor seine Anfragen auflisten, senden und testen können; siehe Agenten.

echolot mcp checkCopy Anchor Link

echolot mcp check [--url <url>] [--header <header> ...] [--env <env> ...] [--verbose] [--timeout <seconds>] [--quality] [--strict] [--as <provider>] -- [<command> ...]

Gib mit --url einen Streamable-HTTP-Endpunkt an oder nach -- den Befehl, der einen stdio-Server startet. Echolot findet heraus, ob der Server das zustandslose Protokoll (2026-07-28) spricht oder ein früheres mit Handshake, und listet seine Tools, Ressourcen und Prompts auf:

echolot mcp check --url https://demo.echolot.dev/mcp

alpenglow-mcp 1.5.0: MCP 2025-11-25 (session, initialize)
  connected in 263 ms, round trip 54 ms
  instructions: The Alpenglow demo shop from docs.echolot.dev. Read-only: search the catalog, look up products and orders.
3 tools
  search_catalog: Searches the Alpenglow catalog by text and returns matching products with price and stock.
  get_product: Returns one product by SKU, with its price, weight, rating and stock per warehouse.
  order_status: Returns an order's status, total and shipping estimate.
1 resource
  alpenglow://catalog/categories  categories
1 prompt
  pack_for_a_trip: Suggests gear for a trip.

Ein stdio-Server:

echolot mcp check -- npx -y @modelcontextprotocol/server-everything
echolot mcp check -e API_KEY=demo -- uvx some-mcp-server --flag

Wie ein Modell die Tools siehtCopy Anchor Link

--quality fügt hinzu, was ein Modell vom Server bekäme: was die Liste der Tools in den Kontext jedes Anbieters bei jedem Zug kostet (eine Schätzung), die Tools, die am meisten kosten, und worüber ein Modell stolpern würde, etwa Probleme im Schema und unklare oder sich überschneidende Beschreibungen. Es ist derselbe Bericht wie So sieht ein Modell diesen Server in der App; siehe Tools und Qualität.

echolot mcp check --url https://demo.echolot.dev/mcp --quality

How a model sees the tools (estimates)
  Anthropic      572 tokens a turn, 0.3% of a 200k context
  OpenAI         166 tokens a turn, 0.1% of a 200k context
  Google Gemini  225 tokens a turn, 0.1% of a 200k context
  largest: search_catalog 98, get_product 66, order_status 62
Nothing a model would stumble over.

--strict lässt ein Problem (keine Warnung und keinen Hinweis) mit 1 enden, für CI. --as anthropic, --as openai oder --as gemini gibt nur die Liste der Tools aus, wie die API dieses Anbieters sie erhält.

echolot mcp sign-in und sign-outCopy Anchor Link

echolot mcp sign-in <server> [--workspace <workspace>] [--env <env>] [--force] [--print] [--verbose]
echolot mcp sign-out <server> [--workspace <workspace>]

<server> ist der Dateiname des Servers im Ordner mcp-servers des Arbeitsbereichs, ohne .toml. Die Anmeldung öffnet deinen Browser und wartet auf die Weiterleitung an 127.0.0.1:

echolot mcp sign-in alpenglow-mcp -w Alpenglow.echolot

• Auf einem Mac geht die Anmeldung in den Schlüsselbund, geteilt mit der App: Die App und echolot run auf diesem Mac nutzen sie.
• Anderswo oder mit --print gibt Echolot sie als Zeile ECHOLOT_SECRET_…='…' aus. Bewahre diesen Wert als CI-Secret auf und setze die Variable dort, wo Echolot läuft. Er enthält ein Refresh-Token: Behandle ihn wie ein Passwort.
• ECHOLOT_BROWSER nennt einen anderen Befehl, mit dem die Anmeldeseite geöffnet wird.

sign-out entfernt die Anmeldung aus dem Schlüsselbund. Ohne Schlüsselbund gibt es nichts zu vergessen: Entferne stattdessen die Variable.

echolot mcp serveCopy Anchor Link

echolot mcp serve [<workspace>] [--env <env>] [--policy <policy>] [--toolsets <toolsets>] [--http <port>] [--verbose] [--headless] [--trust-workspace-policy]

Stellt einen Arbeitsbereich Agenten über MCP bereit. Agenten listen seine Anfragen auf, lesen, senden und führen sie aus, fragen Antworten über Handles ab und erstellen oder ändern Anfragen, über dieselben Tools wie die App. Füge ihn einem Client als stdio-Server hinzu, dessen Befehl lautet:

echolot mcp serve /path/to/Alpenglow.echolot

Mit geöffneter App. Hat die App Echolot den Arbeitsbereich geöffnet und lässt Agenten herein (Einstellungen › Agenten), wird der Client zur App durchgestellt. Die App fragt dich dann, ob du genehmigst, was eine Genehmigung braucht, und du siehst, was der Agent tut. --headless stellt trotzdem auf eigene Faust bereit.

Auf eigene Faust. Ohne die App kann niemand gefragt werden, daher wird abgelehnt, wonach die Richtlinie fragen würde:

Secrets werden aus ECHOLOT_SECRET_-Variablen und dem Schlüsselbund dieses Macs aufgelöst und erreichen den Agenten nie. Headless führt der Server nur die Skripte aus, die der Arbeitsbereich beim Start hatte.

Die eigenen Regeln des Arbeitsbereichs. Ein Abschnitt [agents] in workspace.toml kann Agenten für den Arbeitsbereich ausschalten oder die Richtlinie je Art von Aktion verschärfen. Regeln, die die Richtlinie lockern würden, zählen nur mit --trust-workspace-policy; ohne sagt Echolot, welche es ignoriert hat. Ein neuer Host und eine geschützte Umgebung werden nie ohne Weiteres erlaubt. Die Schlüssel stehen in den Dateien des Arbeitsbereichs.

Tool-Sets. requests wird immer angeboten. --toolsets fügt Gruppen hinzu, durch Kommas getrennt, oder all:

Die Richtlinie für Agenten, der Proxy, Zertifikate, Auth-Einstellungen und Skripte werden Agenten in keinem Tool-Set je angeboten.

Über HTTP. --http <port> stellt Streamable HTTP auf 127.0.0.1 bereit statt stdio (0 wählt einen freien Port). Weil alles auf diesem Mac einen Loopback-Port erreichen kann, müssen Clients ein Bearer-Token senden, das Echolot ausgibt:

echolot mcp serve Alpenglow.echolot --http 0 --policy readonly

Echolot MCP server for Alpenglow at http://127.0.0.1:52817/mcp (policy readonly)
Clients send the header  Authorization: Bearer 6f1c…

Setze ECHOLOT_MCP_TOKEN, um das Token selbst zu wählen.

echolot mcp setupCopy Anchor Link

echolot mcp setup <client> [--workspace <workspace>] [--name <name>] [--version <version>]

Gibt aus, was ein Client braucht, um echolot mcp serve für einen Arbeitsbereich zu starten. Es ändert nichts; kopiere die Ausgabe dorthin, wo der Client sie liest. Der Befehl in der Ausgabe ist der Pfad des echolot, das du ausgeführt hast.

echolot mcp setup claude-code -w Alpenglow.echolot

claude mcp add --scope user echolot-alpenglow -- /usr/local/bin/echolot mcp serve /Users/you/Alpenglow.echolot

echolot mcp setup cursor -w Alpenglow.echolot

{
  "mcpServers" : {
    "echolot-alpenglow" : {
      "args" : ["mcp", "serve", "/Users/you/Alpenglow.echolot"],
      "command" : "/usr/local/bin/echolot"
    }
  }
}

Einstellungen › Agenten in der App richtet dieselben Clients für dich ein; siehe Agenten.

Exit-CodesCopy Anchor Link