MCP-сервер htmlweb.ru

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

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

Что понадобится: компьютер с интернетом, один из агентов ниже, бесплатный аккаунт htmlweb.ru.

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

1. Откройте регистрацию (можно через Google / VK / Яндекс).
2. Войдите в личный кабинет → скопируйте поле api_key (длинная строка).
3. Каждый день — 20 бесплатных запросов на ключ (суммарно по платным сервисам). Бесплатно всегда: get_balance, validate_inn, validate_ogrn, validate_requisites, запрос списка сервисов (tools/list).
4. Дальше вставьте ключ в конфиг агента вместо YOUR_API_KEY.

⚠ Сначала зарегистрируйтесь и скопируйте api_key из профиля. В примерах стоит YOUR_API_KEY — замените на свой.

После входа откройте 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. Вставьте конфиг (не удаляйте другие серверы — добавьте блок htmlweb внутрь mcpServers):

{
    "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/",
            "headers": {
                "Authorization": "Bearer YOUR_API_KEY"
            }
        }
    }
}

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/",
            "headers": {
                "Authorization": "Bearer YOUR_API_KEY"
            }
        }
    }
}

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"
  }]
}

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

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