Подключить локальный клиент MARFOR (server.py) к Claude Code и Claude Desktop

Что нужно заранее

• Аккаунт MARFOR и Claude Code или Claude Desktop. Подойдут и Cursor, VS Code, Codex CLI.
• Python 3.8 или новее. На Mac он обычно уже есть.

Проще всего: Claude подключит сам

1. Откройте страницу Подключение Claude и в блоке «Способ 1. Пусть Claude подключит сам» нажмите «Скопировать».
2. Вставьте текст в Claude Code — в терминале, редакторе кода или на вкладке Code приложения Claude. Обычный чат команд не выполняет.
3. Claude скачает server.py, сверит его контрольную сумму с сайтом и будет показывать каждую команду, прежде чем выполнить.
4. Claude покажет ссылку и код. На странице «Подключить Claude к вашему MARFOR?» сверьте код и нажмите «Разрешить».
5. Перезапустите Claude и напишите: Call marfor_whoami, then marfor_guide. Answer in Russian.

Вручную: macOS и Linux

1. Скачайте сервер: mkdir -p ~/.marfor_mcp && curl -fsSL https://marfor.pro/mcp/server.py -o ~/.marfor_mcp/server.py
2. Войдите: python3 ~/.marfor_mcp/server.py --login — откроется браузер, сверьте код и нажмите «Разрешить». Терминал подождёт.
3. Подключите к Claude Code: claude mcp add marfor --scope user -- python3 ~/.marfor_mcp/server.py. Флаг --scope user делает MARFOR доступным из любой папки.
4. Перезапустите Claude Code и выполните claude mcp list: в списке должна быть строка marfor со статусом Connected.

Команды для Windows, блок настроек для Claude Desktop и других программ — на вкладках страницы Подключение Claude. Для Claude Desktop готовый блок печатает команда python3 ~/.marfor_mcp/server.py --print-config claude-desktop.

Как понять, что получилось

• claude mcp list показывает marfor со статусом Connected.
• На просьбу «проверь вход в MARFOR» Claude назовёт адрес MARFOR, ваш email и проекты.
• В личном кабинете, раздел «Подключение Claude (MCP)» → «Ваши токены», появился токен со способом «через Claude». На почту придёт письмо «MARFOR: создан токен доступа для Claude (MCP)».

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

1. В личном кабинете, раздел «Подключение Claude (MCP)», нажмите «Создать токен»: название и срок — 30, 90 или 365 дней.
2. Токен покажется один раз — скопируйте его.
3. Вместо команды входа выполните в своём терминале python3 ~/.marfor_mcp/server.py --set-token и вставьте токен. Ввод скрыт — так и должно быть.

Токен в чат с Claude не вставляйте. Попал в чат — отзовите его и создайте новый.

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

• Python не найден — поставьте Python 3.8 или новее с python.org.
• Claude не видит MARFOR — claude mcp remove marfor, добавьте снова с --scope user и перезапустите Claude.
• «Код больше не действует» — код живёт 10 минут и срабатывает один раз; начните вход заново.
• Остальное — Claude не видит MARFOR.