🤖 MCP интеграция для AI-агентов
Hosted MCP-сервер на https://ivoque.de/mcp-rpc — 20 готовых tools, без npm-установки. Подключите NeuralIndexer прямо в Claude Desktop, Cursor, Windsurf, ChatGPT или любой другой MCP-совместимый AI-инструмент.
Что такое MCP
Model Context Protocol — открытый стандарт от Anthropic, который позволяет AI-ассистентам безопасно вызывать внешние инструменты. Наш hosted сервер предоставляет весь REST API NeuralIndexer как 20 типизированных tools, и AI-ассистент сам решает, какой вызвать в зависимости от контекста.
Zero install — просто URL и токен
Не нужно ставить npm-пакет, поднимать Node.js или дополнительный сервер. Вставьте https://ivoque.de/mcp-rpc
и ваш токен в конфиг клиента — и AI-агент уже умеет отправлять ссылки на индексацию.
Получить API-токен
Публичного токена нет — у каждого аккаунта свой. Зарегистрируйтесь и получите токен одним из двух способов:
⚠️ Перевыпуск токена немедленно деактивирует предыдущий.
3 шага до AI-индексации
-
1
Зарегистрируйтесь и получите токенЧерез @InderixingBot ($0.38 бонус) или email-форму на главной ($0.05 тест). Сгенерируйте API-токен в кабинете.
-
2
Вставьте hosted MCP URL в свой клиентСкопируйте JSON-сниппет ниже для Claude Desktop / Cursor / Windsurf / ChatGPT, замените
YOUR_API_TOKEN, перезапустите клиент. -
3
Говорите с AI-агентомПопросите модель проверить баланс, отправить ссылки или подписаться на webhook. Cost-guard защитит от случайного крупного списания.
Cursor
Откройте ~/.cursor/mcp.json
или Settings → MCP → Add new MCP Server,
вставьте JSON ниже, замените YOUR_API_TOKEN
и перезапустите Cursor.
{
"mcpServers": {
"ivoque": {
"url": "https://ivoque.de/mcp-rpc",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Claude Desktop
В Claude Desktop откройте Settings → Connectors → Add custom connector:
Connector URL: https://ivoque.de/mcp-rpc Authentication: OAuth → use "Bearer token" Bearer token: YOUR_API_TOKEN
Старые версии Claude Desktop без UI Connectors могут использовать локальный stdio-вариант.
Windsurf
Откройте ~/.codeium/windsurf/mcp_config.json
и добавьте:
{
"mcpServers": {
"ivoque": {
"serverUrl": "https://ivoque.de/mcp-rpc",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
ChatGPT
Settings → Connectors → Custom connector:
Name: NeuralIndexer Description: URL indexation in Google, Bing, Yandex URL: https://ivoque.de/mcp-rpc Authentication: Bearer token Bearer token: YOUR_API_TOKEN
Health-check
Проверьте connectivity с вашей машины перед добавлением сервера в клиент:
curl https://ivoque.de/mcp-rpc
# {"status":"ok","server":"@ivoque/mcp","transport":"streamable-http",...}
curl -X POST https://ivoque.de/mcp-rpc \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Account & Billing — 2 tool’а
ivoque_check_balance
Текущий баланс, цена за ссылку, доступное количество.
free
ivoque_get_balance_history
Постраничный журнал debit/credit с привязкой к submissions.
free
Submissions — 8 tool’ов
v2 (preferred)
ivoque_submit_v2
Auto-split >5000 URLs, идемпотентно через client_batch_id, slow / fast / yandex.
зависит от queue
ivoque_list_submissions
Список с фильтрами по status, engine, label, датам.
free
ivoque_get_submission
Полные детали одной отправки + образцы URL.
free
ivoque_get_submission_links
Постраничные URL с живым indexation_status. only_status: not_indexed для re-submit.
free
ivoque_get_submission_parts
Прогресс по каждой части multi-part submission.
free
v1 (legacy)
ivoque_submit_links
Slow Google + Bing.
$0.0122 / URL
ivoque_submit_links_fast
Fast Google Indexing API.
$0.50 / URL
ivoque_submit_links_yandex
Только Яндекс.
$0.0122 / URL
Indexation Checks — 4 tool’а
ivoque_check_indexation
Запустить Google-проверку (возвращает task_id).
$0.0024 / URL
ivoque_get_indexation_check_status
Опросить статус и результаты (legacy task_id).
free
ivoque_list_indexation_checks
Список всех v2 проверок (auto + manual).
free
ivoque_get_indexation_check_v2
Детали v2-проверки с per-URL результатами.
free
Webhooks — 6 tool’ов
Подписка на события submission.completed,
check.completed,
balance.changed.
Каждая доставка подписывается HMAC-SHA256.
ivoque_list_webhooks
Список подписок аккаунта.
free
ivoque_create_webhook
Создать подписку. HMAC secret возвращается ровно один раз.
free
ivoque_update_webhook
Обновить url / events / is_active / description.
free
ivoque_delete_webhook
Удалить подписку.
free
ivoque_get_webhook_deliveries
Журнал доставок за 30 дней.
free
ivoque_test_webhook
Отправить тестовое событие на ваш receiver.
free
Защитные механизмы
Каждый платный tool требует confirm_estimated_cost_usd. MCP сервер отказывается выполнять запрос, если сумма расходится с расчётом >5%.
Максимум 1000 URL в одном MCP-вызове (настраивается через env). Большие пачки клиент сам разбивает на батчи.
Token-bucket в HTTP-клиенте предотвращает превышение Ivoque-лимита 50 req / 10 sec на IP.
🔒 Каждый запрос к /mcp-rpc создаёт изолированный MCP-инстанс, привязанный к вашему токену. Токены никогда не пишутся на диск — только в памяти, на время одного запроса.
Пример агентного prompt’а
Вы говорите AI-ассистенту:
У меня 200 URL из sitemap.xml. Отправь их через NeuralIndexer медленную индексацию, поставь client_batch_id="weekly-2026-04-28" чтобы повторы не списывали повторно, затем подпиши мой Make.com webhook https://hooks.example.com/done на события submission.completed и check.completed. Через несколько дней покажи URL из этой отправки, которые ещё не проиндексированы.
Что делает агент:
ivoque_check_balance— проверить балансivoque_submit_v2сqueue:"slow",client_batch_id:"weekly-2026-04-28"иconfirm_estimated_cost_usd:2.44(200 × $0.0122)ivoque_create_webhookсevents:["submission.completed","check.completed"]— receiver получит HMAC secret для верификации- Через несколько дней:
ivoque_get_submission_linksсonly_status:"not_indexed"— список URL для re-submit
Local stdio (advanced / offline)
Нужно запустить MCP-сервер целиком на своей машине — для air-gapped сетей, low-latency batch-задач или сочетания с другими локальными tools? Тот же код упакован как stdio CLI.
{
"mcpServers": {
"ivoque": {
"command": "node",
"args": ["/absolute/path/to/ivoque-mcp/dist/index.js"],
"env": { "IVOQUE_API_TOKEN": "YOUR_API_TOKEN" }
}
}
}
Исходники, инструкции по сборке и npm-tarball доступны по запросу у @Inderixing (публичный npm release coming soon).
REST API без MCP
Тот же функционал доступен напрямую как обычное REST API — для CI/CD, дашбордов, WordPress-плагина или интеграции в собственные инструменты.
Открыть API документацию →