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».
Создать ключ агента в консоли разработчика →
Claude Code
Codex
В ~/.codex/config.toml ключ читается из переменной окружения (без префикса Bearer):
VS Code
В .vscode/mcp.json:
Аутентификация
Каждый 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":
| HTTP | Код | Значение | Повтор |
|---|---|---|---|
| 401 | AUTH_HEADER_MISSING | Отсутствует заголовок авторизации. | нет |
| 401 | AUTH_TOKEN_INVALID | Недействительный токен авторизации. | нет |
| 401 | AUTH_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_services | tools:read (входит в tools:write) | только чтение | Каталог сервисов |
describe_service | tools:read (входит в tools:write) | только чтение | Паспорт сервиса |
connector_execute | tools:write для записи, tools:read для чтения | может менять данные, в лимите ключа | Вызов сервиса |
repl_execute | tools: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 (см. Аутентификация).
Каждый код это строка реестра ошибок сервера, того же, которым отвечает HTTP API; таблица кодов описана в разделе Ошибки и лимиты API агентов. Поле retryable результата это вердикт для этого вызова, и оно главнее колонки таблицы, которая описывает код в целом. Если отказ поднят под собственным написанием коннектора или шлюза, это написание приходит в details.connector_code для диагностики; ветвитесь по code. Что значат отказы коннекторов (кабинет не назван, сервис не подключён, запись ждёт согласия), описано в разделе Вызов по ключу.