TemplateFox
resmiHasilkan dokumen PDF dengan TemplateFox
Apa yang bisa Anda lakukan dengan TemplateFox MCP?
- Buat PDF dari templat — Minta untuk membuat PDF seperti faktur atau sertifikat dengan data dinamis, dikenakan biaya 1 kredit per dokumen.
- Antrekan pekerjaan PDF latar belakang — Minta pembuatan PDF dalam jumlah besar atau besar secara asinkron, opsional dengan panggilan balik webhook.
- Temukan templat dan bidangnya — Gunakan
list_templatesuntuk melihat PDF yang tersedia dan mempelajari data apa yang diharapkan oleh templat tertentu. - Lacak status pekerjaan PDF — Periksa kemajuan pembuatan asinkron dengan atau tinjau semua pekerjaan terbaru.
- Pantau kredit akun — Tanyakan tentang sisa kredit dengan atau tinjau riwayat penggunaan.
Dokumentasi
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 membuat PDF, mengelola template, dan memeriksa kredit — semuanya dari bahasa alami.
Prasyarat
- Node.js 18+ terinstal di mesin Anda (untuk
npx) - Kunci API TemplateFox — dapatkan dari Dashboard Anda (diawali 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, bukan npx.
Verifikasi pengaturan
Setelah instalasi, tanyakan kepada asisten AI Anda:
"Daftarkan 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 (diawali dengan sk_). Dapatkan dari Dashboard Anda |
TEMPLATEFOX_BASE_URL | Tidak | Ganti 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
Buat PDF dari template dengan data dinamis. Menghabiskan 1 kredit per PDF.
Apa yang dapat Anda tanyakan:
"Buatkan faktur untuk John Doe, total $250, menggunakan template Invoice saya"
"Buatkan 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.
Apa yang dapat Anda tanyakan:
"Buatkan 10 sertifikat di latar belakang dan beri tahu saya saat selesai"
list_templates
Temukan semua template PDF yang tersedia di akun Anda.
Apa yang dapat Anda tanyakan:
"Template apa saja yang saya miliki?"
"Tampilkan semua template PDF saya"
get_template_fields
Dapatkan kolom dan variabel untuk template tertentu. Berguna untuk memahami data apa yang diharapkan template sebelum membuat.
Apa yang dapat Anda tanyakan:
"Kolom apa saja yang dibutuhkan template Invoice saya?"
get_pdf_job_status
Periksa status pekerjaan pembuatan PDF asinkron.
Apa yang dapat Anda tanyakan:
"Apakah pekerjaan PDF saya sudah selesai?"
list_pdf_jobs
Daftarkan semua pekerjaan pembuatan PDF asinkron beserta statusnya.
Apa yang dapat Anda tanyakan:
"Tampilkan pekerjaan PDF terbaru saya"
get_account_info
Periksa sisa kredit dan informasi akun.
Apa yang dapat Anda tanyakan:
"Berapa sisa kredit saya?"
list_transactions
Lihat riwayat transaksi kredit.
Apa yang dapat Anda tanyakan:
"Tampilkan penggunaan kredit saya bulan ini"
Kasus penggunaan
Buat satu dokumen
Minta asisten AI Anda untuk membuat satu PDF dengan data tertentu. Asisten menemukan template, memeriksa kolom yang diperlukan, dan membuat PDF dalam satu alur:
"Buatkan slip pengiriman 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:
"Daftarkan template saya, lalu tampilkan kolom untuk template Receipt"
Periksa status akun
Pantau penggunaan Anda tanpa meninggalkan asisten AI Anda:
"Berapa sisa kredit saya? Tampilkan transaksi terbaru saya"
Server jarak jauh (segera)
Endpoint HTTP MCP 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
npxberfungsi: jalankannpx -y @templatefox/mcp-server --help - Mulai ulang asisten AI Anda setelah memperbarui konfigurasi
"Kunci API tidak valid" atau kesalahan autentikasi
- Pastikan kunci API Anda diawali dengan
sk_dan belum kedaluwarsa - Periksa kunci di Dashboard Anda
- Pastikan
TEMPLATEFOX_API_KEYdiatur di lingkungan yang benar (bukan hanya di shell Anda, tetapi di konfigurasi server MCP)
Alat tidak muncul
- Beberapa klien menyimpan cache daftar alat MCP — mulai ulang klien
- Periksa apakah server MCP lain berfungsi untuk menyingkirkan masalah di tingkat klien
Langkah berikutnya
- Mulai dalam 5 Menit — Buat template pertama Anda
- Data Binding — Pelajari cara meneruskan data dinamis
- Referensi API — Dokumentasi endpoint lengkap