TemplateFox

resmi

Hasilkan 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_templates untuk 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

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