MARFOR
в вашем Claude

Подключите один раз и спрашивайте про сценарии, бюджеты и дашборды обычными словами. За цифрами Claude сходит в MARFOR сам.

Нужны аккаунт MARFOR и Claude Code или Claude Desktop.

Claude MARFOR подключён

Подними бюджет на контекст на 15 % в октябре. Сначала покажи, что изменится

MARFOR · пробный прогон
Изменятся 12 строк, бюджет октября вырастет на 1,2 млн ₽. Пока ничего не записано. Применить?

Сравни сценарии «База» и «Рост»: выручка и CRR по месяцам

Собери дашборд план/факт по каналам и дай ссылку

Примеры запросов. Цифры условные.

Способ 1. Пусть Claude подключит сам

Скопируйте этот текст и вставьте в Claude Code. Дальше Claude всё сделает сам и покажет каждую команду, прежде чем её выполнить.

Connect the MARFOR MCP server for me.
Fetch the raw instructions with this command (in Windows PowerShell use curl.exe):
curl -fsSL https://marfor.pro/mcp/install.md
Use curl rather than a web-page summary, so the commands stay exact.
Then follow the instructions step by step and show me each command before you run it.
Talk to me in Russian.
Connect the MARFOR MCP server for me.
Fetch the raw instructions with this command (in Windows PowerShell use curl.exe):
curl -fsSL https://marfor.pro/mcp/install.md
Use curl rather than a web-page summary, so the commands stay exact.
Then follow the instructions step by step and show me each command before you run it.

Что произойдёт

  1. Claude скачает сервер

    Один файл server.py в папку ~/.marfor_mcp. Затем сверит его контрольную сумму с сайтом.

  2. Попросит подтвердить вход

    Покажет ссылку и код. Откройте ссылку, сверьте код и нажмите «Разрешить». Пароль и токен в чат не попадают.

  3. Проверит связь и подключит

    Убедится, что MARFOR отвечает, и добавит его в настройки Claude.

  4. Вы перезапустите Claude

    Новые инструменты появляются после перезапуска. Первая фраза для проверки:

    Call marfor_whoami, then marfor_guide. Answer in Russian.
    Call marfor_whoami, then marfor_guide.

Куда вставлять: в Claude Code, будь то терминал, редактор кода или вкладка Code приложения Claude. Обычный чат команд не выполняет, для него есть способ 2.

Понадобится Python 3.8 или новее. На Mac он обычно уже есть; если нет — Claude подскажет, как поставить.

Инструкция открыта: посмотрите, что именно прочитает Claude.

Способ 2. Вручную

Три команды в терминале. Секретов в них нет: вход подтверждается в браузере.

  1. Скачайте сервер

    Один файл в вашей домашней папке. Ничего не устанавливается.

    Terminal
    mkdir -p ~/.marfor_mcp && curl -fsSL https://marfor.pro/mcp/server.py -o ~/.marfor_mcp/server.py
  2. Войдите

    Откроется браузер: сверьте код и нажмите «Разрешить». Терминал подождёт.

    Terminal
    python3 ~/.marfor_mcp/server.py --login
  3. Подключите к Claude Code

    Флаг --scope user нужен, чтобы MARFOR был доступен из любой папки.

    Terminal
    claude mcp add marfor --scope user -- python3 ~/.marfor_mcp/server.py
  4. Перезапустите Claude Code и проверьте

    В списке должна быть строка marfor со статусом Connected.

    Terminal
    claude mcp list

Команды — для PowerShell.

  1. Скачайте сервер

    Один файл в вашей домашней папке. Ничего не устанавливается.

    PowerShell
    New-Item -ItemType Directory -Force "$HOME/.marfor_mcp" | Out-Null; curl.exe -fsSL https://marfor.pro/mcp/server.py -o "$HOME/.marfor_mcp/server.py"
  2. Войдите

    Откроется браузер: сверьте код и нажмите «Разрешить». Терминал подождёт.

    PowerShell
    python "$HOME/.marfor_mcp/server.py" --login
  3. Подключите к Claude Code

    Эта команда напечатает готовую строку claude mcp add с полными путями для вашего компьютера. Выделите строку мышью, скопируйте, вставьте сюда же и нажмите Enter.

    PowerShell
    python "$HOME/.marfor_mcp/server.py" --print-config claude-code
  4. Перезапустите Claude Code и проверьте

    В списке должна быть строка marfor со статусом Connected.

    PowerShell
    claude mcp list

