Подключение к ИИ-агентам

MCP — открытый способ дать модели доступ к источнику данных: агент видит перечень инструментов и вызывает их сам, когда они нужны для ответа. Наш сервер — тонкая обёртка над тем же машинным интерфейсом, что описан на странице «Разработчикам»: он не добавляет ни своих данных, ни своей нагрузки, и работает с вашим ключом читателя.

Установка

pip install tradealmanac-mcp

# проверить ключ до всякого редактора
TRADEALMANAC_API_KEY=afk_… tradealmanac-mcp --check

npx -y @tradealmanac/mcp-server --tools

Две реализации равнозначны: инструменты, потолки и ответы у них одинаковы, манифест общий. Выбирайте ту, чей язык уже стоит на машине. Зависимостей нет ни у одной — сервер живёт в окружении вашего редактора, и тянуть туда чужие пакеты незачем.

Claude Desktop

{
  "mcpServers": {
    "tradealmanac": {
      "command": "tradealmanac-mcp",
      "env": { "TRADEALMANAC_API_KEY": "afk_…" }
    }
  }
}

Файл лежит в настройках приложения, раздел «Developer». После правки перезапустите Claude Desktop — перечень инструментов читается один раз при старте.

Cursor

{
  "mcpServers": {
    "tradealmanac": {
      "command": "npx",
      "args": ["-y", "@tradealmanac/mcp-server"],
      "env": { "TRADEALMANAC_API_KEY": "afk_…" }
    }
  }
}

Конфиг в проекте действует только в нём, в домашнем каталоге — везде. Тот же блок понимают и другие агентные редакторы: формат конфигурации у MCP общий.

Claude Code

claude mcp add tradealmanac \
  --env TRADEALMANAC_API_KEY=afk_… -- tradealmanac-mcp

По адресу, без установки

Тот же сервер отвечает по адресу — для клиентов, которые подключают сервер ссылкой: вставьте её в поле адреса сервера MCP. Инструменты, потолки и ответы те же, что у пакетов. Ключ передаётся заголовком Authorization; без ключа отвечают индикаторы, календарные эффекты и списки, остальным инструментам нужен ключ — подойдёт и тестовый.

https://tradealmanac.com/mcp

claude mcp add --transport http tradealmanac https://tradealmanac.com/mcp \
  --header "Authorization: Bearer afk_…"

Описания инструментов по адресу тоже английские по умолчанию; русские включает параметр в самом адресе: добавьте к нему ?lang=ru.

Не хотите настраивать вручную? Страница «Подключить к ИИ-ассистенту» — кнопка для Claude, ChatGPT, Cursor и других клиентов.

Хотите использовать сервер вместе с брокерским? Страница «Рецепты» — как подключить оба и три готовых запроса.

Инструментам, которым нужен ключ, подходит либо ключ, либо вход через согласие в приложении. Клиент, который поддерживает вход (Claude, ChatGPT), сам откроет страницу согласия на сайте; тогда ключ в настройках клиента не нужен. Выданный доступ виден и отзывается в кабинете → «Подключённые агенты».

Сервер может предлагать личные инструменты — списки наблюдения и оповещения. Им нужны отдельные разрешения, «Списки наблюдения» и «Оповещения»: вы видите и отмечаете их на странице согласия; если сервер их не предлагает, таких разрешений на странице нет. Того, что вы не разрешили, агент не тронет, а один ключ личных данных не открывает.

По отдельному разрешению «Учебный портфель» сервер может дать агенту читать ваш учебный счёт и подавать на нём учебные заявки; деньги ненастоящие, настоящая заявка не отправляется ни брокеру, ни на биржу.

Язык сервера

Названия и описания инструментов, инструкции сервера и сообщения об ошибках по умолчанию английские. Чтобы получать их по-русски, добавьте в окружение сервера переменную TRADEALMANAC_MCP_LANG со значением ru. Имена инструментов, имена аргументов и поля ответа от языка не зависят.

"env": {
  "TRADEALMANAC_API_KEY": "afk_…",
  "TRADEALMANAC_MCP_LANG": "ru"
}

Ключ

Ключ выдаётся бесплатно в кабинете, раздел «API». Для первой пробы есть тестовый: квота на нём не расходуется, а ответ — снимок на сутки, поэтому свежие числа он не покажет.

TRADEALMANAC_API_KEY=afk_sandbox_tradealmanac_demo tradealmanac-mcp --check

Четыре сценария

• Собери отбор — «Найди бумаги нефтегазового сектора с дивидендной доходностью выше 8 % и P/E ниже 6, покажи таблицей». Агент сам возьмёт коды отраслей, сверится с единицами показателей и вызовет отбор.
• Сравни дивиденды — «Сравни дивидендную историю Сбербанка и Лукойла за пять лет и скажи, у кого выплаты регулярнее». Ответ придёт со статусами объявления: прогноз агент обязан назвать прогнозом.
• Выгрузи календарь — «Выгрузи ближайшие отсечки до конца года в таблицу CSV». Календарь берётся постранично по курсору, а сохранение файла делает уже сам редактор.
• Спроси про настроение и сезонность — «Какое сейчас настроение на рынках России и США и как индекс Мосбиржи обычно ведёт себя в январе?» Индикаторы читаются одним общим инструментом по идентификатору, а календарный эффект приходит с числом наблюдений и значимостью — статистику прошлого агент не должен выдавать за прогноз.

Чего агент здесь не получит

Котировок, свечей и справочника Московской биржи в договоре нет — ни в реальном времени, ни с задержкой, ни из хранилища; данных мировых рынков тоже нет. Инструмента «цена акции» в сервере не появится, и это не пробел, а лицензионная граница. Сервер говорит об этом модели прямо, при первом же соединении: агент, которому нечем ответить, обязан сказать об этом, а не подставить число со стороны и подписать его нашим именем.

Потолки

Квота у сервера ваша собственная — та же, что у ключа: 60 обращений в минуту и 1 000 в сутки на бесплатном ключе. При исчерпании приходит отказ 429 с числом секунд до следующей попытки, и сервер не повторяет запрос сам: повтор в упёршуюся квоту превращает потолок в шторм. Ответ инструмента ограничен по объёму; если выборка длиннее, в ней появляется отметка о том, сколько записей скрыто — часть выборки никогда не выдаётся за всю.

Вопросы о доступе и просьбы о повышенных лимитах — через контакты.