TemplateFox

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

사전 요구 사항

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개당 1크레딧이 소모됩니다.

이렇게 요청할 수 있습니다:

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

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

generate_pdf_async

선택적 웹훅 콜백과 함께 비동기 PDF 생성을 대기열에 추가합니다. 대량 또는 일괄 작업에 유용합니다. PDF 1개당 1크레딧이 소모됩니다.

이렇게 요청할 수 있습니다:

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

list_templates

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

이렇게 요청할 수 있습니다:

"내가 가진 템플릿은 무엇이 있나요?"

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

get_template_fields

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

이렇게 요청할 수 있습니다:

"내 인보이스 템플릿에는 어떤 필드가 필요한가요?"

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 참조 — 전체 엔드포인트 문서