Подключение своих данных по MCP

Что нужно

• Аккаунт Finclarum с тарифом Pro.
• Отдельный персональный API-ключ с доступом «Только просмотр» — создаётся в профиле, в разделе «API-ключи».
• MCP-клиент с транспортом Streamable HTTP и поддержкой пользовательского заголовка Authorization.

Параметры сервера

• Адрес: https://finclarum.ru/mcp
• Транспорт: Streamable HTTP, только POST с JSON-RPC 2.0.
• Авторизация: Authorization: Bearer <ваш ключ>. Вход через OAuth не поддерживается.
• Лимит: 60 запросов в минуту на ключ и 120 — на аккаунт; при превышении — ответ 429 с Retry-After.

Настройка клиента

Claude Code:

claude mcp add --transport http finclarum https://finclarum.ru/mcp --header "Authorization: Bearer ВАШ_КЛЮЧ"

Клиенты с JSON-конфигурацией серверов (например, Cursor):

{
  "mcpServers": {
    "finclarum": {
      "url": "https://finclarum.ru/mcp",
      "headers": { "Authorization": "Bearer ВАШ_КЛЮЧ" }
    }
  }
}

Храните ключ только в настройках выбранного приложения и не публикуйте конфигурацию с ним.

Инструменты

Все инструменты только читают данные владельца ключа. Неполные данные и недоступные курсы помечаются явно.

get_budgets

Личные бюджеты и фактические расходы выбранного месяца. Лимиты — текущие сохранённые настройки, без реконструкции истории лимитов. До 100 категорий; category_id используется в фильтре get_expenses.

get_cash_flow_projection

Прогноз личного денежного потока до 90 дней в RUB по текущим планам. Старт — записанный нетто-поток текущего месяца, а не банковский остаток. Сценарные суммы округлены существующей моделью; неполные курсы и данные отмечены отдельно.

get_dividend_calendar

Объявленные денежные дивиденды по текущим положительным позициям в акциях. Окно 1–12 месяцев по датам отсечки UTC; дата выплаты отдельно, при отсутствии — нет данных. Сумма оценочная по текущему количеству, в исходной валюте без расчёта налога. Только сохранённые подтверждённые объявления; полнота и свежесть данных явные. Без купонов, оценочных дивидендов, счетов и внешних запросов.

get_expense_summary

Полный итог личных расходов за диапазон дат до 366 дней, включая квартал, по фильтрам анализа. category — личная категория из get_budgets. Только успешные исходящие расходы, без переводов и возвратов. Итог в рублях по историческим курсам. total_exact отсутствует при неполных данных: valued_subtotal_exact — только известная часть, missing_fx — суммы без курса. Не складывай последние строки get_expenses для итога периода.

get_expenses

До 100 последних личных расходов месяца по фильтрам анализа. Суммы в исходной валюте; category — category_id из get_budgets. Без реквизитов и банковских описаний. has_more означает, что показана только верхняя часть списка.

get_financial_health

Существующая оценка финансового здоровья: концентрация портфеля, долги к активам, резерв и денежный поток. Неизвестные компоненты имеют null; модель использует сохранённые данные и текущие курсы.

get_goals

До 100 личных целей: сумма, прогресс и срок. Семейные цели и история взносов не включаются.

get_liabilities

До 100 последних личных долгов: текущий остаток в исходной валюте, ставка, минимальный платёж и день оплаты. Без заметок и реквизитов. has_more означает неполный список.

get_month_summary

Фактические доходы и расходы личного месяца в рублях; переводы исключены. Суммы без курса отдельно. Денежные minor units — строки.

get_portfolio_summary

Сводка сохранённых личных ненулевых позиций, включая короткие, до 500 исходных позиций. Стоимости суммируются со знаком, по валютам отдельно; сохраняются свежесть, покрытие и неполнота оценки. Без номеров счетов.

get_positions

До 100 последних сохранённых личных ненулевых позиций, включая короткие. Количество и стоимость сохраняют знак; оценка в исходной валюте, свежесть позиции и котировки, полнота себестоимости и прибыли. Без идентификаторов и реквизитов счетов; has_more означает неполный список.

get_regular_payments

До 100 ближайших личных регулярных расходов, активных доходов и минимальных платежей долгов на срок до 90 дней. Суммы в исходных валютах. Это настроенное расписание, без подтверждения оплаты; день 29–31 переносится на последний день короткого месяца.

get_tax_summary

Годовой налоговый расчёт личных счетов в RUB по существующей модели, по умолчанию текущий год. Без сделок и реквизитов. Только доверенные курсы не старше 7 дней на дату факта; без курса зависимые итоги null. До 5000 фактов, 100 продаж с FIFO и 100000 шагов FIFO; превышение лимита или 5 секунд чтения возвращает ошибку.

Приватность и отзыв доступа

Данные, которые ассистент запросит через MCP, передаются в выбранное AI-приложение и обрабатываются по его правилам. Реквизиты счетов и банковские описания операций в ответы не входят.

Ключ действует до года. Отозвать его можно в любой момент в профиле, в разделе «API-ключи»; после отзыва сервер сразу отвечает 401.