Подключить ИИ-ассистента через MCP
Дайте Claude, ChatGPT или Cursor ограниченный по правам доступ к вашим счетам AlgoVesta, чтобы ассистент мог читать ваш портфель и размещать ордера по вашим собственным правилам риска.
Прежде чем начать
- Аккаунт AlgoVesta. 7-дневного пробного периода достаточно — платный тариф для теста не нужен.
- MCP-клиент: Claude в вебе, на десктопе или в мобильном приложении, Claude Code, Cursor, ChatGPT на платном тарифе, Gemini CLI или что угодно другое, что поддерживает Model Context Protocol.
- Ключ. Подключённая биржа для начала не нужна: paper-ключ запускает полный набор инструментов против виртуального баланса $5 000, так что вы можете всё настроить и потренироваться до того, как будет задействован реальный счёт.
1. Создайте свою MCP-ссылку
- Откройте панель AlgoVesta и перейдите на вкладку MCP-подключение
- Нажмите Создать ключ, дайте ему метку, указывающую, где он будет использоваться (например
claude-desktopилиcursor-laptop) - Выберите область доступа:
read— только для вопросов о портфеле,paper— полный набор инструментов против виртуального баланса $5 000, илиlive— для реальных ордеров - Скопируйте появившийся адрес. Он выглядит так:
https://api.algovesta.com/u/avmcp_<your-key>/mcp
live запрашивает второй фактор — TOTP-код из вашего приложения-аутентификатора или код, отправленный на почту. Это подтверждение происходит в панели, с вашим личным участием. Ассистент никогда не может запросить это повышение самостоятельно.2. Добавьте её в Claude
- В Claude откройте Настройки → Коннекторы
- Нажмите Добавить пользовательский коннектор
- Дайте ему имя (
AlgoVesta) и вставьте свою MCP-ссылку в поле URL - Сохраните и начните новый диалог — инструменты появятся в списке инструментов диалога
Этот коннектор синхронизируется между 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. Проверьте подключение
- Начните новый диалог в своём клиенте
- Спросите:
Как мой портфель? - Ассистент должен вызвать инструмент
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 в час. Подождите и повторите попытку. Если это повторяется, обычно это означает, что агент зациклился, а не то, что вы торгуете быстро — стоит проверить, что именно делает ассистент, прежде чем повышать лимит запросов.
Часто задаваемые вопросы
paper работает против виртуального баланса $5 000 с использованием полного набора инструментов. Ордера сопоставляются paper-движком по реальным рыночным ценам, а ответы выглядят так же, как и реальные, так что ассистент ведёт себя точно так же, как если бы на кону были реальные деньги. Каждый новый ключ начинает именно отсюда. Это разумное место, чтобы провести первую неделю.