MoneySellers в Claude Code — пошаговый гайд

Эта инструкция для тех, у кого уже установлен Claude Code

После настройки вы сможете обычным языком спрашивать у Claude данные из своего финплана Money Sellers: выручку, расходы, продажи, ОПиУ, ДДС, себестоимость, рекламу, динамику по дням, разрезы по товарам/каналам/брендам — и получать ответы в виде таблиц или Excel-файлов.


Что такое MCP?

MCP — это «коннектор», через который Claude Code напрямую читает ваш финплан в MoneySellers. Вы спрашиваете обычными словами («Какая выручка за май?»), Claude сам обращается к нужным методам сервиса и возвращает ответ. Ничего экспортировать вручную не надо.


Шаг 1. Создайте API-ключ в MoneySellers

1. Откройте Финансовая модель → вкладка «Интеграции» → «Добавить интеграцию».

2. Введите любое название интеграции, например API для AI.

3. В блоке «Способ создания» выберите «Выбор партнёра», в поле «Партнёр» укажите Api.

5. Выберите дату, с которой система будет передавать данные.

6. В блоке Доступные IP-адреса введите свой IP-адрес и нажмите «Подключить».

Узнать свой IP-адрес можно на сайте https://2ip.ru

❗️Обратите внимание, что с включенным VPN IP адрес отличается от того, что без VPN. Cloude Code работает только с VPN



4. В списке интеграций появится строка Api | API для AI. Нажмите иконку «Копировать apikey» и сохраните ключ.

Ключ привязан к вашему финплану — каждый пользователь работает только со своими данными. Никому не передавайте его.


Шаг 2. Попросите Claude подключить коннектор

Откройте Claude Code (раздел Code в приложении Claude), в строке сообщений вставьте готовый текст ниже и замените <ВАШ_КЛЮЧ> на ключ из Шага 1:

Подключи MCP MoneySellers к моему Claude Code.

Адрес сервера: https://mcp.api.report.finance/mcp
Авторизация: Authorization: Bearer <ВАШ_КЛЮЧ>
Имя сервера в конфиге: finansist
Уровень: user (--scope user)

После подключения проверь командой `claude mcp list`, что появилась строка `finansist: ✓ Connected`, и подтверди, что всё работает — пришли подтверждение и список доступных инструментов. Затем сразу сделай тестовый запрос: «выручка за прошлый месяц одной цифрой».

Через 10–30 секунд Claude напишет, что подключение готово, покажет статус ✓ Connected и сразу проверит работу тестовым запросом. Если Claude вернул сумму выручки — всё работает, можно пользоваться.

Если что-то пойдёт не так, Claude напишет, в чём дело (например, «ключ не подходит» — значит, проверьте, что скопировали полностью).


Альтернатива для опытных — терминал

Если предпочитаете сделать сами через консоль:

claude mcp add --scope user --transport http finansist \
https://mcp.api.report.finance/mcp \
--header "Authorization: Bearer <ВАШ_КЛЮЧ>"
claude mcp list

Должно показать finansist: ... - ✓ Connected.

Альтернатива — через файл настроек (если не работают ни чат, ни терминал)

Откройте файл ~/.claude.json в текстовом редакторе и добавьте сервер внутрь блока "mcpServers":

"finansist": {
"type": "http",
"url": "https://mcp.api.report.finance/mcp",
"headers": { "Authorization": "Bearer <ВАШ_КЛЮЧ>" }
}

Сохраните, перезапустите Claude Code. Проверьте подключение командой /mcp внутри Claude Code.


Что доступно через MCP

Через Money Sellers MCP Claude видит весь ваш финплан — справочники, проводки, отчёты, аналитику. Раздел за разделом:

💰 Финансовая отчётность

ОПиУ (P&L) — выручка → СПП → прямые расходы → маржинальная прибыль → EBITDA → чистая прибыль. С детализацией по любой статье.

ДДС (Cashflow) — приходы и списания по счетам.

Баланс — состояние активов и обязательств на дату.

Любые срезы по периодам: день / неделя / месяц / квартал / год.

📦 Продажи и товары

Реестр продаж, выручка по дням / неделям / месяцам.

Номенклатура с полями: название, бренд, штрихкод, артикулы Wildberries / Ozon / Яндекс.Маркет (свои и поставщика), размер, цвет, страна, ссылка на фото.

Группы товаров, группы проектов.

Каналы продаж (WB / Ozon / ЯМ / ОПТ / Золотое Яблоко / Ламода и т.д.) — через теги.

🎯 Реклама и расходы маркетплейсов

Расходы на рекламу по дням, по каналам, по товарам, по брендам.

Логистика, комиссия, эквайринг, хранение — отдельными статьями.

Себестоимость (автоматически приходит из интеграций маркетплейсов).

🏢 Контрагенты, платежи, документы

Контрагенты (ИНН/КПП, полные реквизиты, договоры).

Платежи (входящие/исходящие, по счетам).

Заявки на оплату (включая статусы согласования).

Документы финплана (все проводки за период).

Счета на оплату (invoices).

📊 Аналитика и планирование

Сценарии плана (актуальный, прогнозный, и т.д.).

Произвольные показатели (например, продажи в штуках, NPS, конверсия).

