Справочный центр › Начало работы

Подключить ИИ-ассистента через MCP

Дайте Claude, ChatGPT или Cursor ограниченный по правам доступ к вашим счетам AlgoVesta, чтобы ассистент мог читать ваш портфель и размещать ордера по вашим собственным правилам риска.

Прежде чем начать

  1. Аккаунт AlgoVesta. 7-дневного пробного периода достаточно — платный тариф для теста не нужен.
  2. MCP-клиент: Claude в вебе, на десктопе или в мобильном приложении, Claude Code, Cursor, ChatGPT на платном тарифе, Gemini CLI или что угодно другое, что поддерживает Model Context Protocol.
  3. Ключ. Подключённая биржа для начала не нужна: paper-ключ запускает полный набор инструментов против виртуального баланса $5 000, так что вы можете всё настроить и потренироваться до того, как будет задействован реальный счёт.

1. Создайте свою MCP-ссылку

  1. Откройте панель AlgoVesta и перейдите на вкладку MCP-подключение
  2. Нажмите Создать ключ, дайте ему метку, указывающую, где он будет использоваться (например claude-desktop или cursor-laptop)
  3. Выберите область доступа: read — только для вопросов о портфеле, paper — полный набор инструментов против виртуального баланса $5 000, или live — для реальных ордеров
  4. Скопируйте появившийся адрес. Он выглядит так:
https://api.algovesta.com/u/avmcp_<your-key>/mcp
⚠️
Ссылка показывается один раз. После этого AlgoVesta хранит только отпечаток, поэтому показать её повторно нельзя — если вы её потеряли, удалите ключ и создайте новый. Относитесь к ней в точности как к паролю: тот, у кого она есть, может действовать в рамках её области доступа на ваших счетах. Никогда не вставляйте её в публичный чат, скриншот, общий документ или тикет поддержки.
🔑
Выбор области доступа live запрашивает второй фактор — TOTP-код из вашего приложения-аутентификатора или код, отправленный на почту. Это подтверждение происходит в панели, с вашим личным участием. Ассистент никогда не может запросить это повышение самостоятельно.

2. Добавьте её в Claude

  1. В Claude откройте НастройкиКоннекторы
  2. Нажмите Добавить пользовательский коннектор
  3. Дайте ему имя (AlgoVesta) и вставьте свою MCP-ссылку в поле URL
  4. Сохраните и начните новый диалог — инструменты появятся в списке инструментов диалога

Этот коннектор синхронизируется между Claude в вебе, на десктопе и в мобильном приложении, так что, добавив его один раз, вы охватите и телефон. Если вы предпочитаете вообще не вставлять секретный адрес, AlgoVesta также предоставляет стандартную конечную точку OAuth 2.1 по адресу https://api.algovesta.com/mcp с PKCE (S256) и Dynamic Client Registration — направьте коннектор туда, и вас проведут через обычный экран согласия в браузере.

3. Добавьте её в Claude Code

Одна команда регистрирует сервер через streamable HTTP:

claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp

После этого выполните claude mcp list, чтобы убедиться, что сервер зарегистрирован и доступен.

4. Добавьте её в Cursor или ChatGPT

Cursor читает JSON-файл конфигурации. Добавьте одну запись в mcp.json:

{"mcpServers":{"algovesta":{"url":"https://api.algovesta.com/u/avmcp_<your-key>/mcp"}}}

Gemini CLI использует ту же запись, но называет поле httpUrl вместо url. Всё остальное идентично.

ChatGPT поддерживает пользовательские MCP-коннекторы на платных тарифах, с включённым в настройках режимом разработчика. Добавьте там коннектор и вставьте ту же ссылку.

5. Проверьте подключение

  1. Начните новый диалог в своём клиенте
  2. Спросите: Как мой портфель?
  3. Ассистент должен вызвать инструмент get_portfolio_context и ответить вашими реальными балансами и открытыми позициями — на paper-ключе, с виртуальным балансом $5 000

