TemplateFox MCP Server

TemplateFox PDF 생성 API용 MCP(Model Context Protocol) 서버입니다. Claude, Cursor, Windsurf와 같은 AI 어시스턴트를 통해 템플릿에서 PDF를 직접 생성할 수 있습니다.

설치

Claude Desktop

Claude Desktop 설정(macOS의 ~/Library/Application Support/Claude/claude_desktop_config.json`)에 추가하세요:

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

Claude Code

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

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

Cursor / Windsurf

MCP 서버 구성에 동일한 npx -y @templatefox/mcp-server 명령을 사용하고, 환경에 TEMPLATEFOX_API_KEY를 설정하세요.

전역 설치(대안)

npm install -g @templatefox/mcp-server

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

Related MCP server: @docujson/mcp

구성

사용 가능한 도구

원격 서버(HTTP)

MCP 서버는 원격 및 클라우드 배포에 적합한 Streamable HTTP를 통한 HTTP 전송도 지원합니다.

URL로 연결

https://mcp-server-599407781746.us-central1.run.app/mcp

MCP 클라이언트는 HTTP 헤더를 통해 API 키를 전달해야 합니다:

Authorization: Bearer sk_your_api_key_here

또는:

x-api-key: sk_your_api_key_here

자체 호스팅

PORT 환경 변수를 설정하여 HTTP 모드로 서버를 실행하세요:

PORT=8080 TEMPLATEFOX_API_KEY=sk_your_key node dist/index.js

또는 Docker 사용:

docker build -t templatefox-mcp .
docker run -p 8080:8080 templatefox-mcp

MCP 엔드포인트는 http://localhost:8080/mcp에서, 상태 확인은 http://localhost:8080/health에서 사용할 수 있습니다.

사용 예시

구성이 완료되면 AI 어시스턴트에게 다음과 같이 요청할 수 있습니다:

"내 PDF 템플릿을 나열하고, 고객 이름 'John Doe'와 금액 150.00으로 Invoice Template을 사용해 인보이스를 생성해줘"

어시스턴트는 다음을 수행합니다:

1. list_templates를 호출하여 사용 가능한 템플릿 찾기

2. get_template_fields를 호출하여 필수 필드 확인

3. 템플릿 ID와 데이터로 generate_pdf 호출

4. PDF 다운로드 URL 반환

링크

• TemplateFox 문서

• API 참조

• API 키 발급

• GitHub

라이선스

MIT