MCP-сервер

Подключите Claude.ai, ChatGPT, Claude Desktop, Cursor или любой MCP-клиент к каталогу коннекторов Сам Решу и сэндбоксу для исполнения кода.

Что это

Сервер реализует Model Context Protocol поверх Streamable HTTP по адресу https://api.samreshuuu.ru/mcp/ (с завершающим слешем). Версию протокола сервер согласует с клиентом при подключении: принимаются 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25, а клиенту с незнакомой ревизией сервер отвечает 2025-11-25. Внешнему клиенту открыты каталог коннекторов организации и Python-песочница.

Сервер без состояния: каждый POST обрабатывается независимо, Mcp-Session-Id не выдаётся. Локального stdio-сервера и устаревшего транспорта HTTP+SSE нет.

Подключение без ключа: Claude.ai, ChatGPT, Claude Desktop

Клиенту с входом по OAuth достаточно адреса https://api.samreshuuu.ru/mcp/, ключ не нужен. Клиент откроет страницу Сам Решу, где вы выберете организацию и нажмёте «Разрешить». Отключить приложение можно в Настройках, раздел «Устройства и сессии».

  • Claude.ai и Claude Desktop: Settings → Connectors → Add custom connector, вставьте адрес.
  • ChatGPT: в настройках приложений создайте коннектор, вставьте адрес, способ входа OAuth.
  • Claude Code: claude mcp add --transport http samreshuuu https://api.samreshuuu.ru/mcp/, затем /mcp и вход в браузере.

Разрешить подключение может владелец или администратор организации. Приложение получает те же права, что ключ агента: каталог и вызовы коннекторов организации и песочницу, без личных подключений и памяти того, кто разрешил. Вызовы идут по тарифу организации.

Подключение по ключу

Добавьте блок ниже в mcp.json в Cursor или эквивалентный конфиг вашего клиента. Ключ агента для него выпускается в консоли разработчика, раздел «Ключи API».

json
{ "mcpServers": { "samreshuuu": { "url": "https://api.samreshuuu.ru/mcp/", "headers": { "Authorization": "Bearer sk-org-your_api_key" } } } }

Создать ключ агента в консоли разработчика →

Claude Code

bash
claude mcp add --transport http samreshuuu https://api.samreshuuu.ru/mcp/ --header "Authorization: Bearer sk-org-your_api_key"

Codex

В ~/.codex/config.toml ключ читается из переменной окружения (без префикса Bearer):

toml
[mcp_servers.samreshuuu] url = "https://api.samreshuuu.ru/mcp/" bearer_token_env_var = "SAMRESHUUU_API_KEY"

VS Code

В .vscode/mcp.json:

json
{ "servers": { "samreshuuu": { "type": "http", "url": "https://api.samreshuuu.ru/mcp/", "headers": { "Authorization": "Bearer sk-org-xxxxxxxxxxxx" } } } }

Аутентификация

Каждый HTTP-запрос к /mcp/ несёт заголовок Authorization: Bearer … с ключом sk-org-… или с токеном, который приложение получило входом по OAuth. Пользователь и организация берутся из ключа или из разрешения, X-Org-Id не нужен. На запрос без годного ключа или токена сервер отвечает ещё до разбора MCP-сообщения: HTTP 401, заголовок WWW-Authenticate с адресом метаданных защищённого ресурса (resource_metadata, RFC 9728) и тело detail нативного API (не объект ошибки /v1). Если предъявленный ключ или токен больше не действует, в заголовке есть ещё error="invalid_token":

json
{ "detail": { "code": "AUTH_INVALID_CREDENTIALS", "message": "Ключ API не найден, отозван или истёк. Выпустите новый ключ в консоли разработчика, раздел «Ключи API».", "hint": null, "is_retryable": false, "message_en": "Invalid, revoked or expired API key. Create a new key in the developer console, section API keys." } }
HTTPКодЗначениеПовтор
401AUTH_HEADER_MISSINGОтсутствует заголовок авторизации.нет
401AUTH_TOKEN_INVALIDНедействительный токен авторизации.нет
401AUTH_INVALID_CREDENTIALSНе удалось подтвердить вход. Попробуйте ещё раз.нет

AUTH_HEADER_MISSING значит, что заголовка Authorization нет; AUTH_TOKEN_INVALID, что заголовок не вида Bearer …; AUTH_INVALID_CREDENTIALS, что ключ или токен неизвестен, отозван или истёк.

OAuth 2.1

Сервер авторизации живёт на https://samreshuuu.ru и следует спецификации авторизации MCP: метаданные защищённого ресурса (/.well-known/oauth-protected-resource/mcp), метаданные сервера (https://samreshuuu.ru/.well-known/oauth-authorization-server), Client ID Metadata Document первым и динамическая регистрация запасной, только публичные клиенты с PKCE S256, параметр resource (RFC 8707) и iss в ответе авторизации (RFC 9207). Права: tools:read и tools:write, для refresh-токена offline_access. Токен доступа живёт час, refresh-токен меняется при каждом обновлении; повторное предъявление старого отзывает разрешение целиком.

