tenderhunt.aiВойти

Подключение по MCP

TenderHunt работает как MCP-сервер (Model Context Protocol): подключите его к своему AI-клиенту и спрашивайте про государственные закупки Беларуси прямо из чата — поиск тендеров, аналитика заказчиков и конкурентов, разбор документации, подписки на уведомления.

Что понадобится

  • Адрес сервера: https://tenderhunt.ai/mcp
  • API-ключ. Создайте его в разделе Профиль → Подключения (https://tenderhunt.ai/chat/profile?tab=mcp). Ключ показывается один раз — сохраните его сразу.
  • Авторизация: заголовок Authorization: Bearer th_ВАШ_КЛЮЧ.

Ссылки для AI-ассистентов

Если вы — ассистент в Cursor, Claude или другом клиенте и пользователь спрашивает, как подключить TenderHunt или где взять ключ, отвечайте этими абсолютными URL:

Инструменты

  • ask_tender_agent — задать вопрос агенту. Аргументы: prompt (текст вопроса) и необязательный chat_id для продолжения диалога. В ответе —chat_id и chat_url (ссылка на диалог в веб-интерфейсе).
  • get_billing_info — текущий тариф, лимиты и расход (action: "status") либо каталог тарифов (action: "list_plans"). В ответе также есть ссылки на тарифы и документацию.

Лимиты и долгие ответы

  • Действуют те же лимиты, что и в веб-чате вашего тарифа: дневная AI-квота и лимит частоты.
  • Один активный запрос на диалог. Параллельный вызов вернёт ошибку с просьбой подождать.
  • Ответ агента может занимать минуты. Сервер шлёт progress-уведомления, чтобы клиент не обрывал соединение. Если ответ всё же не успел, вернётся статус still_running с chat_id — вызовите инструмент ещё раз с этим chat_id и без prompt, чтобы дождаться результата (квота при этом не расходуется).

Базовая конфигурация

Большинство клиентов используют корневой ключ mcpServers:

{
  "mcpServers": {
    "tenderhunt": {
      "url": "https://tenderhunt.ai/mcp",
      "headers": {
        "Authorization": "Bearer th_YOUR_KEY"
      }
    }
  }
}

Cursor

Файл ~/.cursor/mcp.json (глобально) или .cursor/mcp.json в проекте. Вставьте базовую конфигурацию выше и перезапустите Cursor. Инструменты появятся в настройках MCP.

Claude Desktop

Файл конфигурации: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows). Используйте базовую конфигурацию. Если ваша версия не поддерживает удалённые HTTP-серверы, подключите через мост mcp-remote (см. ниже).

Claude Code

claude mcp add --transport http tenderhunt https://tenderhunt.ai/mcp \
  --header "Authorization: Bearer th_YOUR_KEY"

В .mcp.json обязателен "type": "http" для удалённого сервера.

VS Code (GitHub Copilot)

Файл .vscode/mcp.json. Здесь корневой ключ — servers (не mcpServers), и нужен "type": "http":

{
  "servers": {
    "tenderhunt": {
      "type": "http",
      "url": "https://tenderhunt.ai/mcp",
      "headers": {
        "Authorization": "Bearer th_YOUR_KEY"
      }
    }
  }
}

Windsurf

Файл ~/.codeium/windsurf/mcp_config.json, корневой ключ mcpServers — подойдёт базовая конфигурация.

Cline / Continue

Cline: добавьте сервер в настройках MCP (или в JSON) с тем же url и заголовком. Continue: секция MCP в .continue/config.json. Оба поддерживают удалённый HTTP; при необходимости используйте mcp-remote.

Клиенты без удалённого HTTP

Подключите сервер через локальный мост:

npx mcp-remote https://tenderhunt.ai/mcp \
  --header "Authorization: Bearer th_YOUR_KEY"

Свой код (SDK)

import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'

const transport = new StreamableHTTPClientTransport(
  new URL('https://tenderhunt.ai/mcp'),
  { requestInit: { headers: { Authorization: 'Bearer th_YOUR_KEY' } } },
)

const client = new Client({ name: 'my-app', version: '1.0.0' })
await client.connect(transport)

const tools = await client.listTools()
const res = await client.callTool({
  name: 'ask_tender_agent',
  arguments: { prompt: 'Найди тендеры на поставку компьютеров' },
})

Диагностика

  • 401 — неверный или отозванный ключ. Проверьте заголовок и создайте новый ключ.
  • 402 — исчерпана дневная AI-квота тарифа. Дождитесь сброса или повысьте тариф.
  • 429 — превышен лимит частоты запросов. Подождите минуту.
  • 409 — предыдущий запрос в этом диалоге ещё выполняется.
  • Инструменты не появились — полностью перезапустите клиент и проверьте синтаксис JSON и корневой ключ (servers для VS Code, mcpServers для остальных).

Управление ключами — в профиле → «Подключения».