TemplateFox
resmiHasilkan dokumen PDF dengan TemplateFox
Apa yang bisa Anda lakukan dengan TemplateFox MCP?
- Buat PDF dari templat — Minta asisten Anda membuat PDF dari templat dengan data dinamis, seperti faktur atau sertifikat.
- Antrekan tugas PDF asinkron — Minta pembuatan di latar belakang untuk tugas besar atau batch, dengan callback webhook opsional saat selesai.
- Periksa templat dan kolom — Lihat daftar templat yang tersedia dan cari tahu kolom yang diperlukan oleh templat tertentu sebelum membuat PDF.
- Lacak tugas PDF — Periksa status tugas asinkron atau lihat daftar tugas PDF terbaru beserta statusnya.
- Periksa kredit dan transaksi — Tanyakan tentang sisa kredit, info akun, atau riwayat transaksi kredit.
Dokumentasi
MCP (Model Context Protocol) adalah standar terbuka yang memungkinkan asisten AI menemukan dan menggunakan alat eksternal. Server MCP TemplateFox menyediakan 8 alat bagi asisten AI Anda untuk membuat PDF, mengelola template, dan memeriksa kredit — semuanya menggunakan bahasa alami.
Prasyarat
- Node.js 18+ terinstal di komputer Anda (untuk
npx) - Kunci API TemplateFox — dapatkan dari Dashboard (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 dalam 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 penyiapan
Setelah instalasi, tanyakan kepada asisten AI Anda:
“Daftarkan template TemplateFox saya”
Jika server MCP dikonfigurasi dengan benar, asisten akan memanggil list_templates dan menampilkan daftar template Anda. Jika muncul 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 |
TEMPLATEFOX_BASE_URL | Tidak | Mengganti 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. Biayanya 1 kredit per PDF.
Contoh permintaan:
“Buat faktur untuk John Doe, total $250, menggunakan template Invoice saya”
“Buat sertifikat kelulusan untuk Jane Smith, kursus: Advanced React”
generate_pdf_async
Antrekan pembuatan PDF asinkron dengan callback webhook opsional. Berguna untuk pekerjaan besar atau batch. Biayanya 1 kredit per PDF.
Contoh permintaan:
“Buat 10 sertifikat di latar belakang dan beri tahu saya saat selesai”
list_templates
Temukan semua template PDF yang tersedia di akun Anda.
Contoh permintaan:
“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 yang diperlukan template sebelum membuat PDF.
Contoh permintaan:
“Kolom apa saja yang diperlukan template Invoice saya?”
get_pdf_job_status
Periksa status pekerjaan pembuatan PDF asinkron.
Contoh permintaan:
“Apakah pekerjaan PDF saya sudah selesai?”
list_pdf_jobs
Tampilkan semua pekerjaan pembuatan PDF asinkron beserta statusnya.
Contoh permintaan:
“Tampilkan pekerjaan PDF terbaru saya”
get_account_info
Periksa sisa kredit dan informasi akun.
Contoh permintaan:
“Berapa sisa kredit saya?”
list_transactions
Lihat riwayat transaksi kredit.
Contoh permintaan:
“Tampilkan penggunaan kredit saya bulan ini”
Kasus penggunaan
Buat satu dokumen
Minta asisten AI Anda membuat satu PDF dengan data tertentu. Asisten akan menemukan template, memeriksa kolom yang diperlukan, lalu membuat PDF dalam satu alur:
“Buat slip pengepakan untuk pesanan #1234, pelanggan John Doe, 3x Widget Blue dan 1x Gadget Pro”
Jelajahi template sebelum membuat dokumen
Tanyakan tentang template Anda terlebih dahulu, lalu buat dokumen setelah mengetahui pilihan yang tersedia:
“Daftarkan template saya, lalu tampilkan kolom untuk template Receipt”
Periksa status akun
Pantau penggunaan Anda tanpa meninggalkan asisten AI:
“Berapa sisa kredit saya? Tampilkan transaksi terbaru saya”
Server jarak jauh (segera hadir)
Endpoint MCP HTTP terhosting di https://api.templatefox.com/mcp akan segera tersedia. Anda dapat 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 setelah memperbarui konfigurasi
“Kunci API tidak valid” atau kesalahan autentikasi
- Pastikan kunci API Anda diawali dengan
sk_dan belum kedaluwarsa - Periksa kunci di Dashboard
- Pastikan
TEMPLATEFOX_API_KEYdiatur di lingkungan yang benar (bukan hanya di shell, tetapi juga di konfigurasi server MCP)
Alat tidak muncul
- Beberapa klien menyimpan daftar alat MCP dalam cache — mulai ulang klien
- Periksa apakah server MCP lain berfungsi untuk memastikan masalahnya bukan pada tingkat klien
Langkah selanjutnya
- Mulai dalam 5 Menit — Buat template pertama Anda
- Pengikatan Data — Pelajari cara meneruskan data dinamis
- Referensi API — Dokumentasi endpoint lengkap