Нужен ключ агента: чтение требует tools:read, пишущие вызовы connector_execute и любой repl_execute требуют tools:write, без нужного права приходит AUTH_PERMISSION_DENIED. Пишущий ли вызов, решает классификатор коннектора, а не HTTP-метод: POST-запрос на чтение (например, отчёт маркетплейса) проходит и с tools:read. Варианты доступа и права описаны в разделе Аутентификация.

Публичный info-эндпойнт

GET /api/v1/mcp/info не требует аутентификации и отдаёт то, что нужно для конфига клиента:

ПолеЧто несёт
urlАдрес MCP-сервера, https://api.samreshuuu.ru/mcp/
server_nameИмя сервера для конфига клиента, samreshuuu
protocol_versionsПринимаемые ревизии протокола от старой к новой: 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25
preferred_protocol_versionПредпочтительная ревизия, 2025-11-25
supported_scopesВсе права, которые знает сервер: tools:read, tools:write, chat:write, models:read, models:write, keys:manage
example_configГотовый блок mcpServers с адресом и заголовком ключа
api_base_urlБаза платформы разработчика с /v1, https://api.samreshuuu.ru/v1: API моделей, /connectors, /connections; null, если у установки её нет, тогда коннекторы живут под agent_api_url
agent_api_urlБаза API агентов, https://samreshuuu.ru/v1

Агенты остаются на samreshuuu.ru: на api.samreshuuu.ru их пути заняты API моделей. Прежний адрес https://samreshuuu.ru/mcp/ тоже отвечает.

Доступные инструменты

Каждый вызов выполняется на общих подключениях организации и в песочнице ключа; личные кабинеты и память создателя ключа закрыты. Таблица взята из реестра инструментов сервера.

ИнструментScope ключаПодсказкиОписание
list_servicestools:read (входит в tools:write)только чтениеКаталог сервисов
describe_servicetools:read (входит в tools:write)только чтениеПаспорт сервиса
connector_executetools:write для записи, tools:read для чтенияможет менять данные, в лимите ключаВызов сервиса
repl_executetools:write на каждый вызовможет менять данные, в лимите ключаКод и данные

list_services, describe_service и connector_execute это каталог, паспорт и вызов коннектора: аргументы, адресация кабинетов, подключение сервиса человеком (INTEGRATION_REQUIRED) и согласие на запись (APPROVAL_PENDING) у них те же, что у REST, и описаны в разделе Вызов по ключу. repl_execute принимает code, skills (id навыков, чьи скрипты подключаются) и timeout_seconds (выше потолка песочницы урезается до него) и отвечает stdout, stderr, exit_code, error, files, truncated. Через MCP repl_execute не получает собственных переменных пользователя, о секретах коннекторов см. Коннекторы.

Лимиты и долгие вызовы

connector_execute и repl_execute тратят минутный лимит ключа, list_services и describe_service в него не входят; таблица и отказ ключа без тарифа описаны в разделе Ошибки и лимиты API агентов. Пока идёт долгий connector_execute или repl_execute, сервер с коротким интервалом шлёт уведомления о прогрессе, если клиент передал progressToken: клиент, который сбрасывает таймаут по прогрессу, не оборвёт вызов. Ответы коннекторов и песочницы проходят проверку, найденные секреты маскируются.

Skill-ресурсы

Каждый включённый навык экспонируется как MCP-ресурс по схеме skill://{name}. Тело ресурса: системный промпт навыка плюс подсказка о том, как вызывать connector_execute с привязанным сервисом. На первом аутентифицированном запросе сервер однократно регистрирует ресурсы для всех включённых навыков, после чего resources/list их перечисляет.

Ошибки

Ошибка инструмента приходит результатом вызова с isError: true, текст результата несёт JSON-объект {code, message, retryable, hint?, details?}. MCP SDK может добавить перед текстом префикс Error executing tool …:; JSON идёт после него. details несёт данные об ошибке (кандидаты, подсказки), а не инструкции. Ошибка ключа приходит раньше, HTTP 401 (см. Аутентификация).

json
{ "code": "TOOL_VALIDATION_FAILED", "message": "…", "retryable": false, "details": { "suggestions": ["wildberries"], "connector_code": "UNKNOWN_SERVICE" } }

Каждый код это строка реестра ошибок сервера, того же, которым отвечает HTTP API; таблица кодов описана в разделе Ошибки и лимиты API агентов. Поле retryable результата это вердикт для этого вызова, и оно главнее колонки таблицы, которая описывает код в целом. Если отказ поднят под собственным написанием коннектора или шлюза, это написание приходит в details.connector_code для диагностики; ветвитесь по code. Что значат отказы коннекторов (кабинет не назван, сервис не подключён, запись ждёт согласия), описано в разделе Вызов по ключу.

Была ли страница полезна?