TemplateFox

MCP Server

Salin halaman

MCP Server

MCP (Model Context Protocol) adalah standar terbuka yang memungkinkan asisten AI menemukan dan menggunakan alat eksternal. Server MCP TemplateFox memberi asisten AI Anda 8 alat untuk menghasilkan PDF, mengelola template, dan memeriksa kredit — semuanya dari bahasa alami.

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

Prasyarat

1. Node.js 18+ terinstal di mesin Anda (untuk npx)
2. Kunci API TemplateFox — dapatkan dari Dasbor Anda (dimulai dengan sk_)

Instalasi

Claude Desktop

Tambahkan ke konfigurasi Claude Desktop Anda (~/Library/Application Support/Claude/claude_desktop_config.json di macOS, %APPDATA%\Claude\claude_desktop_config.json di Windows):

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

Mulai ulang Claude Desktop setelah menyimpan file.

Claude Code

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

Kemudian atur variabel lingkungan TEMPLATEFOX_API_KEY di shell Anda:

export TEMPLATEFOX_API_KEY="sk_your_api_key_here"

Cursor / Windsurf

Gunakan perintah npx yang sama di konfigurasi server MCP Anda:

npx -y @templatefox/mcp-server

Atur TEMPLATEFOX_API_KEY di variabel lingkungan.

Instalasi global (alternatif)

npm install -g @templatefox/mcp-server

Kemudian gunakan templatefox-mcp-server sebagai perintah alih-alih npx.

Verifikasi pengaturan

Setelah instalasi, tanyakan kepada asisten AI Anda:

“Tampilkan template TemplateFox saya”

Jika server MCP dikonfigurasi dengan benar, asisten akan memanggil list_templates dan mengembalikan daftar template Anda. Jika Anda melihat kesalahan, periksa bagian Pemecahan Masalah di bawah.

Konfigurasi

Variabel Lingkungan	Wajib	Deskripsi
TEMPLATEFOX_API_KEY	Ya	Kunci API Anda (dimulai dengan sk_). Dapatkan dari Dasbor Anda
TEMPLATEFOX_BASE_URL	Tidak	Timpa URL dasar API (default: https://api.templatefox.com)

Alat yang tersedia

Server MCP menyediakan 8 alat yang dapat dipanggil oleh asisten AI Anda:

generate_pdf

Menghasilkan PDF dari template dengan data dinamis. Menghabiskan 1 kredit per PDF.

Yang dapat Anda tanyakan:

“Buat faktur untuk John Doe, total $250, menggunakan template Faktur saya”

“Buat sertifikat penyelesaian untuk Jane Smith, kursus: Advanced React”

generate_pdf_async

Antrekan pembuatan PDF asinkron dengan callback webhook opsional. Berguna untuk pekerjaan besar atau batch. Menghabiskan 1 kredit per PDF.

“Buat 10 sertifikat di latar belakang dan beri tahu saya setelah selesai”

list_templates

Temukan semua template PDF yang tersedia di akun Anda.

“Template apa yang saya miliki?”

“Tampilkan semua template PDF saya”

get_template_fields

Dapatkan bidang dan variabel untuk template tertentu. Berguna untuk memahami data apa yang diharapkan template sebelum membuat.

“Bidang apa yang dibutuhkan template Faktur saya?“

get_pdf_job_status

Periksa status pekerjaan pembuatan PDF asinkron.

“Apakah pekerjaan PDF saya sudah selesai?“

list_pdf_jobs

Tampilkan semua pekerjaan pembuatan PDF asinkron dan statusnya.

“Tampilkan pekerjaan PDF terbaru saya”

get_account_info

Periksa sisa kredit dan informasi akun.

“Berapa sisa kredit saya?“

list_transactions

Lihat riwayat transaksi kredit.

“Tampilkan penggunaan kredit saya bulan ini”

Kasus penggunaan

Menghasilkan satu dokumen

Minta asisten AI Anda untuk menghasilkan satu PDF dengan data spesifik. Asisten menemukan template, memeriksa bidang yang diperlukan, dan menghasilkan PDF dalam satu alur:

“Buat slip pengepakan untuk pesanan #1234, pelanggan John Doe, 3x Widget Blue dan 1x Gadget Pro”

Jelajahi template sebelum membuat

Tanyakan tentang template Anda terlebih dahulu, lalu buat setelah Anda tahu apa yang tersedia:

“Tampilkan template saya, lalu tampilkan bidang untuk template Tanda Terima”

Periksa status akun

Pantau penggunaan Anda tanpa meninggalkan asisten AI Anda:

“Berapa sisa kredit saya? Tampilkan transaksi terbaru saya”

Server jarak jauh (segera)

Endpoint MCP HTTP yang dihosting di https://api.templatefox.com/mcp akan segera hadir. Ini memungkinkan Anda terhubung tanpa menginstal apa pun secara lokal — cukup arahkan klien MCP Anda ke URL tersebut.

Pemecahan Masalah

”Server MCP tidak ditemukan” atau kesalahan koneksi

• Pastikan Node.js 18+ terinstal: jalankan node --version
• Periksa apakah perintah npx berfungsi: jalankan npx -y @templatefox/mcp-server --help
• Mulai ulang asisten AI Anda setelah memperbarui konfigurasi

”Kunci API tidak valid” atau kesalahan autentikasi

• Verifikasi kunci API Anda dimulai dengan sk_ dan tidak kedaluwarsa
• Periksa kunci di Dasbor Anda
• Pastikan TEMPLATEFOX_API_KEY diatur di lingkungan yang benar (bukan hanya shell Anda, tetapi konfigurasi server MCP)

Alat tidak muncul

• Beberapa klien menyimpan cache daftar alat MCP — mulai ulang klien
• Periksa apakah server MCP lain berfungsi untuk mengesampingkan masalah tingkat klien

Langkah selanjutnya

• Mulai dalam 5 Menit — Buat template pertama Anda
• Pengikatan Data — Pelajari cara meneruskan data dinamis
• Referensi API — Dokumentasi endpoint lengkap

Terakhir diperbarui pada 12 Juli 2026

Standar PDFUnggah ke S3