Доступ MCP
Подключите аккаунт Tovanix к любому ИИ-клиенту с поддержкой MCP. Адрес https://tovanix.com/api/mcp/rpc использует Streamable HTTP без состояния и принимает только POST.
- Авторизация: Authorization: Bearer <credential> или заголовок X-MCP-Key; ключи начинаются с mcp_live_ и показываются один раз
- Разрешения: все возможности изначально выключены; tools/list возвращает только включённые, с именами из tovanix_ и названия возможности
- Инструменты расходов и необратимых действий требуют одноразового кода totp_code и соблюдают лимиты на вызов и сутки
- Списки разрешённых исходных IP, сроки действия и стандартный лимит 120 вызовов в минуту (до 600)
- Три ресурса (каталог возможностей, обзор аккаунта, руководство платформы) и три шаблона запросов (проверка аккаунта, отчёт расходов, проверка сроков)
- Ошибки: 401 неверный ключ, 403 запрещённый источник или состояние аккаунта, 405 метод не POST, 413 слишком большой запрос
- Создание ключа требует прочтения и принятия соглашения о доступе MCP. За содержимое и действия от вашего имени отвечаете вы
- Помимо расходов и необратимых действий, важные настройки — адреса уведомлений, публичные публикации и открытый доступ к бакетам — также требуют одноразового кода. Публикации ИИ, сообщения поддержке, письма и чтение Telegram в реальном времени ограничены на аккаунт. Повторные публикации и сообщения поддержке отклоняются; сообщения помечаются «Отправлено через ИИ-помощника»
POST /api/mcp/rpc
Три вида доступа, каждый со своей задачей
MCP (Model Context Protocol) позволяет клиентам ИИ, например Claude, вызывать возможности вашего аккаунта Tovanix как «инструменты». В консоли вы создаёте учётные данные MCP для каждого клиента и по отдельности разрешаете ему нужные возможности; клиент подключается к конечной точке с этими данными и может получать сведения и выполнять действия прямо в диалоге.
У MCP отдельная конечная точка и учётные данные, независимые от открытого API и входа в консоль: удаление учётных данных MCP не влияет на действующие интеграции с открытым API, и наоборот.
- Открытый API /api/v1/* — API-ключ (X-API-Key / подпись) — Ваши программы — Согласно настройкам ключа
- MCP /api/mcp/rpc — Учётные данные MCP (Bearer) — Клиенты ИИ — Нет — включаются по отдельности
- Консоль — Сеанс входа — Вы — Всё в вашем аккаунте
Быстрый старт
Подключиться может любой MCP-клиент, поддерживающий Streamable HTTP и настройку заголовков запросов. Выберите инструмент ниже и скопируйте соответствующую команду или настройки.
Учётные данные также можно проверить вызовом tools/list через curl: сервер не хранит состояние, поэтому предварительный вызов initialize не требуется.
Хранится только хеш учётных данных, поэтому восстановить их нельзя. При потере удалите их и создайте новые. Храните их в настройках клиента; никогда не размещайте в публичном репозитории, на снимке экрана или в чате.
Конечная точка и аутентификация
На странице «Доступ MCP» в консоли показана конечная точка вашего аккаунта, которую можно скопировать.
- Конечная точка — Все запросы отправляются на этот единственный URL.
- Транспорт — Streamable HTTP без хранения состояния: каждый запрос аутентифицируется отдельно, принимается только POST, Mcp-Session-Id не выдаётся; GET и DELETE возвращают 405.
- Аутентификация — Authorization: Bearer <credential>. Если клиент позволяет добавлять только пользовательские заголовки, но не менять Authorization, используйте вместо него X-MCP-Key: <credential>.
- Версии протокола — 2025-06-18 (последняя), 2025-03-26 и 2024-11-05; версия согласуется на основе переданной клиентом в initialize. Неподдерживаемые версии заменяются последней.
- Сообщения — JSON-RPC 2.0, ограничение тела запроса — 1 МБ. Пакетные запросы старых клиентов могут содержать не более 32 элементов.
- Запросы браузера — Запросы с заголовком Origin не с сайтов самой платформы отклоняются (защита от DNS rebinding). Настольные клиенты и клиенты командной строки не отправляют Origin, поэтому ограничение их не затрагивает.
Учётные данные и разрешения
Учётные данные начинаются с mcp_live_ и состоят из 73 символов. У каждого набора отдельные настройки, указанные ниже; их можно изменить в консоли в любое время. Просроченные или отключённые учётные данные сразу перестают работать.
Перед созданием учётных данных нужно прочитать и принять соглашение о доступе MCP. Оно описывает риски управления аккаунтом через ИИ и ответственность за них: операции и потери через MCP находятся под вашей ответственностью. Если соглашение не опубликовано, учётные данные создать нельзя. После обновления для новых учётных данных требуется повторное принятие, а существующие продолжают работать.
Пока аккаунт ограничен, MCP разрешает только чтение; запись, расходы и необратимые действия отклоняются с сообщением о необходимости перейти в консоль. Если аккаунт заморожен, все запросы возвращают 403.
Инструменты и названия
Название инструмента = tovanix_ + имя возможности с заменой точек на подчёркивания. Например, account.balance.get становится инструментом tovanix_account_balance_get.
tools/list возвращает только возможности, разрешённые для этих учётных данных. Описание каждого инструмента объясняет, когда его использовать, что означают параметры и на что обратить внимание; так клиенты ИИ выбирают инструменты.
Чтение: только просмотр данных. Запись: обратимые изменения, например редактирование примечания. Расходы: списание денег с баланса. Необратимые действия: нельзя отменить, например удаление ключа или закрытие карты. Инструменты расходов и необратимых действий требуют одноразового кода (см. следующий раздел). Некоторые обратимые изменения, которые всё же требуют немедленного одобрения — изменение URL обратного вызова, публикация записи, открытие публичного доступа к бакету — также требуют код; в консоли они отмечены «Требуется код».
Одноразовые коды
Инструменты расходов и необратимых действий принимают дополнительный параметр totp_code — текущий шестизначный код из приложения-аутентификатора. ИИ не может получить этот код самостоятельно и попросит его у вас при необходимости. То же относится к инструментам с пометкой «Требуется код».
- Каждый код используется только один раз. Код, только что использованный в консоли, нельзя повторно использовать и через MCP.
- Если в аккаунте не включена двухфакторная аутентификация, эти инструменты всегда отклоняются с предложением включить её в консоли.
- Код проверяется первым, поэтому неверный код никогда не расходует суточный лимит.
Лимиты расходов
Каждый платный вызов последовательно проходит эти четыре этапа; если любой из них не выполнен, деньги не списываются.
confirmed_total_usd
Большинство платных инструментов требует confirmed_total_usd — итоговую сумму, которую ИИ сообщил вам и которую вы одобрили. Если цена при выполнении выше, действие не выполняется, а ИИ сообщает новую цену.
Что происходит с лимитом при сбое
Если вызов завершился ошибкой и достоверно известно, что списания не было, резерв лимита освобождается. Если результат списания нельзя подтвердить, сумма остаётся зарезервированной, чтобы возможное списание не выпало из подсчёта. В счетах указаны фактически списанные суммы.
Лимиты частоты и отправляемый от вашего имени контент
Помимо лимита отдельных учётных данных, инструменты публикации контента от вашего имени или реальных запросов к Telegram имеют лимиты на аккаунт. Они общие для всех учётных данных аккаунта и сбрасываются ежедневно в 00:00 UTC+8. Вызовы сверх лимита отклоняются, а ИИ получает указание остановиться. Полностью одинаковые записи сообщества и сообщения поддержки, повторённые в течение 10 минут, также отклоняются; письма проверяются на повторы по ключу идемпотентности, а не по содержимому. В консоли эти инструменты отмечены «Ограничена частота».
Контент, отправляемый от вашего имени
После включения соответствующих инструментов ИИ может от вашего имени публиковать записи и ответы в сообществе, писать онлайн-поддержке и отправлять письма через ваш SMTP-аккаунт. Этот контент представляет вас, и вы несёте за него ответственность:
Ресурсы и промпты
Кроме инструментов, сервер предоставляет три ресурса только для чтения и три промпта, которые клиенты могут использовать напрямую.
- tovanix://catalog — Каталог возможностей: все разделы и возможности с указанием разрешённых для этих учётных данных. ИИ читает его при ошибке «нет разрешения» или вопросе о доступных действиях.
- tovanix://account/overview — Обзор аккаунта: состояние аккаунта, используемые услуги, разрешения этих учётных данных и расход суточного лимита. Баланс показывается только при включённой возможности «Просмотр баланса аккаунта».
- tovanix://guide — Руководство платформы: представление сумм и валют, состояния заказов и сведения, которые нужно подтвердить перед оформлением заказа.
- account_health — — — Проверка аккаунта: баланс, подписки и сроки услуг, необычные заказы и список необходимых действий.
- spend_report — days, по умолчанию 30 — Отчёт о расходах: последние счета и расходы по услугам.
- renewal_check — within_days, по умолчанию 14 — Проверка сроков: услуги, которые скоро истекут, и стоимость продления — автоматического продления не происходит.
Ошибки и их устранение
Проблемы подключения и аутентификации возвращаются как коды состояния HTTP. Ошибки операций возвращаются в результатах инструментов (isError: true), текст которых указывает ИИ дальнейшее действие, например «попросить у пользователя одноразовый код» или «недостаточно средств — попросить сначала пополнить баланс».
Подключение Tovanix MCP из различных ИИ-инструментов
Замените <YOUR_MCP_CREDENTIAL> ключом MCP, созданным в консоли.
- Claude Code — Выполнить в терминале
claude mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" - Codex — Файл конфигурации:
~/.codex/config.toml[mcp_servers.tovanix] url = "https://tovanix.com/api/mcp/rpc" bearer_token_env_var = "TOVANIX_MCP_CREDENTIAL" - Cursor — Файл конфигурации:
~/.cursor/mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - GitHub Copilot (VS Code) — Файл конфигурации:
.vscode/mcp.json{ "servers": { "tovanix": { "type": "http", "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer ${input:tovanix-credential}" } } }, "inputs": [ { "type": "promptString", "id": "tovanix-credential", "description": "Tovanix MCP credential", "password": true } ] } - Gemini CLI — Файл конфигурации:
~/.gemini/settings.json{ "mcpServers": { "tovanix": { "httpUrl": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - OpenCode — Файл конфигурации:
~/.config/opencode/opencode.json{ "$schema": "https://opencode.ai/config.json", "mcp": { "tovanix": { "type": "remote", "url": "https://tovanix.com/api/mcp/rpc", "enabled": true, "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Qwen Code — Выполнить в терминале
qwen mcp add --scope user --transport http tovanix https://tovanix.com/api/mcp/rpc --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" - Kimi Code CLI — Файл конфигурации:
~/.kimi-code/mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - CodeBuddy Code — Выполнить в терминале
codebuddy mcp add --scope user --transport http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" tovanix https://tovanix.com/api/mcp/rpc - Qoder CLI — Файл конфигурации:
~/.qoder/settings.json{ "mcpServers": { "tovanix": { "type": "streamable-http", "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Kiro — Файл конфигурации:
~/.kiro/settings/mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Trae — Файл конфигурации:
.trae/mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Trae CN — Файл конфигурации:
.trae/mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Trae CLI — Файл конфигурации:
trae_cli.yamlmcp_servers: - name: "tovanix" url: "https://tovanix.com/api/mcp/rpc" type: "http" headers: Authorization: "Bearer <YOUR_MCP_CREDENTIAL>" - GitHub Copilot CLI — Файл конфигурации:
~/.copilot/mcp-config.json{ "mcpServers": { "tovanix": { "type": "http", "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" }, "tools": [ "*" ] } } } - Cline — Файл конфигурации:
cline_mcp_settings.json{ "mcpServers": { "tovanix": { "type": "streamableHttp", "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Kilo Code — Файл конфигурации:
~/.config/kilo/kilo.jsonc{ "mcp": { "tovanix": { "type": "remote", "url": "https://tovanix.com/api/mcp/rpc", "enabled": true, "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Continue — Файл конфигурации:
~/.continue/config.yamlmcpServers: - name: tovanix type: streamable-http url: https://tovanix.com/api/mcp/rpc requestOptions: headers: Authorization: Bearer <YOUR_MCP_CREDENTIAL> - Zed — Файл конфигурации:
~/.config/zed/settings.json{ "context_servers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Junie — Файл конфигурации:
~/.junie/mcp/mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Amp — Файл конфигурации:
~/.config/amp/settings.json{ "amp.mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Goose — Файл конфигурации:
~/.config/goose/config.yamlextensions: tovanix: enabled: true type: streamable_http name: tovanix uri: https://tovanix.com/api/mcp/rpc headers: Authorization: "Bearer <YOUR_MCP_CREDENTIAL>" timeout: 300 - Augment (Auggie) — Выполнить в терминале
auggie mcp add tovanix --transport http --url https://tovanix.com/api/mcp/rpc --header "Authorization:Bearer <YOUR_MCP_CREDENTIAL>" - Factory Droid — Выполнить в терминале
droid mcp add tovanix https://tovanix.com/api/mcp/rpc --type http --header "Authorization: Bearer <YOUR_MCP_CREDENTIAL>" --no-oauth - Crush — Файл конфигурации:
~/.config/crush/crushrcmcp add tovanix --type http --url https://tovanix.com/api/mcp/rpc --header Authorization "Bearer <YOUR_MCP_CREDENTIAL>" - Warp — Вставить в настройки приложения
{ "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } - Windsurf — Файл конфигурации:
~/.codeium/windsurf/mcp_config.json{ "mcpServers": { "tovanix": { "serverUrl": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Claude (веб / настольное приложение) — Введите адрес в приложении и добавьте заголовок Authorization (Bearer + ключ доступа)
https://tovanix.com/api/mcp/rpc - LM Studio — Файл конфигурации:
mcp.json{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } } - Dify — Введите адрес в приложении и добавьте заголовок Authorization (Bearer + ключ доступа)
https://tovanix.com/api/mcp/rpc - Coze — Введите адрес в приложении и добавьте заголовок Authorization (Bearer + ключ доступа)
https://tovanix.com/api/mcp/rpc - n8n — Введите адрес в приложении и добавьте заголовок Authorization (Bearer + ключ доступа)
https://tovanix.com/api/mcp/rpc - Другие MCP-клиенты — Вставить в настройки приложения
{ "mcpServers": { "tovanix": { "url": "https://tovanix.com/api/mcp/rpc", "headers": { "Authorization": "Bearer <YOUR_MCP_CREDENTIAL>" } } } }
Часто задаваемые вопросы
Почему tools/list возвращает пустой список?
Для ключа ещё не включены возможности. Включите нужные в разделе «Доступ MCP» консоли и подключитесь заново.
Почему инструменты расходов всегда отклоняются?
Проверьте три условия: остались ли лимиты расходов на значении по умолчанию 0, включена ли двухфакторная аутентификация и исчерпан ли суточный лимит.
Связанные страницы: Поручите ИИ-помощнику управление аккаунтом Tovanix · Документация API · Интеграция для разработчиков
Загрузка…