TemplateFox

resmi

Hasilkan dokumen PDF dengan TemplateFox

Lihat di templatefox.comCoba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan TemplateFox MCP?

  • Hasilkan PDF dari templat — Minta asisten Anda untuk memanggil generate_pdf dengan data dinamis seperti detail faktur atau nama sertifikat.
  • Antrekan pembuatan PDF asinkron — Gunakan generate_pdf_async untuk pekerjaan batch atau latar belakang dengan panggilan balik webhook opsional.
  • Daftarkan templat yang tersedia — Temukan semua templat di akun Anda dengan list_templates.
  • Periksa bidang templat — Periksa data apa yang diharapkan templat sebelum menghasilkan melalui get_template_fields.
  • Periksa status pekerjaan asinkron — Lacak kemajuan pekerjaan PDF yang diantrekan menggunakan get_pdf_job_status.
  • Lihat kredit dan transaksi akun — Pantau sisa kredit dengan get_account_info dan tinjau riwayat penggunaan dengan list_transactions.

Dokumentasi

Server MCP

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 daftar 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 (dimulai dengan sk_). Dapatkan dari Dasbor Anda
TEMPLATEFOX_BASE_URLTidakTimpa URL basis API (default: https://api.templatefox.com)

Alat yang tersedia

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

generate_pdf

Hasilkan 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 panggilan balik webhook opsional. Berguna untuk pekerjaan besar atau batch. Menghabiskan 1 kredit per PDF.

“Hasilkan 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

Hasilkan satu dokumen

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

“Buat slip pengepakan untuk pesanan #1234, pelanggan John Doe, 3x Widget Biru 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 tunjukkan bidang untuk template Tanda Terima”

Periksa status akun

Pantau penggunaan Anda tanpa meninggalkan asisten AI:

“Berapa sisa kredit saya? Tampilkan transaksi terbaru saya”

Server jarak jauh (segera)

Titik akhir 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

Kesalahan ”Server MCP tidak ditemukan” atau 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

Kesalahan ”Kunci API tidak valid” atau 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 titik akhir lengkap