echolot mcp

echolot mcp travaille avec des serveurs MCP dans deux sens. check et sign-in parlent au serveur de quelqu’un d’autre, comme le fait la page Serveurs MCP. serve et setup font de votre espace de travail un serveur MCP, pour que des agents IA comme Claude Code ou Cursor puissent lister, envoyer et tester ses requêtes ; voir agents.

echolot mcp checkCopy Anchor Link

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

Donnez un point d’accès Streamable HTTP avec --url, ou la commande qui démarre un serveur stdio après --. Echolot détermine si le serveur parle le protocole sans état (2026-07-28) ou un protocole antérieur avec une négociation, et liste ses outils, ses ressources et ses prompts :

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.

Un serveur stdio :

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

Comment un modèle voit les outilsCopy Anchor Link

--quality ajoute ce qu’un modèle recevrait du serveur : ce que la liste des outils coûte dans le contexte de chaque fournisseur à chaque tour (une estimation), les outils les plus lourds, et ce sur quoi un modèle pourrait trébucher, comme les problèmes de schéma et les descriptions peu claires ou qui se recoupent. C’est le même rapport que Comment un modèle voit ce serveur dans l’app ; voir outils et qualité.

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 fait qu’un problème (pas un avertissement ni une remarque) se termine avec le code 1, pour la CI. --as anthropic, --as openai ou --as gemini affiche seulement la liste des outils telle que l’API de ce fournisseur la reçoit.

echolot mcp sign-in et sign-outCopy Anchor Link

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

<server> est le nom de fichier du serveur dans le dossier mcp-servers de l’espace de travail, sans .toml. La connexion ouvre votre navigateur et attend la redirection sur 127.0.0.1 :

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

• Sur un Mac, la connexion va dans le trousseau, partagé avec l’app : l’app et echolot run sur ce Mac l’utilisent.
• Ailleurs, ou avec --print, Echolot l’affiche sous la forme d’une ligne ECHOLOT_SECRET_…='…'. Conservez cette valeur comme secret de CI et définissez la variable là où Echolot s’exécute. Elle contient un jeton de renouvellement : traitez-la comme un mot de passe.
• ECHOLOT_BROWSER nomme une autre commande pour ouvrir la page de connexion.

sign-out supprime la connexion du trousseau. Sans trousseau, il n’y a rien à oublier : supprimez plutôt la variable.

echolot mcp serveCopy Anchor Link

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

Sert un espace de travail à des agents via MCP. Les agents listent, lisent, envoient et exécutent ses requêtes, interrogent les réponses par référence, et créent ou modifient des requêtes, avec les mêmes outils que l’app. Ajoutez-le à un client comme serveur stdio dont la commande est :

echolot mcp serve /path/to/Alpenglow.echolot

Avec l’app ouverte. Quand l’app Echolot a l’espace de travail ouvert et laisse entrer les agents (Réglages › Agents), le client est transmis à l’app. L’app vous demande alors d’approuver ce qui exige une approbation, et vous voyez ce que fait l’agent. --headless sert quand même en autonomie.

En autonomie. Sans l’app, personne ne peut être sollicité : ce sur quoi la politique demanderait confirmation est donc refusé :

Les secrets sont résolus depuis les variables ECHOLOT_SECRET_ et le trousseau de ce Mac, et n’atteignent jamais l’agent. En mode headless, le serveur n’exécute que les scripts que l’espace de travail avait à son démarrage.

Les règles propres à l’espace de travail. Une section [agents] dans workspace.toml peut désactiver les agents pour l’espace de travail, ou durcir la politique par type d’action. Les règles qui assoupliraient la politique ne comptent qu’avec --trust-workspace-policy ; sans cette option, Echolot indique celles qu’il a ignorées. Un nouvel hôte et un environnement protégé ne sont jamais autorisés d’office. Les clés sont dans les fichiers d’espace de travail.

Ensembles d’outils. requests est toujours proposé. --toolsets ajoute des groupes, séparés par des virgules, ou all :

La politique des agents, le proxy, les certificats, les réglages d’authentification et les scripts ne sont jamais proposés aux agents, dans aucun ensemble d’outils.

Via HTTP. --http <port> sert du Streamable HTTP sur 127.0.0.1 au lieu de stdio (0 choisit un port libre). Comme tout ce qui tourne sur ce Mac peut atteindre un port de bouclage, les clients doivent envoyer un jeton Bearer, qu’Echolot affiche :

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…

Définissez ECHOLOT_MCP_TOKEN pour choisir vous-même le jeton.

echolot mcp setupCopy Anchor Link

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

Affiche ce dont un client a besoin pour démarrer echolot mcp serve pour un espace de travail. Il ne change rien ; copiez la sortie là où le client la lit. La commande dans la sortie est le chemin du echolot que vous avez exécuté.

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"
    }
  }
}

Réglages › Agents dans l’app configure les mêmes clients pour vous ; voir agents.

Codes de sortieCopy Anchor Link