Как подключить Закупки MCP к Claude Code

Claude Code можно подключить к Закупки MCP по HTTP и использовать для поиска карточек и чтения документов в проекте. Это инструкция для Claude Code. Подключение Claude Desktop через пользовательский коннектор выполняется иначе; настройки одного клиента не следует переносить в другой без проверки.

Подготовьте доступ

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

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

Настройте .mcp.json

Для конфигурации проекта добавьте сервер в .mcp.json. Адрес российского сервиса — https://mcptender.ru/mcp.

{
  "mcpServers": {
    "tenders": {
      "type": "http",
      "url": "https://mcptender.ru/mcp",
      "headers": {
        "Authorization": "Bearer ${TENDER_MCP_KEY}"
      }
    }
  }
}

В Claude Code используется форма ${TENDER_MCP_KEY} в заголовке. Не заменяйте её синтаксисом ${env:TENDER_MCP_KEY} из примера Cursor. Это разные правила подстановки. Тип подключения в данном примере — http.

Возможности HTTP и переменных описаны в официальной документации Claude Code. При обновлении клиента сверяйте поддерживаемый формат и выбранную область конфигурации.

Передайте окружение процессу

Задайте TENDER_MCP_KEY до запуска Claude Code и убедитесь, что новый процесс наследует окружение. Переменная из другого терминала не появляется в уже запущенном клиенте. После изменения ключа перезапустите подключение подходящим для вашего клиента способом.

Ключ Закупки MCP нельзя заменить ключом Anthropic. Это разные сервисы и разные права. Если вы делитесь конфигурацией с командой, в общем файле должно остаться только имя переменной; каждый участник использует свой доступ.

Откройте /mcp в Claude Code и проверьте состояние сервера tenders. При необходимости подтвердите подключение проекта. Не вставляйте значение ключа в вывод диагностики и не публикуйте полный сетевой заголовок.

Проверьте вызов на небольшой задаче

Используй сервер tenders: покажи доступные источники и найди несколько собранных закупок по слову «ремонт». Верни номера и ссылки. Не запускай новый сбор. Если сервер недоступен, сообщи ошибку вместо общего ответа о тендерах.

Нужен реальный вызов инструмента и результат из его ответа. Затем проверьте одну карточку по исходной ссылке. Успешное подключение ещё не подтверждает полноту рынка или актуальность всех сохранённых записей.

Для перехода к документам попросите получить список вложений, выбрать доступное ТЗ и прочитать небольшой раздел. Агент должен сохранить привязку вывода к файлу и блоку текста. Если файл требует OCR, это отдельное состояние, а не готовый текст для анализа.

Как работать с длинным ТЗ

Сначала запросите структуру и статус чтения файлов. Затем разбирайте предмет, сроки, объём и приёмку отдельными шагами. Не просите модель делать уверенный итог по первому фрагменту, если остальная часть документа ещё не прочитана.

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

Типичные проблемы

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