Если python открывает Microsoft Store, замените его на py -3 в командах 2 и 3.

Сначала выполните шаги 1 и 2 из вкладки Claude Code для вашей системы: скачать сервер и войти. Дальше так:

  1. Получите блок настроек

    Команда напечатает JSON с полными путями для вашего компьютера.

    macOS / Linux
    python3 ~/.marfor_mcp/server.py --print-config claude-desktop
    Windows PowerShell
    python "$HOME/.marfor_mcp/server.py" --print-config claude-desktop
  2. Вставьте его в конфиг Claude Desktop

    В приложении откройте Settings → Developer → Edit Config. Откроется файл claude_desktop_config.json. Если в нём уже есть mcpServers, добавьте внутрь только запись marfor, остальное не трогайте.

    • macOS ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows %APPDATA%\Claude\claude_desktop_config.json

    Так выглядит результат. Пути у вас будут свои: берите их из вывода команды.

    JSON · example
    {
      "mcpServers": {
        "marfor": {
          "command": "/usr/bin/python3",
          "args": ["/Users/you/.marfor_mcp/server.py"]
        }
      }
    }
  3. Полностью закройте и снова откройте Claude Desktop

    На Mac нажмите Cmd+Q, на Windows выберите «Quit» в меню значка в трее. Просто закрыть окно недостаточно.

MARFOR — обычный локальный MCP-сервер, поэтому работает в любом клиенте с поддержкой MCP. Сначала шаги 1 и 2 из вкладки Claude Code (скачать и войти), затем блок для вашего клиента.

Пути в JSON должны быть полными. Значения command и args для вашего компьютера напечатает команда из вкладки Claude Desktop (шаг 3): подставьте их вместо примера.

Cursor

Файл ~/.cursor/mcp.json

JSON
{
  "mcpServers": {
    "marfor": {
      "command": "python3",
      "args": ["/FULL/PATH/TO/.marfor_mcp/server.py"]
    }
  }
}

VS Code

Файл .vscode/mcp.json в папке проекта

JSON
{
  "servers": {
    "marfor": {
      "type": "stdio",
      "command": "python3",
      "args": ["/FULL/PATH/TO/.marfor_mcp/server.py"]
    }
  }
}

Codex CLI

Одна команда в терминале. На Windows всё, что стоит после --, возьмите из строки, которую печатает шаг 3 вкладки Claude Code · Windows.

Terminal
codex mcp add marfor -- python3 ~/.marfor_mcp/server.py

Если подтверждение в браузере недоступно

Войти можно и без него. Создайте токен в личном кабинете, в разделе «Подключение Claude (MCP)», и скопируйте его: он показывается один раз. Затем вместо шага 2 выполните эту команду в своём терминале. Сервер к этому моменту уже скачан (шаг 1).

macOS / Linux
python3 ~/.marfor_mcp/server.py --set-token
Windows PowerShell
python "$HOME/.marfor_mcp/server.py" --set-token

Команда спросит токен. Вставьте его и нажмите Enter. Ввод скрыт: на экране ничего не появится, так и должно быть. Дальше продолжайте с шага 3.

Токен — ключ от вашего MARFOR. Не вставляйте его в чат с Claude. Если он всё же попал в чат, отзовите его в личном кабинете и создайте новый.

Что умеет MARFOR в Claude

Обычными словами, прямо в чате.

Читает сценарии и прогнозы

Сравнить сценарии, разложить выручку по каналам, найти месяц, где план разошёлся с фактом. Без выгрузок в таблицы.

