Re:port Flow MCP

공식 표시 이름: Re:port Flow MCP. 패키지 및 구현 식별자: reportflow-mcp. 레거시 검색 별칭: ReportFlow MCP Server 및 ReportFlow.

개요

MCP(Model Context Protocol) 서버로, Re:port Flow 템플릿을 PDF 보고서로 변환합니다 — 인보이스, 계약서, 명세서, 직접 디자인한 모든 것 — Claude 또는 다른 MCP 호환 AI 에이전트에서 바로 사용할 수 있습니다.

Related MCP server: PDF Tools AI MCP

기능

• "Acme Corp에 총 $300 규모의 인보이스 작성" 같은 자연어 요청으로 PDF 생성

• Re:port Flow 디자인과 해당 파라미터 스키마를 MCP 리소스로 AI에 직접 노출

• 여러 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) — npx를 통한 stdio

다음을 구성 파일(.mcp.json, claude_desktop_config.json, ~/.cursor/mcp.json 등)에 추가하세요:

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

이것으로 설정이 끝납니다. 관리할 환경 변수나 API 키, 기밀 정보가 없습니다.

VS Code (MCP 지원 빌드)

.vscode/mcp.json에도 동일한 JSON을 넣으세요.

요구 사항

• 원격: 사용자 지정 HTTP 커넥터를 지원하는 MCP 클라이언트(예: claude.ai). 로컬 설치 불필요.

• 로컬(stdio): Node.js 22+(npx가 자동으로 가져옴) 및 첫 로그인 시 사용 가능한 브라우저.

• Re:port Flow 계정(어느 방식이든).

지원되는 프로토콜 개정판

두 전송 방식(stdio / Streamable HTTP) 모두 단일 엔드포인트에서 두 세대의 MCP 프로토콜을 제공합니다:

• 2026-07-28 (현재) — 무상태(stateless) 요청별 프로토콜. 최신 클라이언트는 server/discover를 통해 이를 발견합니다. 세션 헤더가 없으며, 요청은 _meta에 프로토콜 버전을 담습니다.

• 2025년대 개정판 (2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07) — 기존 클라이언트(Claude Desktop, claude.ai 사용자 지정 커넥터, Cursor, ChatGPT, n8n 등)와의 하위 호환성을 위해 유지되는 클래식 initialize 핸드셰이크.

버전 선택은 두 전송 방식 모두에서 자동으로 이루어집니다. 최신 클라이언트는 server/discover로 프로브하고, 레거시 클라이언트는 계속 initialize를 보냅니다. 양쪽 모두 구성이 필요 없으며, 기존 연결은 변경 없이 계속 작동합니다.

인증

원격 (claude.ai)

커넥터를 추가하면 Claude가 OAuth 흐름을 대신 실행합니다: 로그인 → 작업공간 선택 → 동의. 토큰은 클라이언트가 보관하므로 로컬 키체인이나 브라우저 단계를 관리할 필요가 없습니다.

로컬 (stdio)

MCP 클라이언트를 다시 로드한 후 AI에게 요청하세요:

Re:port Flow에 인증

브라우저 창이 열립니다. 로그인 → 작업공간 선택 → 동의하면 끝입니다. 토큰은 OS 키체인(macOS 키체인 / Windows 자격 증명 관리자 / Linux libsecret)에 저장되며, chmod-0600 파일 대체 방식도 있고 자동으로 새로 고쳐집니다.

사용 예시

아래 각 예시는 그대로 붙여 넣을 수 있는 프롬프트입니다. AI가 적절한 도구를 선택합니다.

1. 단일 PDF 생성 (목록 → 스키마 → 생성)

인보이스 템플릿을 사용하여 Acme Corp에 총 $330인 PDF를 만들어 주세요.

AI는 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가 일괄 작업을 실행하고 요청 ID와 다운로드 URL을 반환합니다.

3. 비동기 생성 후 다운로드 (로컬)

계약서 PDF를 백그라운드에서 시작한 다음, 준비되면 다운로드하세요.

AI는 generate_pdf_async를 호출하고(즉시 requestId 반환), 완성된 PDF를 저장하기 위해 download_file을 호출합니다. 일괄 버전은 generate_pdfs_async → download_zip입니다. 이 다운로드 도구는 stdio 전용이며, 원격 서버에서는 동기/비동기 도구가 이미 fileUrl을 반환합니다.

팁 — 자연어 파라미터: Sampling을 지원하는 클라이언트에서 *"A社에 $1,000 인보이스에 대한 파라미터 초안을 작성해 줘"*라고 요청하면, AI가 suggest_params를 호출하여 브리프를 생성 전에 유효한 params 객체로 변환합니다.

4. 템플릿 없이 시작 (갤러리 → 복사 → 생성)

아직 템플릿이 없습니다 — Acme Corp용 인보이스 PDF를 만들어 주세요.

list_templates가 비어 있으면, AI는 search_gallery_templates로 공개 템플릿 갤러리를 검색하고, 후보를 보여 준 다음, copy_gallery_template으로 선택한 템플릿을 작업공간에 복사하고, 일반 흐름(get_design_parameters → generate_pdf_sync)을 진행합니다. 복사본은 항상 OAuth 동의 화면에서 선택한 작업공간에 저장되며, AI는 다른 작업공간을 대상으로 할 수 없습니다.

슬래시 명령

파일 저장 위치 (로컬 모드)

출력 위치는 다음 순서로 결정됩니다:

1. 사용자의 명시적 지시(예: "내 데스크톱에 저장")

2. 현재 열려 있는 작업공간 루트(Claude Code / Cursor / VS Code)

3. 폴백으로 OS 임시 디렉터리

참조

도구 (AI가 호출)

리소스(AI 컨텍스트로 첨부 가능)

프롬프트(슬래시 명령 레시피 카드)

/generate_pdf, /generate_pdfs, /reportflow_help — 인수를 전달하면 AI가 준비된 워크플로를 따릅니다.

문제 해결

개인정보 보호

Re:port Flow MCP는 씬 클라이언트입니다. 사용자의 요청을 사용자 자신의 Re:port Flow 계정으로 전달하고 생성된 PDF를 반환합니다. 제3자에게 데이터를 판매하거나 공유하지 않습니다. 인증 토큰은 로컬(OS 키체인 또는 chmod-0600 파일 폴백)에 저장되며, OAuth 로그인 중 및 각 인증된 API 호출(템플릿 나열, PDF 생성 또는 다운로드)에서 Bearer 자격 증명으로 Re:port Flow 자체 서비스에만 전송됩니다. 제3자와 절대 공유되지 않습니다.

전체 개인정보 보호정책 — 수집되는 항목, 보존 기간, 처리 방법 — 은 **lp.re-port-flow.com**에서 확인하세요.

보안

호스팅 엔드포인트는 MCP Streamable HTTP 사양의 보안 요구 사항에 따라 Host 헤더를 검증하고(DNS 리바인딩 보호), 구조적으로 유효하지 않은 Origin 헤더를 403 Forbidden으로 거부합니다. 인증은 Bearer 토큰 전용이며, 쿠키가 없고 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

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