Если он отвечает общими фразами, не вызывая инструмент, значит сервер не подключён: ассистент говорит о торговле вообще, а не о вашем счёте. Перепроверьте ссылку и перезапустите клиент.

Что может ассистент после подключения

Доступно двадцать инструментов. Четырнадцать из них читают или репетируют и ничего не меняют: get_portfolio_context, get_market_price, get_trade_history, compare_venues, simulate_order, list_open_orders, list_strategies, verify_receipt, replay_channel и compile_policy. Шесть из них записывают: place_order, close_position, modify_position, cancel_order, create_strategy и update_strategy.

Вы не вызываете их по имени. Спрашивайте на обычном языке — «что у меня в портфеле?», «сколько будет стоить 0.1 BTC прямо сейчас?», «закрой половину моей позиции по ETH» — и ассистент сам выберет инструменты и объединит их в цепочку. Стоп-лосс обязателен для каждой открываемой им позиции, и ни один инструмент не позволяет удалить его впоследствии. Полные схемы для каждого инструмента — в документации для разработчиков.

Решение проблем

401 unauthorized

Ключ был отозван, удалён, либо адрес введён с ошибкой. Это самый частый сбой, когда ссылка вставлялась вручную или была скопирована с лишним пробелом. Проверьте, что ключ всё ещё существует на вкладке MCP-подключение; если существует, удалите его и создайте новый, а не пытайтесь исправить строку.

insufficient_scope

Инструменту, который попытался вызвать ассистент, нужна более высокая область доступа, чем у ключа. Ключ read не может вызвать place_order, а ключ paper не может обратиться к реальному счёту. Области доступа ранжированы, поэтому инструмент, требующий paper, отклоняет ключ read. Либо примите это ограничение, либо выпустите новый ключ с той областью доступа, которая вам действительно нужна — переход на live требует второго фактора.

user_frozen

На вашем счёте активирован аварийный выключатель, который останавливает все ключи сразу. Это сделано намеренно: это аварийный тормоз. Снимите блокировку в панели, когда захотите возобновить торговлю. Если вы хотели отключить только одного клиента, отзовите именно этот ключ — остальные продолжат работать.

rate_limited

Вы превысили 60 запросов в минуту на этот ключ. Для ресурсоёмких инструментов действуют более жёсткие лимиты: place_order ограничен 10 в минуту, а replay_channel — 5 в час. Подождите и повторите попытку. Если это повторяется, обычно это означает, что агент зациклился, а не то, что вы торгуете быстро — стоит проверить, что именно делает ассистент, прежде чем повышать лимит запросов.

Часто задаваемые вопросы

Никогда. Ваши API-ключи биржи остаются зашифрованными внутри AlgoVesta и никогда не отправляются ассистенту или вашему провайдеру ИИ. У ассистента есть MCP-ссылка: ограниченная по правам, отзываемая дверь к счетам, которые вы уже контролируете. Он обращается к AlgoVesta, а AlgoVesta говорит с биржей. На поверхности протокола также вообще нет инструмента для вывода средств, поэтому ассистенту нечего вызвать, чтобы переместить деньги.
Ключ с областью доступа paper работает против виртуального баланса $5 000 с использованием полного набора инструментов. Ордера сопоставляются paper-движком по реальным рыночным ценам, а ответы выглядят так же, как и реальные, так что ассистент ведёт себя точно так же, как если бы на кону были реальные деньги. Каждый новый ключ начинает именно отсюда. Это разумное место, чтобы провести первую неделю.
Удалите ключ на вкладке MCP-подключение панели. Это действует немедленно — следующий вызов от этого клиента вернёт 401 unauthorized. Каждый ключ независим, поэтому отзыв ключа в Cursor не затронет ваше подключение в Claude. Чтобы отключить всё сразу, используйте аварийный выключатель, который замораживает все ключи, пока вы его не снимете.
Впервые в AlgoVesta? Платформа запускает ваши сигналы Telegram и TradingView на 16 биржах и MetaTrader с доступом по API только для торговли — ваши средства всегда остаются под вашим собственным контролем.
Начать бесплатный пробный период