Tovanix
Tovanix

Доступ 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.yaml
    mcp_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.yaml
    mcpServers:
      - 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.yaml
    extensions:
      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/crushrc
    mcp 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 · Интеграция для разработчиков

Загрузка…