Re:port Flow MCP

Официальное отображаемое имя: Re:port Flow MCP. Идентификатор пакета и реализации: reportflow-mcp. Устаревшие поисковые псевдонимы: ReportFlow MCP Server и ReportFlow.

Обзор

MCP-сервер (Model Context Protocol), который превращает ваши шаблоны Re:port Flow в PDF-отчёты — счета, договоры, выписки, всё, что вы разработали, — прямо из Claude или любого другого MCP-совместимого ИИ-агента.

Related MCP server: PDF Tools AI MCP

Возможности

• Создавайте PDF по запросам на естественном языке, например: «создайте счёт для Acme Corp на сумму 300 долларов»

• Предоставляйте ваши макеты Re:port Flow и их параметрические схемы напрямую ИИ в виде MCP-ресурсов

• Массово создавайте много PDF и скачивайте их одним ZIP-архивом

• Сохраняйте результаты в ту папку рабочего пространства, в которой сейчас находится пользователь (поддерживаются Claude Desktop / Claude Code / Cursor / VS Code)

Настройка

Re:port Flow MCP работает двумя способами — выберите тот, который подходит вашему клиенту.

Удалённый сервер (claude.ai / веб-клиенты) — Streamable HTTP

Добавьте Re:port Flow в качестве пользовательского коннектора, указывающего на размещённую конечную точку:

https://mcp.re-port-flow.com/mcp

В Claude (claude.ai) перейдите в Настройки → Коннекторы → Добавить пользовательский коннектор и вставьте указанный выше URL. Аутентификация выполняется в приложении через OAuth (см. Аутентификация) — ничего устанавливать локально не нужно.

Локальный сервер (Claude Desktop / Claude Code / Cursor) — stdio через npx

Добавьте следующее в ваш файл конфигурации (.mcp.json, claude_desktop_config.json, ~/.cursor/mcp.json и т. д.):

{
  "mcpServers": {
    "reportflow": {
      "command": "npx",
      "args": ["-y", "reportflow-mcp"]
    }
  }
}

На этом вся настройка. Никаких переменных окружения, API-ключей и секретов, которыми нужно управлять.

VS Code (сборки с поддержкой MCP)

Тот же JSON в .vscode/mcp.json.

Требования

• Удалённый режим: MCP-клиент, поддерживающий пользовательские HTTP-коннекторы (например, claude.ai). Локальная установка не требуется.

• Локальный (stdio): Node.js 22+ (автоматически загружается через npx) и браузер, доступный при первом входе.

• Учётная запись Re:port Flow (в любом случае).

Поддерживаемые версии протокола

Оба транспорта (stdio / Streamable HTTP) обслуживают два поколения протокола MCP из одной конечной точки:

• 2026-07-28 (текущая) — протокол без состояния на каждый запрос. Современные клиенты обнаруживают его через server/discover; без заголовка сессии, запросы передают версию протокола в _meta.

• Ревизии эпохи 2025 года (2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07) — классическое рукопожатие initialize, сохранённое для обратной совместимости с существующими клиентами (Claude Desktop, пользовательские коннекторы claude.ai, Cursor, ChatGPT, n8n, …).

Выбор версии автоматический на обоих транспортах: современные клиенты отправляют запрос server/discover, устаревшие продолжают использовать initialize — никакой настройки не требуется ни с той, ни с другой стороны, а существующие подключения продолжают работать без изменений.

Аутентификация

Удалённый режим (claude.ai)

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

Локальный режим (stdio)

После перезагрузки MCP-клиента попросите ИИ:

Авторизуйтесь в Re:port Flow

Откроется окно браузера. Вход → выбор рабочего пространства → согласие — и готово. Токены хранятся в системной связке ключей (macOS Keychain / Windows Credential Manager / Linux libsecret), с запасным вариантом в виде файла с правами chmod-0600, и обновляются автоматически.

Примеры использования

Каждый пример ниже — это запрос, который можно вставить как есть; ИИ сам выбирает нужные инструменты.

1. Создание одного PDF (список → схема → генерация)

Используя шаблон счёта, создайте PDF для Acme Corp на сумму 330 долларов.

ИИ перечисляет макеты с помощью list_templates, получает схему параметров с помощью get_design_parameters, заполняет значения и вызывает generate_pdf_sync.