Меняет бюджеты в сценариях

Массовые правки по каналам и месяцам идут с пробным прогоном: сначала видно, что изменится, запись только после вашего «да». У одиночной правки прогона нет: Claude называет, что поменяет, и ждёт согласия.

Собирает BI‑дашборды

Опишите, что хотите видеть, и получите страницу с графиками. Пробного прогона здесь нет: прежде чем править или публиковать страницу, Claude спросит вас.

Загружать данные и создавать проекты пока можно только в веб-интерфейсе MARFOR.

Безопасность

Что получает Claude и как это отключить.

Доступ отзывается в один клик

В личном кабинете, в разделе про Claude, виден каждый выданный доступ. После отзыва он перестаёт работать сразу. Срок доступа ограничен: не больше года.

Пароль и токен не проходят через чат

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

Права ограничены

Claude читает то, что вы сами видите в MARFOR. Менять он может только значения в сценариях и BI‑страницы: собрать, поправить, опубликовать. Закрыты оплата, приглашения и совместный доступ, управление токенами, ключ ИИ и админка. Удалить проект или дашборд он тоже не сможет.

Один файл, который можно прочитать

Сервер состоит из одного файла на стандартной библиотеке Python, без сторонних пакетов. Откройте server.py и посмотрите сами.

Версия и контрольная сумма

Считаются от файла, который сайт отдаёт прямо сейчас. После скачивания сумма у вас должна совпасть:

Версия
0.4.0
SHA-256
f55170727c4a31a74d9660a9c56bdd8f409ac576591625f8ae21ca75792b419e
macOS / Linux
shasum -a 256 ~/.marfor_mcp/server.py
Windows PowerShell
(Get-FileHash "$HOME/.marfor_mcp/server.py" -Algorithm SHA256).Hash.ToLower()

То же в машинном виде: version.json.

Если не получилось

Частые причины и что с ними делать. Если подключал Claude, просто покажите ему текст ошибки.

Пишет, что Python не найден

Поставьте Python 3.8 или новее с python.org. На Windows при установке отметьте «Add python.exe to PATH». Потом продолжайте с того шага, где остановились.

На Windows команда python открывает Microsoft Store

Это заглушка Windows, а не Python. Пишите py -3 вместо python, например:

PowerShell
py -3 "$HOME/.marfor_mcp/server.py" --login
Ошибка 401 или «токен недействителен»

Доступ отозван или у него вышел срок. Войдите заново:

macOS / Linux
python3 ~/.marfor_mcp/server.py --login
Windows PowerShell
python "$HOME/.marfor_mcp/server.py" --login
Claude не видит MARFOR

Чаще всего сервер добавлен только для одной папки. Удалите запись и добавьте её снова с --scope user, затем перезапустите Claude. На Windows вторая команда напечатает строку для добавления — выполните её. В Claude Desktop — полностью закройте приложение и откройте снова.

macOS / Linux
claude mcp remove marfor
claude mcp add marfor --scope user -- python3 ~/.marfor_mcp/server.py
Windows PowerShell
claude mcp remove marfor
python "$HOME/.marfor_mcp/server.py" --print-config claude-code
CERTIFICATE_VERIFY_FAILED на Mac

Так бывает у Python, установленного с python.org: ему нужно один раз поставить сертификаты. Откройте папку «Программы» → Python 3.x и дважды щёлкните Install Certificates.command.

Страница подтверждения не открывается или пишет «временно недоступно»

Подождите пару минут и попробуйте снова. Если не помогло, войдите с токеном из личного кабинета: как это сделать.

Ничего не помогло

Запустите диагностику и пришлите её вывод на support@marfor.pro. Секретов в нём нет: токен она не печатает.

macOS / Linux
python3 ~/.marfor_mcp/server.py --check
Windows PowerShell
python "$HOME/.marfor_mcp/server.py" --check

Нет аккаунта MARFOR?

Начните бесплатно: загрузите данные, постройте прогноз и подключайте Claude.