Kontur.Zakupki — remote MCP (поиск тендеров для Claude)

Remote MCP-сервер поверх API Контур.Закупки (https://api-zakupki.kontur.ru). Транспорт — streamable-http, поэтому подключается к Claude (Cowork / Desktop) как кастомный коннектор по URL: https://<ваш-хост>/mcp.

Это «удалённый» аналог локального пакета kontur-zakupki-mcp (stdio): тот же API, но крутится на сервере и не требует установки на машину пользователя.

Инструменты

Tool	Что делает	Эндпоинт
`zakupki_search`	поиск тендеров по периоду + фильтрам (текст, законы, способы, статусы, регионы, ИНН, НМЦ, СМП)	POST `/external/v1/search`
`zakupki_get(id)`	карточка закупки	GET `/external/v1/purchases/{id}`
`zakupki_results(id)`	результаты закупки	GET `/external/v1/results/{id}`
`zakupki_limits()`	текущие лимиты API	GET `/external/v1/limitGroups`
`zakupki_health()`	задан ли ключ + доступность API	—

Коды фильтров: laws 1=44-ФЗ, 2=223-ФЗ, 3=коммерч.+малые, 5=615-ПП, 8=коммерч., 9=малые · procedures 0=аукцион, 1=котировки, 2=ед.поставщик, 3=конкурс, 5=запрос цен, 99=другое · statuses 1=подача, 2=комиссия, 3=завершены, 4=планируются, 5=отменены · smp 0=не учитывать, 1=СМП, 2=без СМП.

Авторизация

Заголовок X-Kontur-Apikey. Ключ берётся из переменной окружения KONTUR_ZAKUPKI_API_KEY. Активный ключ — в кабинете интегратора https://integrations.kontur.ru (раздел Api-ключи; показывается один раз).

Деплой на Render (5 минут)

Залейте папку kontur-zakupki-remote/ в репозиторий GitHub.
Render → New → Web Service → подключите репозиторий.
Runtime — Docker (Render сам увидит Dockerfile / render.yaml), план Free.
Environment → Add Environment Variable: KONTUR_ZAKUPKI_API_KEY = <ваш активный ключ>.
Create Web Service и дождитесь деплоя.
Адрес коннектора: https://<имя-сервиса>.onrender.com/mcp.

Проверка после деплоя:

https://<host>/ → 404 «Not Found» — это нормально (на корне ничего нет).
открыть в браузере https://<host>/mcp → JSON-ошибка «Not Acceptable: Client must accept text/event-stream» — это значит сервер работает (он ждёт MCP-клиента, а не браузер).

Free-план Render «засыпает» при простое — первый запрос после паузы идёт ~30–50 сек.

Подключение к Claude

Cowork / claude.ai → Settings → Connectors → Add custom connector:

URL: https://<host>/mcp
авторизация не требуется (ключ уже на сервере).

Claude Desktop (claude_desktop_config.json) — через remote MCP:

{
  "mcpServers": {
    "kontur-zakupki": { "url": "https://<host>/mcp" }
  }
}

Примеры запросов в чате

«Найди тендеры по насосам и центрифугам за июнь 2026, 44-ФЗ, этап подачи заявок» → zakupki_search(date_from="2026-06-01", date_to="2026-06-30", text=["насос","центрифуга"], laws=[1], purchase_statuses=[1])
«Покажи карточку закупки » → zakupki_get
«Какие у нас остались лимиты API?» → zakupki_limits

Локальный запуск (для отладки)

pip install -r requirements.txt
KONTUR_ZAKUPKI_API_KEY=<ключ> python server.py     # поднимет http://localhost:8000/mcp

Что дальше (опционально)

Локальный пакет kontur-zakupki-mcp дополнительно умеет матчить тендеры с вашей продуктовой матрицей (44 категории, заводы). Чтобы перенести это в remote-версию, положите product_matrix.json рядом с server.py и добавьте инструменты search_tenders_by_matrix / classify_text (могу собрать отдельно).

Kontur.Zakupki MCP