Как подключить MCP-сервер КРАСОФТ
Пошаговые инструкции для популярных ИИ-клиентов: Claude Code, claude.ai и Claude Desktop, ChatGPT, Cursor, VS Code, Windsurf и любых других с поддержкой MCP. Везде нужен один и тот же адрес сервера — различается только место, куда его вставить.
https://zakupki.krasoft.ru/api/mcpТранспорт — streamable HTTP (не SSE и не stdio). Один адрес для всех клиентов, отдельных «endpoint для инструментов» не существует.
- Без ключа — анонимно. Поиск извещений и карточки закупок с дневными квотами, ничего создавать не нужно. Для первого знакомства этого достаточно.
- С ключом — ваш тариф. Ключ
krsp_...даёт ассистенту лимиты и данные вашего тарифа. Передаётся в заголовкеAuthorization: Bearer krsp_... - Где взять ключ: войдите в аккаунт, откройте раздел «Разработчикам» (меню профиля), вкладку «MCP», и нажмите «Создать ключ». Значение показывается один раз — у нас хранится только хеш. Активных ключей может быть до десяти, отозвать любой можно в любой момент.
- В claude.ai, Claude Desktop и ChatGPT ключ не нужен вовсе — там вход по OAuth логином КРАСОФТ.
В инструкциях ниже оба варианта размечены такими бейджами — копируйте тот блок, который вам подходит.
Инструкции по клиентам
Claude Code (CLI)
Ключ опционален- 1
Откройте терминал и выполните одну из команд — в зависимости от способа подключения:
Без ключа — анонимнодневные квоты, ничего создавать не нужноclaude mcp add --transport http krasoft https://zakupki.krasoft.ru/api/mcp
С ключом — ваш тарифподставьте свой ключ вместо krsp_...claude mcp add --transport http krasoft https://zakupki.krasoft.ru/api/mcp --header "Authorization: Bearer krsp_..."
- 2
Проверьте подключение: запустите сессию Claude Code и выполните команду
/mcp— в списке серверов появитсяkrasoftсо статусом connected и набором инструментов закупок.
Без ключа — анонимные квоты на поиски и карточки. С ключом — лимиты вашего аккаунта и реестры, MCP-доступ к которым подключён.
claude.ai и Claude Desktop
OAuth — ключ не нужен- 1
В левом меню откройте «Персонализация», вкладку «Коннекторы», нажмите «Добавить» и выберите «Добавить пользовательский коннектор».
- 2
Имя — любое, например «КРАСОФТ Платформа». В поле адреса вставьте адрес сервера и нажмите «Продолжить»:
https://zakupki.krasoft.ru/api/mcp
- 3
В разделе «Аутентификация» выберите «Войти сейчас», в разделе «Клиент OAuth» — «Регистрировать автоматически», и нажмите «Добавить». Вариант по умолчанию («опубликованные идентификационные данные Claude») наш сервер не поддерживает — с ним вход не пройдёт. Поля Client ID и Client Secret не заполняйте.
- 4
Нажмите «Подключить». Откроется страница входа КРАСОФТ: введите логин и пароль от платформы и нажмите «Разрешить». Ключ
krsp_...создавать не нужно. - 5
В новом чате нажмите «+» → «Коннекторы», проверьте, что «КРАСОФТ Платформа» включена, и задайте вопрос о закупках. Если включены другие коннекторы с похожими инструментами, Claude может выбрать их — лишние на время выключите.
Названия пунктов — по веб-версии claude.ai на октябрь 2026 года. После входа действуют квоты вашего аккаунта, а реестры открываются по подключённому MCP-доступу к страницам — он выдаётся отдельно от веб-версии.
ChatGPT
OAuth — ключ не нужен- 1
Нужен платный тариф ChatGPT и веб-версия в браузере: в мобильном приложении свои MCP-серверы не подключаются. На тарифе Business сервер добавляет администратор рабочего пространства.
- 2
Откройте «Плагины» в левом меню, нажмите «Добавить» и выберите «Добавить пользовательский сервер MCP».
- 3
Название — любое, например «КРАСОФТ Платформа». В поле «Подключение» вставьте адрес сервера:
https://zakupki.krasoft.ru/api/mcp
Аутентификацию оставьте OAuth, расширенные настройки OAuth не трогайте: поля OAuth Client ID и Client Secret должны остаться пустыми.
- 4
Отметьте «Я понимаю и хочу продолжить» и нажмите «Создать в виде плагина». ChatGPT предложит подключить плагин — нажмите «Подключить».
- 5
Откроется страница входа КРАСОФТ: введите логин и пароль от платформы и нажмите «Разрешить». Ключ
krsp_...создавать не нужно — доступ ассистента будет соответствовать вашему тарифу. - 6
В новом чате наберите
@, выберите «КРАСОФТ Платформа» и спросите про закупки — например, про активные тендеры в вашем регионе.
Названия пунктов — по интерфейсу ChatGPT на октябрь 2026 года, OpenAI их время от времени переименовывает. Если в вашем плане MCP-коннекторы недоступны, тот же сервер можно использовать через Claude, Cursor или любой другой клиент из этой инструкции.
Cursor
Ключ опционаленВеб-версия (cursor.com/agents) — вход по логину КРАСОФТ
- 1
Откройте cursor.com/agents, в поле ввода нажмите «+» → «MCP». Внизу списка нажмите «Add MCP», затем «Custom MCP».
- 2
Name — любое, например
krasoft. Type — URL, в Server URL вставьте адрес сервера и нажмите «Add MCP»:https://zakupki.krasoft.ru/api/mcp
Headers не заполняйте — ключ в веб-версии не нужен.
- 3
Напротив сервера нажмите «Connect». Откроется страница входа КРАСОФТ: введите логин и пароль от платформы и нажмите «Разрешить».
- 4
Проверьте, что переключатель
krasoftвключён, и задайте вопрос — например, «Найди активные тендеры на канцтовары через MCP krasoft». Если включены другие MCP-серверы с похожими инструментами, агент может выбрать их — лишние на время выключите.
Редактор Cursor — через mcp.json
- 1
Откройте файл
~/.cursor/mcp.json(глобально) или.cursor/mcp.jsonв корне проекта. То же можно сделать через настройки: раздел MCP (название может отличаться в вашей версии). - 2
Добавьте сервер — скопируйте подходящий вариант конфига. В анонимном варианте блока
headersнет вовсе:Без ключа — анонимнодневные квоты, ничего создавать не нужно{ "mcpServers": { "krasoft": { "url": "https://zakupki.krasoft.ru/api/mcp" } } }С ключом — ваш тарифподставьте свой ключ вместо krsp_...{ "mcpServers": { "krasoft": { "url": "https://zakupki.krasoft.ru/api/mcp", "headers": { "Authorization": "Bearer krsp_..." } } } } - 3
Перезапустите Cursor или обновите список серверов в настройках MCP — сервер
krasoftдолжен показать зелёный статус и список инструментов.
С ключом агент Cursor работает в лимитах вашего тарифа; без ключа — анонимные дневные квоты.
VS Code
Ключ опционален- 1
Откройте палитру команд (Ctrl+Shift+P), выберите «MCP: Add Server», тип сервера — «HTTP».
- 2
Вставьте адрес сервера и нажмите Enter, имя — например
krasoft:https://zakupki.krasoft.ru/api/mcp
- 3
Где сохранить — «Global», затем «Copilot Global». Откроется файл настроек с сервером.
- 4
Запустите сервер: Ctrl+Shift+P → «MCP: List Servers» → «krasoft» → «Start Server» → «Trust». В выводе появится «Discovered … tools».
- 5
В чате VS Code нажмите «Configure Tools» — «КРАСОФТ Платформа» должна быть отмечена — и задайте вопрос о закупках.
Названия пунктов — по VS Code 1.143 на октябрь 2026 года. Так сервер работает без ключа, с анонимными дневными квотами.
С ключом — через .vscode/mcp.json проекта
- 1
Создайте файл
.vscode/mcp.jsonв корне проекта (или добавьте сервер через палитру команд — команда добавления MCP-сервера, название зависит от версии). - 2
Опишите сервер — обратите внимание на ключ верхнего уровня «servers». Выберите свой вариант:
Без ключа — анонимнодневные квоты, ничего создавать не нужно{ "servers": { "krasoft": { "type": "http", "url": "https://zakupki.krasoft.ru/api/mcp" } } }С ключом — ваш тарифподставьте свой ключ вместо krsp_...{ "servers": { "krasoft": { "type": "http", "url": "https://zakupki.krasoft.ru/api/mcp", "headers": { "Authorization": "Bearer krsp_..." } } } } - 3
Откройте чат в режиме агента — инструменты закупок появятся в списке доступных инструментов.
Чтобы не хранить ключ в файле, VS Code умеет спрашивать секреты при старте — см. документацию по inputs в mcp.json. Ключ определяет доступ: без него — анонимные квоты, с ним — квоты аккаунта и подключённые для MCP реестры.
Windsurf, Cline и другие клиенты с JSON-конфигом
Ключ опционален- 1
Найдите, где клиент хранит конфигурацию MCP-серверов: обычно это JSON-файл или раздел настроек с названием вроде MCP Servers / Plugins (точное расположение — в документации клиента).
- 2
Большинство клиентов используют тот же формат
mcpServers, что и Cursor — скопируйте подходящий вариант:Без ключа — анонимнодневные квоты, ничего создавать не нужно{ "mcpServers": { "krasoft": { "url": "https://zakupki.krasoft.ru/api/mcp" } } }С ключом — ваш тарифподставьте свой ключ вместо krsp_...{ "mcpServers": { "krasoft": { "url": "https://zakupki.krasoft.ru/api/mcp", "headers": { "Authorization": "Bearer krsp_..." } } } } - 3
Если клиент требует явно указать тип транспорта — выбирайте streamable HTTP (иногда обозначается как http).
Подойдёт любой клиент с поддержкой MCP по streamable HTTP — специальной интеграции со стороны платформы не требуется.
Клиент поддерживает только stdio
Ключ опционален- 1
Старые версии некоторых клиентов не умеют удалённые HTTP-серверы и запускают MCP только локальной командой (stdio). Для них есть мост
mcp-remote: локальный процесс, который пробрасывает stdio-клиент к нашему HTTP-серверу. Понадобится установленный Node.js. - 2
В конфиге клиента опишите сервер командой, а не адресом — выберите свой вариант (в анонимном нет аргументов
--header):Без ключа — анонимнодневные квоты, ничего создавать не нужно{ "mcpServers": { "krasoft": { "command": "npx", "args": [ "mcp-remote", "https://zakupki.krasoft.ru/api/mcp" ] } } }С ключом — ваш тарифподставьте свой ключ вместо krsp_...{ "mcpServers": { "krasoft": { "command": "npx", "args": [ "mcp-remote", "https://zakupki.krasoft.ru/api/mcp", "--header", "Authorization: Bearer krsp_..." ] } } } - 3
Перезапустите клиент. При первом обращении
npxскачает пакет — это займёт несколько секунд.
Если у клиента есть нативная поддержка streamable HTTP — используйте её напрямую, мост нужен только как запасной вариант.
Проверка подключения
Задайте ассистенту простой вопрос — так, как спросили бы коллегу:
Найди активные тендеры на канцтовары
- Ассистент должен вызвать инструмент
search_tendersи вернуть список живых извещений: названия, НМЦК, регионы и сроки подачи заявок. - Если вместо данных пришло сообщение о лимите или о том, что MCP-доступ к странице не подключён, — подключение работает. Это граница вашего доступа: в ответе сказано, что откроет регистрация или подключение страницы.
Частые проблемы
Ошибка 401 Unauthorized — сервер не принимает ключ
Ключ отозван, истёк или скопирован с опечаткой. Восстановить значение нельзя: оно показывается один раз при создании, в базе хранится только хеш. Выпустите новый ключ в разделе «Разработчикам» (меню профиля, вкладка «MCP») и замените его в конфиге клиента. Если ключ не нужен — уберите заголовок Authorization целиком: сервер работает и анонимно.
«Авторизация невозможна: client_id не зарегистрирован» (claude.ai, Claude Desktop, ChatGPT)
Приложение пришло к нам с идентификатором, который у нас не зарегистрирован. В claude.ai так бывает, если в разделе «Клиент OAuth» остался вариант по умолчанию — нужно «Регистрировать автоматически». В ChatGPT и других клиентах — если в дополнительных настройках заполнено поле OAuth Client ID (например, логином или ключом). Удалите коннектор и добавьте заново: адрес сервера, автоматическая регистрация, поля OAuth Client ID и Client Secret пустые. Логин и пароль КРАСОФТ вводятся позже, на нашей странице входа.
Ошибка 429 или ответ про исчерпанный лимит
Сработала дневная квота вашего уровня доступа: у анонимного доступа лимиты ниже, бесплатный аккаунт их повышает, на платных тарифах дневных лимитов нет. Квота обнуляется на следующий день. Чтобы поднять потолок — зарегистрируйтесь бесплатно и выпустите ключ либо подключите платный тариф.
Ошибка «Cannot convert argument to a ByteString» (Cursor, VS Code и другие)
В заголовок Authorization попал символ за пределами ASCII — чаще всего многоточие «…», если ключ вставлен из замаскированного значения или плейсхолдер krsp_... не заменён на настоящий ключ. Клиент не может собрать HTTP-заголовок и падает ещё до запроса к серверу. Вставьте полное значение ключа — оно состоит только из латиницы, цифр, дефиса и знака подчёркивания и показывается один раз при создании в кабинете. Если ключ не нужен, возьмите анонимный вариант конфига — в нём блока headers нет вовсе.
Клиент не видит сервер или подключение не устанавливается
Проверьте три вещи. Транспорт — streamable HTTP, не SSE и не stdio: в Claude Code это флаг --transport http, в JSON-конфигах — поле url, а не command. Адрес — ровно https://zakupki.krasoft.ru/api/mcp, без слэша на конце. Если клиент старый и поддерживает только stdio — подключайтесь через мост npx mcp-remote.
Инструмент ответил, что MCP-доступ к странице не подключён
Это не ошибка, а граница доступа. Поиск извещений, карточки извещения и контракта, профиль заказчика и срезы рынка открыты всем. Остальные реестры — техзадания, объекты закупок, исполнение, спецификации, поиск контрактов и планов-графиков, документы извещений — работают через MCP только при подключённой странице. Этот доступ выдаётся отдельно от веб-версии: подключить страницу можно через менеджера КРАСОФТ.
Не помогло? Напишите нам на support@krasoft.ru — разберёмся вместе.
Осталось выпустить ключ
Анонимный доступ уже работает, а ключ из личного кабинета поднимет лимиты и откроет данные вашего тарифа.