Перейти к содержимому

Как подключить 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. 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. 2

    Проверьте подключение: запустите сессию Claude Code и выполните команду /mcp — в списке серверов появится krasoft со статусом connected и набором инструментов закупок.

Без ключа — анонимные квоты на поиски и карточки. С ключом — лимиты вашего аккаунта и реестры, MCP-доступ к которым подключён.

claude.ai и Claude Desktop

OAuth — ключ не нужен
Как подключить КРАСОФТ к Claude
  1. 1

    В левом меню откройте «Персонализация», вкладку «Коннекторы», нажмите «Добавить» и выберите «Добавить пользовательский коннектор».

  2. 2

    Имя — любое, например «КРАСОФТ Платформа». В поле адреса вставьте адрес сервера и нажмите «Продолжить»:

    https://zakupki.krasoft.ru/api/mcp
  3. 3

    В разделе «Аутентификация» выберите «Войти сейчас», в разделе «Клиент OAuth» — «Регистрировать автоматически», и нажмите «Добавить». Вариант по умолчанию («опубликованные идентификационные данные Claude») наш сервер не поддерживает — с ним вход не пройдёт. Поля Client ID и Client Secret не заполняйте.

  4. 4

    Нажмите «Подключить». Откроется страница входа КРАСОФТ: введите логин и пароль от платформы и нажмите «Разрешить». Ключ krsp_... создавать не нужно.

  5. 5

    В новом чате нажмите «+» → «Коннекторы», проверьте, что «КРАСОФТ Платформа» включена, и задайте вопрос о закупках. Если включены другие коннекторы с похожими инструментами, Claude может выбрать их — лишние на время выключите.

Как работать с КРАСОФТ в Claude

Названия пунктов — по веб-версии claude.ai на октябрь 2026 года. После входа действуют квоты вашего аккаунта, а реестры открываются по подключённому MCP-доступу к страницам — он выдаётся отдельно от веб-версии.

ChatGPT

OAuth — ключ не нужен
Как подключить КРАСОФТ к ChatGPT
  1. 1

    Нужен платный тариф ChatGPT и веб-версия в браузере: в мобильном приложении свои MCP-серверы не подключаются. На тарифе Business сервер добавляет администратор рабочего пространства.

  2. 2

    Откройте «Плагины» в левом меню, нажмите «Добавить» и выберите «Добавить пользовательский сервер MCP».

  3. 3

    Название — любое, например «КРАСОФТ Платформа». В поле «Подключение» вставьте адрес сервера:

    https://zakupki.krasoft.ru/api/mcp

    Аутентификацию оставьте OAuth, расширенные настройки OAuth не трогайте: поля OAuth Client ID и Client Secret должны остаться пустыми.

  4. 4

    Отметьте «Я понимаю и хочу продолжить» и нажмите «Создать в виде плагина». ChatGPT предложит подключить плагин — нажмите «Подключить».

  5. 5

    Откроется страница входа КРАСОФТ: введите логин и пароль от платформы и нажмите «Разрешить». Ключ krsp_... создавать не нужно — доступ ассистента будет соответствовать вашему тарифу.

  6. 6

    В новом чате наберите @, выберите «КРАСОФТ Платформа» и спросите про закупки — например, про активные тендеры в вашем регионе.

Как работать с КРАСОФТ в ChatGPT

Названия пунктов — по интерфейсу ChatGPT на октябрь 2026 года, OpenAI их время от времени переименовывает. Если в вашем плане MCP-коннекторы недоступны, тот же сервер можно использовать через Claude, Cursor или любой другой клиент из этой инструкции.

Cursor

Ключ опционален

Веб-версия (cursor.com/agents) — вход по логину КРАСОФТ

