Документы

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

Сервер MCP отдаёт данные площадки прямо в Claude, Cursor и другие агентные среды — тем же ключом и с той же квотой, что и обычный доступ к интерфейсу.

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

Установка

Python — пакет tradealmanac-mcp

pip install tradealmanac-mcp

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

Node — тот же сервер, без установки

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

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

Claude Desktop

claude_desktop_config.json

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

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

Cursor

.cursor/mcp.json в проекте или ~/.cursor/mcp.json

{
  "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

Ключ

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

Проба тестовым ключом

TRADEALMANAC_API_KEY=afk_sandbox_tradealmanac_demo tradealmanac-mcp --check

Три сценария

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

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

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

Потолки

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

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