echolot mcp

echolot mcp работает с MCP-серверами в двух направлениях. check и sign-in обращаются к чужому серверу, как это делает страница «MCP-серверы». serve и setup превращают ваше рабочее пространство в MCP-сервер, чтобы ИИ-агенты вроде Claude Code или Cursor могли перечислять, отправлять и тестировать его запросы; см. агентов.

echolot mcp checkCopy Anchor Link

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

Укажите эндпоинт Streamable HTTP через --url или команду, которая запускает stdio-сервер, после --. Echolot выясняет, говорит ли сервер на протоколе без состояния (2026-07-28) или на более раннем, с рукопожатием, и перечисляет его инструменты, ресурсы и промпты:

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.

Сервер stdio:

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

Как модель видит инструментыCopy Anchor Link

--quality добавляет то, что модель получила бы от сервера: сколько список инструментов стоит в контексте каждого провайдера на каждом ходу (оценка), какие инструменты стоят больше всего и обо что модель могла бы споткнуться, например проблемы схем и неясные или пересекающиеся описания. Это тот же отчёт, что Как модель видит этот сервер в приложении; см. инструменты и качество.

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 делает так, что проблема (не предупреждение и не заметка) завершает команду с кодом 1 — для CI. --as anthropic, --as openai или --as gemini печатает только список инструментов в том виде, в каком его получает API этого провайдера.

echolot mcp sign-in и sign-outCopy Anchor Link

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

<server> — это имя файла сервера в папке mcp-servers рабочего пространства, без .toml. Вход открывает ваш браузер и ждёт перенаправления на 127.0.0.1:

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

• На Mac вход попадает в Связку ключей, общую с приложением: им пользуются и приложение, и echolot run на этом Mac.
• В других местах, а также с --print, Echolot печатает его в виде строки ECHOLOT_SECRET_…='…'. Храните это значение как секрет CI и задайте переменную там, где работает Echolot. В нём лежит токен обновления: обращайтесь с ним как с паролем.
• ECHOLOT_BROWSER называет другую команду, которой открывать страницу входа.

sign-out удаляет вход из Связки ключей. Без Связки ключей забывать нечего: вместо этого удалите переменную.

echolot mcp serveCopy Anchor Link

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

Обслуживает рабочее пространство для агентов по MCP. Агенты перечисляют, читают, отправляют и запускают его запросы, запрашивают ответы по дескриптору, а также создают и изменяют запросы — теми же инструментами, что и приложение. Добавьте его в клиент как stdio-сервер, команда которого:

echolot mcp serve /path/to/Alpenglow.echolot

С открытым приложением. Когда приложение Echolot держит рабочее пространство открытым и пускает агентов (Настройки › Агенты), клиент перенаправляется в приложение. Тогда приложение просит вас одобрить то, что требует одобрения, и вы видите, что делает агент. --headless всё равно обслуживает само по себе.

Само по себе. Без приложения спросить некого, поэтому то, о чём политика спросила бы, отклоняется:

Секреты берутся из переменных ECHOLOT_SECRET_ и Связки ключей этого Mac и никогда не доходят до агента. В режиме headless сервер выполняет только те скрипты, которые были в рабочем пространстве на момент запуска.

Собственные правила рабочего пространства. Раздел [agents] в workspace.toml может отключить агентов для рабочего пространства или ужесточить политику для каждого вида действий. Правила, которые смягчили бы политику, учитываются только с --trust-workspace-policy; без него Echolot сообщает, какие из них он проигнорировал. Новый хост и защищённое окружение никогда не разрешаются безоговорочно. Ключи описаны в файлах рабочего пространства.

Наборы инструментов. requests предлагается всегда. --toolsets добавляет группы через запятую или all:

Политика агентов, прокси, сертификаты, настройки авторизации и скрипты никогда не предлагаются агентам, ни в одном наборе.

По HTTP. --http <port> обслуживает Streamable HTTP на 127.0.0.1 вместо stdio (0 выбирает свободный порт). Поскольку до порта loopback может добраться всё на этом Mac, клиенты должны отправлять bearer-токен, который печатает 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…

Задайте ECHOLOT_MCP_TOKEN, чтобы выбрать токен самостоятельно.

echolot mcp setupCopy Anchor Link

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

Печатает то, что нужно клиенту, чтобы запустить echolot mcp serve для рабочего пространства. Ничего не меняет; скопируйте вывод туда, где его читает клиент. Команда в выводе — это путь к тому echolot, который вы запустили.

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

Настройки › Агенты в приложении настраивают для вас те же клиенты; см. агентов.

Коды выходаCopy Anchor Link