MCP-сервер htmlweb.ru

Бесплатно через MCP (лимит не списывается): get_balance, validate_*, validate_requisites, запрос списка сервисов (tools/list).
Платно (20/сутки бесплатно суммарно): org, bank, email, geo, whois и др. · тарифы

MCP (Model Context Protocol) — способ подключить внешние «инструменты» к AI-агенту. После настройки агент сам может проверить ИНН, найти банк по БИК, определить оператора телефона и т.д. — без копирования данных вручную. Доступно 37 сервисов, те же тарифы, что REST API на htmlweb.ru.

Что понадобится: Cursor/Claude/VS Code с MCP. Регистрация на сайте не обязательна — ключ выдаёт сервис register_agent.

Endpoint (один для всех клиентов): https://mcp.htmlweb.ru/
Авторизация: агент сам вызывает register_agent, затем Authorization: Bearer api_key

Конечному пользователю не нужен htmlweb.ru. AI-агент сам регистрирует ключ, платит и отвечает пользователю.

1. register_agent — получить api_key (без Authorization).
2. get_balance + get_pricing — остаток и тарифы.
3. Нехватка запросов → create_topup_card (карта, от 50₽) или create_topup_crypto (от 500₽).
4. purchase_requests — купить пакет запросов с баланса ключа агента.
5. Вызов lookup_* / validate_* — ответ пользователю без упоминания поставщика данных.

Machine-readable: commerce.json · llm.txt

1. Добавьте MCP-сервер без Authorization (см. Cursor ниже) или с уже известным ключом.
2. Первый вызов агента: register_agent → сохраните api_key в заголовках следующих запросов.
3. Каждый день — 20 бесплатных запросов на ключ. Бесплатно: register_agent, get_balance, get_pricing, validate_*, tools/list.
4. Ручная регистрация на htmlweb.ru — опционально (тот же api_key в профиле).

✓ Ключ не нужен для подключения: добавьте MCP без Authorization → агент вызовет register_agent и сохранит ключ.

После входа откройте htmlweb.ru/user/mcp.php — там те же инструкции с вашим ключом.

1. Скачайте Cursor и войдите в аккаунт.
2. Cursor → Settings (Ctrl+,) → раздел MCP → Add new global MCP server или отредактируйте файл вручную:
   Windows: %USERPROFILE%\.cursor\mcp.json
   macOS/Linux: ~/.cursor/mcp.json
3. Вставьте конфиг без ключа (агент сам вызовет register_agent):

{
    "mcpServers": {
        "htmlweb": {
            "url": "https://mcp.htmlweb.ru/"
        }
    }
}

Или с уже известным ключом:

{
    "mcpServers": {
        "htmlweb": {
            "url": "https://mcp.htmlweb.ru/",
            "headers": {
                "Authorization": "Bearer YOUR_API_KEY"
            }
        }
    }
}

4. Сохраните файл. Перезапустите Cursor или нажмите Refresh в настройках MCP.
5. Откройте чат (Agent / Composer). Убедитесь, что MCP-сервер htmlweb включён (зелёный индикатор).
6. Проверочный запрос: «Вызови get_balance через MCP htmlweb» или «Проверь контрольную сумму ИНН 7707083893».

Claude Desktop говорит с MCP через локальный процесс. Нужен Node.js (для npx supergateway).

1. Установите Claude Desktop.
2. Откройте конфиг:
   Windows: %APPDATA%\Claude\claude_desktop_config.json
   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Добавьте (или объедините с существующим mcpServers):

{
    "mcpServers": {
        "htmlweb": {
            "command": "npx",
            "args": [
                "-y",
                "supergateway",
                "--streamableHttp",
                "https://mcp.htmlweb.ru/",
                "--oauth2Bearer",
                "YOUR_API_KEY"
            ]
        }
    }
}

4. Полностью закройте Claude Desktop и запустите снова.
5. В чате появится иконка инструментов — спросите: «Какой у меня баланс на htmlweb?» (сервис get_balance).

1. Скачайте Windsurf.
2. Windsurf → Settings → MCP или файл ~/.codeium/windsurf/mcp_config.json (Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json).
3. Формат такой же, как у Cursor — вставьте тот же JSON:

{
    "mcpServers": {
        "htmlweb": {
            "url": "https://mcp.htmlweb.ru/"
        }
    }
}

4. Перезапустите Windsurf. Проверка — как в Cursor.

1. VS Code 1.102+ с включённым GitHub Copilot и поддержкой MCP.
2. Command Palette (Ctrl+Shift+P) → MCP: Open User Configuration.
3. Добавьте сервер (формат как в Cursor):

{
    "mcpServers": {
        "htmlweb": {
            "url": "https://mcp.htmlweb.ru/"
        }
    }
}

4. В Copilot Chat включите использование MCP-сервисов и спросите про ИНН или баланс.

В Responses API можно указать remote MCP. Пример тела запроса (нужен свой OPENAI_API_KEY от OpenAI, не путать с htmlweb):

POST https://api.openai.com/v1/responses
Authorization: Bearer sk-...ваш_ключ_OpenAI...

{
  "model": "gpt-4.1",
  "input": "Проверь ИНН 7707083893 через htmlweb",
  "tools": [{
    "type": "mcp",
    "server_label": "htmlweb",
    "server_url": "https://mcp.htmlweb.ru/",
    "headers": { "Authorization": "Bearer YOUR_API_KEY" },
    "require_approval": "never"
  }]
}

Если конфиг верный, сервер ответит списком из 37 сервисов. Лимит за этот запрос не списывается.

curl (Linux, Git Bash, macOS):

curl -sS -X POST 'https://mcp.htmlweb.ru/' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

PowerShell (Windows):

$headers = @{ Authorization = "Bearer YOUR_API_KEY"; "Content-Type" = "application/json" }
$body = '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' 
Invoke-RestMethod -Uri "https://mcp.htmlweb.ru/" -Method Post -Headers $headers -Body $body

Ожидаемый ответ: HTTP 200 и JSON со списком сервисов (поле "tools" в протоколе MCP). HTTP 401 — неверный или пустой api_key.

Карточка ru.htmlweb/mcp: registry.modelcontextprotocol.io · https://mcp.htmlweb.ru/server.json