TemplateFox

resmi

Hasilkan 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

  1. Node.js 18+ terinstal di komputer Anda (untuk npx)
  2. 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 LingkunganWajibDeskripsi
TEMPLATEFOX_API_KEYYaKunci API Anda (diawali dengan sk_). Dapatkan dari Dashboard
TEMPLATEFOX_BASE_URLTidakMengganti 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 npx berfungsi: jalankan npx -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_KEY diatur 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