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, но крутится на сервере и не требует установки на машину пользователя.

Инструменты

Коды фильтров: 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=без СМП.

Related MCP server: Prozorro MCP Server

Авторизация

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

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

1. Залейте папку kontur-zakupki-remote/ в репозиторий GitHub.

2. Render → New → Web Service → подключите репозиторий.

3. Runtime — Docker (Render сам увидит Dockerfile / render.yaml), план Free.

4. Environment → Add Environment Variable: KONTUR_ZAKUPKI_API_KEY = <ваш активный ключ>.

5. Create Web Service и дождитесь деплоя.

6. Адрес коннектора: 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 (могу собрать отдельно).