TemplateFox

MCP 서버

페이지 복사

MCP 서버

MCP(Model Context Protocol)는 AI 어시스턴트가 외부 도구를 발견하고 사용할 수 있게 해주는 개방형 표준입니다. TemplateFox MCP 서버는 AI 어시스턴트에게 PDF 생성, 템플릿 관리, 크레딧 확인을 위한 8가지 도구를 자연어로 제공합니다.

• npm: @templatefox/mcp-server
• GitHub: TemplateFoxPDF/mcp-server

사전 준비 사항

1. Node.js 18 이상이 머신에 설치되어 있어야 합니다 (npx 용)
2. TemplateFox API 키 — 대시보드에서 발급받으세요 (sk_ 로 시작)

설치

Claude Desktop

Claude Desktop 설정에 추가하세요 (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{ "mcpServers": { "templatefox": { "command": "npx", "args": ["-y", "@templatefox/mcp-server"], "env": { "TEMPLATEFOX_API_KEY": "sk_your_api_key_here" } } } }

파일을 저장한 후 Claude Desktop을 다시 시작하세요.

Claude Code

claude mcp add templatefox -- npx -y @templatefox/mcp-server

그런 다음 셸에서 TEMPLATEFOX_API_KEY 환경 변수를 설정하세요:

export TEMPLATEFOX_API_KEY="sk_your_api_key_here"

Cursor / Windsurf

MCP 서버 설정에서 동일한 npx 명령을 사용하세요:

npx -y @templatefox/mcp-server

환경 변수에 TEMPLATEFOX_API_KEY 를 설정하세요.

전역 설치 (대안)

npm install -g @templatefox/mcp-server

그런 다음 npx 대신 templatefox-mcp-server 를 명령으로 사용하세요.

설정 확인

설치 후 AI 어시스턴트에게 다음과 같이 요청하세요:

"내 TemplateFox 템플릿 목록을 보여줘"

MCP 서버가 올바르게 설정되었다면, 어시스턴트가 list_templates 을 호출하여 템플릿 목록을 반환할 것입니다. 오류가 발생하면 아래 문제 해결 섹션을 확인하세요.

설정

환경 변수	필수 여부	설명
TEMPLATEFOX_API_KEY	예	API 키 (sk_로 시작). 대시보드에서 발급받으세요
TEMPLATEFOX_BASE_URL	아니오	API 기본 URL 재정의 (기본값: https://api.templatefox.com)

사용 가능한 도구

MCP 서버는 AI 어시스턴트가 호출할 수 있는 8가지 도구를 제공합니다:

generate_pdf

동적 데이터로 템플릿에서 PDF를 생성합니다. PDF당 1 크레딧이 소모됩니다.

요청 예시:

"내 Invoice 템플릿을 사용해서 John Doe, 총액 $250인 인보이스를 생성해줘"

"Jane Smith, 과정: Advanced React인 수료증을 생성해줘"

generate_pdf_async

선택적 웹훅 콜백과 함께 비동기 PDF 생성을 큐에 넣습니다. 대량 또는 배치 작업에 유용합니다. PDF당 1 크레딧이 소모됩니다.

"백그라운드에서 수료증 10개를 생성하고 완료되면 알려줘"

list_templates

계정에서 사용 가능한 모든 PDF 템플릿을 확인합니다.

"어떤 템플릿이 있지?"

"내 모든 PDF 템플릿을 보여줘"

get_template_fields

특정 템플릿의 필드와 변수를 가져옵니다. 생성 전에 템플릿이 어떤 데이터를 필요로 하는지 이해하는 데 유용합니다.

"내 Invoice 템플릿에 어떤 필드가 필요해?"

get_pdf_job_status

비동기 PDF 생성 작업의 상태를 확인합니다.

"내 PDF 작업이 아직 끝났어?"

list_pdf_jobs

모든 비동기 PDF 생성 작업과 그 상태를 나열합니다.

"최근 PDF 작업들을 보여줘"

get_account_info

남은 크레딧과 계정 정보를 확인합니다.

"크레딧이 얼마나 남았어?"

list_transactions

크레딧 거래 내역을 확인합니다.

"이번 달 크레딧 사용량을 보여줘"

사용 사례

단일 문서 생성

AI 어시스턴트에게 특정 데이터로 PDF 하나를 생성하도록 요청하세요. 어시스턴트는 템플릿을 발견하고, 필요한 필드를 확인한 후, 한 번의 흐름으로 PDF를 생성합니다:

"주문 번호 #1234, 고객 John Doe, Widget Blue 3개, Gadget Pro 1개인 포장 명세서를 생성해줘"

생성 전 템플릿 탐색

먼저 템플릿에 대해 물어본 후, 사용 가능한 것을 파악한 다음 생성하세요:

"내 템플릿 목록을 보여주고, Receipt 템플릿의 필드를 알려줘"

계정 상태 확인

AI 어시스턴트를 떠나지 않고 사용량을 모니터링하세요:

"크레딧이 얼마나 남았어? 최근 거래 내역을 보여줘"

원격 서버 (곧 제공 예정)

https://api.templatefox.com/mcp 의 호스팅된 HTTP MCP 엔드포인트가 곧 제공될 예정입니다. 이를 통해 로컬에 아무것도 설치하지 않고 MCP 클라이언트를 URL로 지정하여 연결할 수 있습니다.

문제 해결

"MCP 서버를 찾을 수 없음" 또는 연결 오류

• Node.js 18 이상이 설치되어 있는지 확인하세요: node --version 실행
• npx 명령이 작동하는지 확인하세요: npx -y @templatefox/mcp-server --help 실행
• 설정을 업데이트한 후 AI 어시스턴트를 다시 시작하세요

"유효하지 않은 API 키" 또는 인증 오류

• API 키가 sk_ 로 시작하고 만료되지 않았는지 확인하세요
• 대시보드에서 키를 확인하세요
• TEMPLATEFOX_API_KEY 가 올바른 환경(셸뿐만 아니라 MCP 서버 설정)에 설정되어 있는지 확인하세요

도구가 표시되지 않음

• 일부 클라이언트는 MCP 도구 목록을 캐시합니다 — 클라이언트를 다시 시작하세요
• 다른 MCP 서버가 작동하는지 확인하여 클라이언트 수준의 문제인지 배제하세요

다음 단계

• 5분 만에 시작하기 — 첫 번째 템플릿 만들기
• 데이터 바인딩 — 동적 데이터 전달 방법 알아보기
• API 레퍼런스 — 전체 엔드포인트 문서

마지막 업데이트: 2026년 7월 12일

PDF 표준S3에 업로드