Теги/группы аналитики (Канал продаж, ЦФО, и др. — то, что вы завели сами).

🔧 Создание и редактирование

Claude может записывать данные в финплан, если вы попросите — создавать/менять/удалять документы, платежи, заявки, контрагентов, товары, статьи. Действует осторожно: меняет только то, что вы прямо подтвердили.


Как задавать вопросы — примеры

Claude понимает обычный язык. Главное правило — чем чётче запрос, тем быстрее и точнее ответ.

1. Простые вопросы (один-два числа)

- Какая выручка за май 2026?

- Сколько мы потратили на рекламу в апреле?

- Кто в топ-5 наших контрагентов по обороту за год?

2. Таблицы и сравнения

- Сравни ОПиУ за апрель и май 2026. Покажи Δ ₽ и Δ %.

- Топ-20 SKU по выручке за май — с брендом, баркодом и артикулом поставщика WB.

- Дай выручку по каналам (WB, Ozon, ЯМ) за прошлую неделю, по дням.

3. Глубокий анализ

- Проанализируй ОПиУ за май: что выросло, что упало по сравнению с апрелем,
и какие 3 главные причины падения чистой прибыли.

- Найди SKU, у которых ROAS (выручка / реклама) меньше 1 за месяц — это убыточные.

- Покажи себестоимость по товарам за прошлую неделю в разрезе каналов продаж.

4. Выгрузки в Excel

- Выгрузи реестр всех документов за период с 01.05 по 09.05 в Excel.
Колонки: дата, контрагент, товар, бренд, баркод, статья, канал, сумма.

- Дай Excel с продажами по SKU за май: средний чек, выручка, маржа,
с разбивкой по WB / Ozon / ЯМ.

5. Точечные вопросы по конкретному товару / контрагенту

- Найди все документы по баркоду 4620219556547 за май.

- Сколько мы должны контрагенту с ИНН 7721546864 на 22.05?


Лайфхаки для быстрых ответов

Указывайте период в одном из понятных форматов

- за май 2026

- с 01.05.2026 по 09.05.2026

- за прошлую неделю (Claude сам вычислит)

- за вчера, за сегодня

Если нужны просто цифры — скажите это

- Дай ОПиУ за май: 5 строк (выручка, прямые расходы, маржа, EBITDA, ЧП) — без интерпретации.

Это в 3–4 раза быстрее, чем когда Claude пишет отчёт с разделами «причины», «рекомендации», «выводы».

Анализируйте итеративно, а не одним блоком

Вместо «дай мне всё про май» спрашивайте по шагам: 

1. «Свод ОПиУ май» → 30 секунд, увидели общую картину. 

2. «ЧП упала — раскрой что внутри прямых расходов» → ещё минута, точечно. 

3. «Что конкретно с маркетингом?» → 30 секунд, ещё глубже.

Каждый шаг короткий, вы сразу видите, куда копать.

Сохраняйте шаблоны частых запросов

Если каждый понедельник смотрите одно и то же — заведите себе текстовый файл с готовыми промптами, например:

«Свод за прошлую неделю: выручка по дням и каналам, расходы на рекламу, средний чек. Таблица + 3 буллета. Без рекомендаций.»

Тогда Claude отвечает в том же формате каждый раз — не угадывает, что вы хотите.


Что работает особенно хорошо

- Все цифры финплана: ОПиУ, ДДС, выручка, расходы, маржа, ЧП.

- Заказы, продажи, остатки на складе, расходы на продвижение — отдельными реестрами.

- Документы, платежи, заявки, контрагенты, счета.

- Товары со всеми характеристиками (бренд, баркод, артикулы поставщика WB / Ozon / ЯМ, размер, цвет).

- Каналы продаж через теги (WB / Ozon / ЯМ / ОПТ / Золотое Яблоко / Ламода).

- Себестоимость (приходит автоматически из интеграций маркетплейсов).

- Сценарии планирования и произвольные показатели.


Что делать, если…

Проблема

Решение

Claude mcp list показывает ✗ Failed to connect

Проверьте, что ключ скопирован полностью, без пробелов. Формат: Authorization: Bearer <ключ>.

Claude отвечает «не могу получить доступ к данным»

Перезапустите Claude Code, проверьте claude mcp list. Если нужно — пересоздайте сервер той же командой.

Запрос идёт очень долго / падает

Это бывает при выгрузках за большие периоды (месяц+). Сузьте период (неделя, день), или скажите «без полной выгрузки, дай только итоги».

Цифры не совпадают с интерфейсом MoneySellers

Чаще всего — период неполный (последние 1–2 дня не успели подтянуться от маркетплейсов). Уточните у Claude: «период полностью закрыт?».

Claude задаёт уточняющий вопрос про формулу или период

Это нормально — отвечайте обычным языком, Claude учтёт.

Хочется обсудить новые методы или сообщить о баге

Через вашего менеджера / разработчика MoneySellers.



Куда обратиться, если что-то не работает

При повторяющихся проблемах с подключением или данными — обращайтесь к команде Money Sellers с описанием: 

- что вы спросили у Claude (точная фраза), 

- какой ответ получили, 

- ваш apikey (последние 4 символа — не весь!) 

и время запроса.

Это поможет разработчикам быстро найти и починить проблему.




Работает на