Canli Paper Trading — MCP-сервер для Claude Code
MCP-сервер даёт агенту торговать на бумажном счёте Alpaca, но не позволяет обойти проверки перед отправкой ордера. Ключи остаются в вашем окружении.
claude mcp add --env ALPACA_PAPER_KEY_ID=<ALPACA_PAPER_KEY_ID> --env ALPACA_PAPER_SECRET_KEY=<ALPACA_PAPER_SECRET_KEY> --env CANLI_HOME=<CANLI_HOME> --transport stdio mcp-paper -- npx -y canli-paper-trading-mcpЧто делает Canli Paper Trading
Сервер работает локально через stdio. Агент может посмотреть счёт, собрать ордера по целевым весам, прогнать их через проверки и отправить — но только те, что прошли. Каждый ордер сверяется с вашими лимитами, торговым календарём и рубильником. Прошедшие получают токен на пять минут, и отправить ордер можно только с ним.
Лимиты лежат в CANLI_HOME/limits.json (по умолчанию ~/.canli): максимальный номинал ордера, доля позиции, общий и чистый лимиты, разрешённые типы ордеров. Вызов может ужесточить их для одной проверки, ослабить — нет. Пока в каталоге есть файл KILL, ни один предпросмотр не проходит и отправка отклоняется. Токен привязан к конкретным ордерам: поменяли количество — он больше не сработает. Сервер перезапустили — старые токены недействительны.
Бумажный счёт — единственный режим. Живые ключи сервер не принимает, хоста для реальной торговли в пакете нет. Заполнения на бумаге — симуляция Alpaca, без очереди и влияния на рынок, поэтому стратегия, показавшая себя на бумаге, ещё не доказала, что работает вживую. Для запуска нужны бумажные ключи Alpaca (id начинается с PK) и Node.js — сервер ставится через npx.
Какие задачи решает
- дать агенту торговать на бумажном счёте, не выпуская контроль из рук
- проверить ордера по своим лимитам до отправки
- перевести целевые веса из бэктеста в целые акции
- остановить торговлю одним файлом
KILL - получить подписанное подтверждение, какие ордера и против каких лимитов проверялись
Примеры запросов агенту
- Покажи состояние бумажного счёта: капитал, позиции, открытые ордера и часы рынка.
- Перебалансируй бумажный счёт до 60% SPY и 40% TLT, покажи проверки и отправь, если всё проходит.
- Отмени открытый ордер по его id.
Как установить Canli Paper Trading
Командой платформы
claude mcp add --env ALPACA_PAPER_KEY_ID=<ALPACA_PAPER_KEY_ID> --env ALPACA_PAPER_SECRET_KEY=<ALPACA_PAPER_SECRET_KEY> --env CANLI_HOME=<CANLI_HOME> --transport stdio mcp-paper -- npx -y canli-paper-trading-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp-paper --env ALPACA_PAPER_KEY_ID=<ALPACA_PAPER_KEY_ID> --env ALPACA_PAPER_SECRET_KEY=<ALPACA_PAPER_SECRET_KEY> --env CANLI_HOME=<CANLI_HOME> -- npx -y canli-paper-trading-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-paper": {
"command": "npx",
"args": [
"-y",
"canli-paper-trading-mcp"
],
"env": {
"ALPACA_PAPER_KEY_ID": "<ALPACA_PAPER_KEY_ID>",
"ALPACA_PAPER_SECRET_KEY": "<ALPACA_PAPER_SECRET_KEY>",
"CANLI_HOME": "<CANLI_HOME>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-paper": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"canli-paper-trading-mcp"
],
"env": {
"ALPACA_PAPER_KEY_ID": "<ALPACA_PAPER_KEY_ID>",
"ALPACA_PAPER_SECRET_KEY": "<ALPACA_PAPER_SECRET_KEY>",
"CANLI_HOME": "<CANLI_HOME>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ALPACA_PAPER_KEY_ID=<ALPACA_PAPER_KEY_ID> -e ALPACA_PAPER_SECRET_KEY=<ALPACA_PAPER_SECRET_KEY> -e CANLI_HOME=<CANLI_HOME> mcp-paper npx -y canli-paper-trading-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Canli Paper Trading
Как установить Canli Paper Trading в Claude Code?
Выполните claude mcp add canli-paper -e ALPACA_PAPER_KEY_ID=PK... -e ALPACA_PAPER_SECRET_KEY=... -- npx -y canli-paper-trading-mcp, подставив свои бумажные ключи Alpaca.
Что делает Canli Paper Trading?
Даёт агенту четыре инструмента: посмотреть счёт, проверить ордера, перебалансировать по весам и отправить проверенные ордера. Отправка идёт только с токеном, который выдан после успешных проверок.
Можно ли этим торговать на реальном счёте?
Нет. Сервер работает только с бумажным счётом Alpaca и отказывается принимать живые ключи. Настройки для реальной торговли в нём нет.
