echolot mcp

echolot mcp trabaja con servidores MCP en dos direcciones. check y sign-in hablan con el servidor de otra persona, como hace la página Servidores MCP. serve y setup convierten tu espacio de trabajo en un servidor MCP, para que agentes de IA como Claude Code o Cursor puedan listar, enviar y probar sus solicitudes; mira agentes.

echolot mcp checkCopy Anchor Link

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

Indica un endpoint Streamable HTTP con --url, o el comando que inicia un servidor stdio después de --. Echolot averigua si el servidor habla el protocolo sin estado (2026-07-28) o uno anterior con un handshake, y lista sus herramientas, recursos y 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 servidor stdio:

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

Cómo ve un modelo las herramientasCopy Anchor Link

--quality añade lo que recibiría un modelo del servidor: lo que cuesta la lista de herramientas en el contexto de cada proveedor en cada turno (una estimación), las herramientas que más cuestan y aquello con lo que un modelo tropezaría, como problemas de esquema y descripciones poco claras o que se solapan. Es el mismo informe que Cómo ve un modelo este servidor en la app; mira herramientas y calidad.

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 hace que un problema (no un aviso ni una nota) salga con 1, para CI. --as anthropic, --as openai o --as gemini imprime solo la lista de herramientas tal como la recibe la API de ese proveedor.

echolot mcp sign-in y sign-outCopy Anchor Link

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

<server> es el nombre de archivo del servidor en la carpeta mcp-servers del espacio de trabajo, sin .toml. Iniciar sesión abre tu navegador y espera la redirección en 127.0.0.1:

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

• En un Mac, el inicio de sesión va al llavero, compartido con la app: la app y echolot run en este Mac lo usan.
• En otro sitio, o con --print, Echolot lo imprime como una línea ECHOLOT_SECRET_…='…'. Guarda ese valor como secreto de CI y fija la variable donde se ejecute Echolot. Contiene un refresh token: trátalo como una contraseña.
• ECHOLOT_BROWSER nombra otro comando con el que abrir la página de inicio de sesión.

sign-out quita el inicio de sesión del llavero. Sin llavero no hay nada que olvidar: quita la variable en su lugar.

echolot mcp serveCopy Anchor Link

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

Sirve un espacio de trabajo a agentes por MCP. Los agentes listan, leen, envían y ejecutan sus solicitudes, consultan respuestas por identificador y crean o cambian solicitudes, con las mismas herramientas que la app. Añádelo a un cliente como servidor stdio cuyo comando es:

echolot mcp serve /path/to/Alpenglow.echolot

Con la app abierta. Cuando la app Echolot tiene el espacio de trabajo abierto y deja entrar a los agentes (Ajustes › Agentes), el cliente se pasa a la app. La app te pide entonces que apruebes lo que necesita aprobación, y ves lo que hace el agente. --headless sirve por su cuenta de todas formas.

Por su cuenta. Sin la app no se puede preguntar a nadie, así que se rechaza lo que la política preguntaría:

Los secretos se resuelven desde variables ECHOLOT_SECRET_ y desde el llavero de este Mac, y nunca llegan al agente. En modo headless, el servidor ejecuta solo los scripts que tenía el espacio de trabajo cuando arrancó.

Las reglas del propio espacio de trabajo. Una sección [agents] en workspace.toml puede desactivar los agentes para el espacio de trabajo, o endurecer la política por tipo de acción. Las reglas que aflojarían la política solo cuentan con --trust-workspace-policy; sin ella Echolot dice cuáles ignoró. Un host nuevo y un entorno protegido nunca se permiten sin más. Las claves están en archivos del espacio de trabajo.

Conjuntos de herramientas. requests se ofrece siempre. --toolsets añade grupos, separados por comas, o all:

La política de agentes, el proxy, los certificados, los ajustes de autenticación y los scripts nunca se ofrecen a los agentes, en ningún conjunto de herramientas.

Por HTTP. --http <port> sirve Streamable HTTP en 127.0.0.1 en lugar de stdio (0 elige un puerto libre). Como cualquier cosa de este Mac puede llegar a un puerto de loopback, los clientes deben enviar un token Bearer, que imprime Echolot:

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…

Fija ECHOLOT_MCP_TOKEN para elegir tú mismo el token.

echolot mcp setupCopy Anchor Link

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

Imprime lo que necesita un cliente para iniciar echolot mcp serve en un espacio de trabajo. No cambia nada; copia la salida donde la lea el cliente. El comando de la salida es la ruta del echolot que ejecutaste.

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

Ajustes › Agentes en la app configura los mismos clientes por ti; mira agentes.

Códigos de salidaCopy Anchor Link