Как подключить КРАСОФТ к Cursor
  1. 1

    Откройте cursor.com/agents, в поле ввода нажмите «+» → «MCP». Внизу списка нажмите «Add MCP», затем «Custom MCP».

  2. 2

    Name — любое, например krasoft. Type — URL, в Server URL вставьте адрес сервера и нажмите «Add MCP»:

    https://zakupki.krasoft.ru/api/mcp

    Headers не заполняйте — ключ в веб-версии не нужен.

  3. 3

    Напротив сервера нажмите «Connect». Откроется страница входа КРАСОФТ: введите логин и пароль от платформы и нажмите «Разрешить».

  4. 4

    Проверьте, что переключатель krasoft включён, и задайте вопрос — например, «Найди активные тендеры на канцтовары через MCP krasoft». Если включены другие MCP-серверы с похожими инструментами, агент может выбрать их — лишние на время выключите.

Как работать с КРАСОФТ в Cursor

Редактор Cursor — через mcp.json

  1. 1

    Откройте файл ~/.cursor/mcp.json (глобально) или .cursor/mcp.json в корне проекта. То же можно сделать через настройки: раздел MCP (название может отличаться в вашей версии).

  2. 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. 3

    Перезапустите Cursor или обновите список серверов в настройках MCP — сервер krasoft должен показать зелёный статус и список инструментов.

С ключом агент Cursor работает в лимитах вашего тарифа; без ключа — анонимные дневные квоты.

VS Code

Ключ опционален
Как подключить КРАСОФТ к VS Code
  1. 1

    Откройте палитру команд (Ctrl+Shift+P), выберите «MCP: Add Server», тип сервера — «HTTP».

  2. 2

    Вставьте адрес сервера и нажмите Enter, имя — например krasoft:

    https://zakupki.krasoft.ru/api/mcp
  3. 3

    Где сохранить — «Global», затем «Copilot Global». Откроется файл настроек с сервером.

  4. 4

    Запустите сервер: Ctrl+Shift+P → «MCP: List Servers» → «krasoft» → «Start Server» → «Trust». В выводе появится «Discovered … tools».

  5. 5

    В чате VS Code нажмите «Configure Tools» — «КРАСОФТ Платформа» должна быть отмечена — и задайте вопрос о закупках.

Как работать с КРАСОФТ в VS Code

Названия пунктов — по VS Code 1.143 на октябрь 2026 года. Так сервер работает без ключа, с анонимными дневными квотами.

С ключом — через .vscode/mcp.json проекта

  1. 1

    Создайте файл .vscode/mcp.json в корне проекта (или добавьте сервер через палитру команд — команда добавления MCP-сервера, название зависит от версии).

  2. 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. 3

    Откройте чат в режиме агента — инструменты закупок появятся в списке доступных инструментов.

Чтобы не хранить ключ в файле, VS Code умеет спрашивать секреты при старте — см. документацию по inputs в mcp.json. Ключ определяет доступ: без него — анонимные квоты, с ним — квоты аккаунта и подключённые для MCP реестры.

Windsurf, Cline и другие клиенты с JSON-конфигом

Ключ опционален
  1. 1

    Найдите, где клиент хранит конфигурацию MCP-серверов: обычно это JSON-файл или раздел настроек с названием вроде MCP Servers / Plugins (точное расположение — в документации клиента).

  2. 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. 3

    Если клиент требует явно указать тип транспорта — выбирайте streamable HTTP (иногда обозначается как http).

Подойдёт любой клиент с поддержкой MCP по streamable HTTP — специальной интеграции со стороны платформы не требуется.

Клиент поддерживает только stdio

Ключ опционален
  1. 1

    Старые версии некоторых клиентов не умеют удалённые HTTP-серверы и запускают MCP только локальной командой (stdio). Для них есть мост mcp-remote: локальный процесс, который пробрасывает stdio-клиент к нашему HTTP-серверу. Понадобится установленный Node.js.

  2. 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. 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 — разберёмся вместе.

Осталось выпустить ключ

Анонимный доступ уже работает, а ключ из личного кабинета поднимет лимиты и откроет данные вашего тарифа.