# Выгрузка данных MARFOR в файл для своего дашборда

> **Коротко.** Локальный клиент сохраняет данные датасета в CSV, JSON или JS на вашем компьютере и обновляет файл по расписанию. MARFOR при этом только читается.

Адрес: https://marfor.pro/docs/claude/use/exports · Раздел: Claude и MCP: MARFOR в вашем Claude › Работа с Claude: вопросы, правки, дашборды, выгрузки › Выгрузка данных MARFOR в файл для своего дашборда · Вид: Инструкция · Уровень: средний уровень · Обновлено: 2026-10-14

Выгрузка — это профиль на вашем компьютере: какой датасет, какие метрики и разрезы, за какой период. По профилю клиент забирает данные из MARFOR и пишет файл, а ваш дашборд — в Excel, Looker Studio, своём HTML — читает этот файл.

## Что нужно заранее {#before}

- [Локальный клиент](https://marfor.pro/docs/claude/connect/local-client), подключённый к Claude. В коннекторе по адресу выгрузок нет: файлу нужен ваш компьютер.
- Датасет в MARFOR: источник, прогноз, сценарий или План/Факт.

## Шаги {#steps}

1. **Опишите выгрузку:** «Сделай выгрузку выручки и расходов по каналам помесячно с начала года в CSV для моего дашборда, назови sales-ytd».
2. **Claude сверит имена** метрик и разрезов с датасетом. Неизвестное имя он не возьмёт — предложит похожие.
3. **Пробный запуск.** Claude сохранит профиль и сразу запишет файл. В ответе — путь, по умолчанию `~/.marfor_mcp/out/sales-ytd.csv`, и первые строки.
4. **Расписание.** Попросите: «обновляй каждый день». Claude напечатает готовую настройку планировщика вашей системы: для macOS, Linux или Windows. Сам он ничего не ставит — установка отдельным шагом, с вашего согласия.
5. **Подключите файл** к своему дашборду. Формат `js` — для HTML-страницы, которая открывается с диска.

## Период — относительный {#period}

Профиль хранит не даты, а правило: весь период, годы, с начала года, последние N месяцев, этот и следующий год, отдельные месяцы. При каждом запуске период пересчитывается на сегодня: выгрузка «с начала года» в марте даст январь–март, в октябре — январь–октябрь.

## Как понять, что получилось {#check}

- Файл появился по пути из ответа, в нём строки с годом, кварталом, месяцем, разрезами и метриками.
- Команда `python3 ~/.marfor_mcp/server.py --list-exports` показывает выгрузки этого компьютера и итог последнего запуска.
- Запустить выгрузку руками, как это делает планировщик: `python3 ~/.marfor_mcp/server.py --export sales-ytd`.

## Если дашборд ходит в MARFOR сам {#api}

Попросите у Claude «рецепт» выгрузки — `marfor_export_recipe`. Он напечатает запрос к MARFOR на curl, Python и JavaScript с тем же составом данных. Вместо токена в рецепте стоит переменная `$MARFOR_TOKEN`: токен вы кладёте в окружение своего сервиса сами, в чат его не вставляйте.

## Важно знать {#notes}

- **Отношения — от сумм.** ДРР, средний чек и другие вычисляемые поля выгрузка считает из сумм числителя и знаменателя. Если в своём дашборде вы складываете строки — пересчитайте отношение заново, а не складывайте проценты.
- **До 200 000 строк** в одном файле. Больше — сузьте период или разрезы.
- **Данные не уходят дальше вашего компьютера**: клиент читает MARFOR и пишет локальный файл.

## Связанные

- [Подключить локальный клиент MARFOR (server.py) к Claude Code и Claude Desktop](https://marfor.pro/docs/claude/connect/local-client)
- [Инструменты MARFOR в Claude](https://marfor.pro/docs/claude/use/tools)
- [Что Claude умеет в MARFOR и чего не умеет](https://marfor.pro/docs/claude/use/capabilities)
- [Безопасность: как Claude получает доступ и почему токен не идёт через чат](https://marfor.pro/docs/claude/access/security)