TemplateFox
공식TemplateFox로 PDF 문서 생성하기
TemplateFox MCP(으)로 무엇을 할 수 있나요?
- 템플릿에서 PDF 생성 — 어시스턴트에게 송장이나 인증서처럼 동적 데이터가 포함된 템플릿으로 PDF를 만들어 달라고 요청하세요.
- 비동기 PDF 작업 대기열에 추가 — 대규모 작업이나 일괄 작업의 백그라운드 생성을 요청하고, 완료 시 선택적으로 웹훅 콜백을 받을 수 있습니다.
- 템플릿 및 필드 확인 — 사용 가능한 템플릿을 나열하고, 생성 전에 특정 템플릿에 필요한 필드를 확인하세요.
- PDF 작업 추적 — 비동기 작업의 상태를 확인하거나 최근 PDF 작업과 상태를 나열하세요.
- 크레딧 및 거래 내역 확인 — 남은 크레딧, 계정 정보 또는 크레딧 거래 내역을 확인하세요.
문서
MCP (Model Context Protocol)은 AI 어시스턴트가 외부 도구를 검색하고 사용할 수 있도록 하는 개방형 표준입니다. TemplateFox MCP 서버는 자연어로 PDF를 생성하고, 템플릿을 관리하고, 크레딧을 확인할 수 있는 8가지 도구를 AI 어시스턴트에 제공합니다.
사전 요구 사항
- 컴퓨터에 Node.js 18+ 설치 (
npx용) - 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
특정 템플릿의 필드와 변수를 확인합니다. PDF를 생성하기 전에 템플릿에 필요한 데이터를 파악하는 데 유용합니다.
요청 예시:
“내 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 어시스턴트를 벗어나지 않고 사용량을 확인하세요.
“크레딧이 얼마나 남았어? 최근 거래 내역도 보여 줘”
원격 서버 (출시 예정)
호스팅된 HTTP MCP 엔드포인트 https://api.templatefox.com/mcp이 곧 제공될 예정입니다. 이를 사용하면 로컬에 아무것도 설치하지 않고 MCP 클라이언트에서 URL만 지정해 연결할 수 있습니다.
문제 해결
“MCP server not found” 또는 연결 오류
- Node.js 18+가 설치되어 있는지 확인하세요.
node --version을 실행하세요. npx명령이 작동하는지 확인하세요.npx -y @templatefox/mcp-server --help를 실행하세요.- 구성을 업데이트한 후 AI 어시스턴트를 다시 시작하세요.
“Invalid API key” 또는 인증 오류
- API 키가
sk_으로 시작하고 만료되지 않았는지 확인하세요. - 대시보드에서 키를 확인하세요.
TEMPLATEFOX_API_KEY이 올바른 환경에 설정되어 있는지 확인하세요 (셸뿐 아니라 MCP 서버 구성에도 설정해야 합니다).
도구가 표시되지 않음
- 일부 클라이언트는 MCP 도구 목록을 캐시합니다. 클라이언트를 다시 시작하세요.
- 클라이언트 수준의 문제인지 확인하려면 다른 MCP 서버가 작동하는지 확인하세요.
다음 단계
- 5분 만에 시작하기 — 첫 번째 템플릿 만들기
- 데이터 바인딩 — 동적 데이터를 전달하는 방법 알아보기
- API 참조 — 전체 엔드포인트 문서