Запросы MCP

Запрос MCP — это сохранённый вызов одного из MCP-серверов рабочего пространства: вызов инструмента, чтение ресурса, промпт или любой метод JSON-RPC. Сохраняйте вызовы, которые делаете часто, добавляйте проверки и запускайте их в Прогоне, как любые другие запросы.

Пробный вызов на странице MCP-серверовCopy Anchor Link

Быстрее всего начать на самом сервере:

1. Откройте страницу MCP-серверы и выберите сервер, например Alpenglow MCP, который указывает на https://demo.echolot.dev/mcp.
2. Выберите Проверка, если сервер ещё не проверялся. Страница перечислит Инструменты, Ресурсы и Промпты сервера.
3. Нажмите инструмент, ресурс или промпт. Откроется лист с его аргументами.
4. Заполните их — в Форме, построенной по схеме ввода, или как JSON — и выберите Вызвать.
5. Ниже появится результат с Результат или Ошибка и временем, которое заняло выполнение.
6. Выберите Сохранить как запрос, чтобы оставить вызов с его аргументами как запрос MCP.

Создание запроса MCPCopy Anchor Link

Выберите Новый вызов MCP в меню + рядом с Запросы в боковой панели. Панель редактора содержит вызов:

1. Выберите сервер в меню в её начале. MCP-серверы… в том же меню открывает страницу MCP-серверов.
2. Выберите, что вызывать: Инструмент, Ресурс, Промпт или Метод.
3. Введите цель: Имя инструмента, URI ресурса, Имя промпта или метод JSON-RPC, например ping. Имена из последней проверки сервера предлагаются по мере ввода в разделе С сервера.
4. Выберите Вызвать (⌘R). Пока вызов выполняется, Отменить (⌘.) останавливает его.

В редакторе есть вкладки: Документация, Аргументы, Переменные, Тесты и Настройки. У запросов MCP нет собственных заголовков, авторизации и скриптов: настройки подключения сервера, его заголовки и вход находятся на странице MCP-серверов. См. добавление серверов.

АргументыCopy Anchor Link

Вкладка Аргументы содержит объект JSON с {{variables}}:

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

Если последняя проверка сервера знает инструмент, вкладка показывает его описание над редактором, а ниже — его поля, например Fields: query*, limit; звёздочка отмечает обязательное поле. Заполнить по схеме заменяет аргументы всеми полями схемы ввода инструмента — чтобы было с чего начать.

В рабочем пространстве Alpenglow в Agent tools есть два вызова: search_catalog с аргументами выше и order_status, который запрашивает {"order_id": "ord_7Hk2Lw"}.

РезультатыCopy Anchor Link

Область ответа показывает результат в виде JSON на вкладке Тело, как любой ответ. Значок в сводке ответа читается Результат зелёным или Ошибка красным, с версией протокола, на которой говорит сервер. Наведите на него указатель, чтобы увидеть, кто ответил или что пошло не так.

Вызов может завершиться неудачей двумя способами, и Echolot их различает:

• Сервер отвечает ошибкой: результат инструмента, помеченный как ошибка, или ошибка JSON-RPC. Значок читается Ошибка, а тело содержит то, что сказал сервер.
• Ответа на вызов нет вовсе: сервер недоступен, не запускается или нарушает протокол. Область ответа объясняет причину. Проверьте сервер на странице MCP-серверов: журнал сообщений показывает каждое сообщение последней проверки.

Каждый вызов сохраняется в Истории.

Проверки для MCPCopy Anchor Link

На вкладке Тесты:

• Ошибка MCP равна false — проходит, если вызов удался. Неудача показывает сообщение сервера.
• Схема вывода инструмента проверяет structuredContent результата по outputSchema, которую объявляет инструмент. Проверка не проходит, если инструмент её не объявляет или в результате нет structuredContent.
• Значение JSON проверяет любое значение результата, например $.structuredContent.results.length больше 0 или $.content[0].type равно text.

Все проверки и сравнения см. в разделе скрипты и тесты.

Из командной строкиCopy Anchor Link

echolot run запускает сохранённые запросы MCP с их проверками, а echolot mcp check проверяет сервер. См. echolot mcp.