• Удалённый режим: возвращает URL для скачивания (fileUrl).

• Локальный режим: также сохраняет файл и возвращает его абсолютный путь.

2. Пакетное создание нескольких PDF

На основе шаблона выписки создайте по одному PDF для каждого клиента (Acme 100 долларов, Globex 250 долларов, Initech 80 долларов) и отдайте их мне вместе.

• Локальный (stdio): generate_pdfs_sync записывает один ZIP-архив в ваше рабочее пространство.

• Удалённый режим: generate_pdfs_async запускает пакет и возвращает идентификатор запроса и URL для скачивания.

3. Асинхронное создание с последующей загрузкой (локальный режим)

Запустите создание PDF договора в фоновом режиме, а затем скачайте его, когда он будет готов.

ИИ вызывает generate_pdf_async (сразу возвращает requestId), затем download_file для сохранения готового PDF. Пакетный аналог: generate_pdfs_async → download_zip. Эти инструменты загрузки доступны только через stdio; на удалённом сервере синхронные/асинхронные инструменты уже возвращают fileUrl.

Совет — параметры на естественном языке: в клиенте с поддержкой Sampling вы можете попросить «составьте params для счёта на 1000 долларов для A社», и ИИ вызовет suggest_params, чтобы превратить бриф в корректный объект params перед генерацией.

4. Начало без шаблонов (галерея → копирование → генерация)

У меня пока нет шаблонов — создайте PDF счёта для Acme Corp.

Когда list_templates пуст, ИИ ищет в публичной галерее шаблонов с помощью search_gallery_templates, показывает вам кандидатов, копирует выбранный вами шаблон в ваше рабочее пространство с помощью copy_gallery_template, а затем продолжает обычным потоком (get_design_parameters → generate_pdf_sync). Копия всегда попадает в рабочее пространство, выбранное вами на экране согласия OAuth — ИИ не может нацелиться на другое рабочее пространство.

Слэш-команды

Где сохраняются файлы (локальный режим)

Расположение выходных файлов определяется в следующем порядке:

1. Явная инструкция от пользователя (например, «сохранить на мой рабочий стол»)

2. Корень текущего открытого рабочего пространства (Claude Code / Cursor / VS Code)

3. Системная временная папка как запасной вариант

Справочник

Инструменты (вызываемые ИИ)

Ресурсы (прикрепляемые как контекст ИИ)

Промпты (карточки рецептов слэш-команд)

/generate_pdf, /generate_pdfs, /reportflow_help — передайте аргументы, и ИИ следует подготовленному рабочему процессу.

Устранение неполадок

Конфиденциальность

Re:port Flow MCP — это тонкий клиент: он пересылает ваши запросы в ваш собственный аккаунт Re:port Flow и возвращает сгенерированные PDF. Он не продаёт и не передаёт ваши данные третьим лицам. Токены аутентификации хранятся локально (в связке ключей ОС или в запасном файле с правами chmod-0600) и отправляются только в собственные сервисы Re:port Flow — при входе через OAuth и как учётные данные Bearer в каждом аутентифицированном API-вызове (список шаблонов, генерация или загрузка PDF). Они никогда не передаются третьим лицам.

Для полной политики конфиденциальности — что собирается, как долго хранится и как обрабатывается — см.: lp.re-port-flow.com

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

Размещённая конечная точка проверяет заголовок Host (защита от DNS-ребендинга) и отклоняет структурно недопустимые заголовки Origin с ответом 403 Forbidden, согласно требованиям безопасности спецификации MCP Streamable HTTP. Аутентификация — только Bearer-токеном: без cookie, и CORS никогда не разрешает учётные данные. Полная политика и её модель угроз описаны в docs/security.md (на японском языке).

Поддержка

Нужна помощь, нашли ошибку или есть вопрос по проверке каталога?

• Re:port Flow (конфиденциальность и поддержка): https://lp.re-port-flow.com

• GitHub Issues: https://github.com/re-port-flow/reportflow-mcp/issues

Лицензия

MIT — см. LICENSE.

Ссылки

• Re:port Flow: https://re-port-flow.com

• Конфиденциальность и поддержка: https://lp.re-port-flow.com

• npm: https://www.npmjs.com/package/reportflow-mcp

• Проблемы: https://github.com/re-port-flow/reportflow-mcp/issues