TemplateFox

resmi

TemplateFox ile PDF belgeleri oluşturun

templatefox.com üzerinde görüntüleBu MCP'yi deneyinSponsorlu

TemplateFox MCP ile neler yapabilirsiniz?

  • Şablonlardan PDF oluşturma — Dinamik verilerle fatura veya sertifika gibi bir PDF oluşturmayı isteyin, belge başına 1 kredi maliyeti vardır.
  • Arka planda PDF işleri kuyruğa alın — Toplu veya büyük PDF oluşturmayı asenkron olarak talep edin, isteğe bağlı olarak bir webhook geri çağrısı ile.
  • Şablonları ve alanlarını keşfedin — Mevcut PDF'leri görmek ve belirli bir şablonun hangi verileri beklediğini öğrenmek için list_templates kullanın.
  • PDF iş durumunu takip edin — Asenkron oluşturma ilerlemesini kontrol edin veya tüm son işleri inceleyin.
  • Hesap kredilerini izleyin — Kalan krediler hakkında sorun veya kullanım geçmişini inceleyin.

Dokümantasyon

MCP (Model Context Protocol), yapay zeka asistanlarının harici araçları keşfetmesine ve kullanmasına olanak tanıyan açık bir standarttır. TemplateFox MCP sunucusu, yapay zeka asistanınıza PDF oluşturma, şablon yönetimi ve kredi kontrolü için 8 araç sunar — tümü doğal dil ile.

Ön koşullar

  1. Makinenizde Node.js 18+ kurulu olmalıdır (npx için)
  2. Bir TemplateFox API anahtarı — Dashboard sayfanızdan alabilirsiniz (sk_ ile başlar)

Kurulum

Claude Desktop

Claude Desktop yapılandırmanıza ekleyin (macOS'ta ~/Library/Application Support/Claude/claude_desktop_config.json, Windows'ta %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "templatefox": {
      "command": "npx",
      "args": ["-y", "@templatefox/mcp-server"],
      "env": {
        "TEMPLATEFOX_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}

Dosyayı kaydettikten sonra Claude Desktop'u yeniden başlatın.

Claude Code

claude mcp add templatefox -- npx -y @templatefox/mcp-server

Ardından kabuğunuzda TEMPLATEFOX_API_KEY ortam değişkenini ayarlayın:

export TEMPLATEFOX_API_KEY="sk_your_api_key_here"

Cursor / Windsurf

MCP sunucu yapılandırmanızda aynı npx komutunu kullanın:

npx -y @templatefox/mcp-server

Ortam değişkenlerinde TEMPLATEFOX_API_KEY değerini ayarlayın.

Global kurulum (alternatif)

npm install -g @templatefox/mcp-server

Ardından npx yerine komut olarak templatefox-mcp-server kullanın.

Kurulumu doğrulayın

Kurulumdan sonra yapay zeka asistanınıza sorun:

“TemplateFox şablonlarımı listele”

MCP sunucusu doğru yapılandırıldıysa, asistan list_templates çağrısını yapacak ve şablon listenizi döndürecektir. Bir hata görürseniz, aşağıdaki Sorun Giderme bölümüne bakın.

Yapılandırma

Ortam DeğişkeniGerekliAçıklama
TEMPLATEFOX_API_KEYEvetAPI anahtarınız (sk_ ile başlar). Dashboard sayfanızdan alabilirsiniz
TEMPLATEFOX_BASE_URLHayırAPI temel URL'sini geçersiz kılar (varsayılan: https://api.templatefox.com)

Kullanılabilir araçlar

MCP sunucusu, yapay zeka asistanınızın çağırabileceği 8 araç sunar:

generate_pdf

Dinamik verilerle bir şablondan PDF oluşturun. PDF başına 1 kredi harcar.

Neler sorabilirsiniz:

“Invoice şablonumu kullanarak John Doe için toplam 250$ tutarında bir fatura oluştur”

“Jane Smith için Advanced React kursu tamamlama sertifikası oluştur”

generate_pdf_async

İsteğe bağlı webhook geri çağrımı ile asenkron PDF oluşturmayı kuyruğa alır. Büyük veya toplu işler için kullanışlıdır. PDF başına 1 kredi harcar.

Neler sorabilirsiniz:

“Arka planda 10 sertifika oluştur ve bittiğinde beni bilgilendir”

list_templates

Hesabınızdaki tüm mevcut PDF şablonlarını keşfedin.

Neler sorabilirsiniz:

“Hangi şablonlarım var?”

“Tüm PDF şablonlarımı göster”

get_template_fields

Belirli bir şablonun alanlarını ve değişkenlerini alın. Oluşturmadan önce bir şablonun hangi verileri beklediğini anlamak için kullanışlıdır.

Neler sorabilirsiniz:

“Invoice şablonum hangi alanlara ihtiyaç duyuyor?”

get_pdf_job_status

Asenkron bir PDF oluşturma işinin durumunu kontrol edin.

Neler sorabilirsiniz:

“PDF işim bitti mi?”

list_pdf_jobs

Tüm asenkron PDF oluşturma işlerini ve durumlarını listeleyin.

Neler sorabilirsiniz:

“Son PDF işlerimi göster”

get_account_info

Kalan kredileri ve hesap bilgilerini kontrol edin.

Neler sorabilirsiniz:

“Kaç kredim kaldı?”

list_transactions

Kredi işlem geçmişini görüntüleyin.

Neler sorabilirsiniz:

“Bu ayki kredi kullanımımı göster”

Kullanım senaryoları

Tek bir belge oluşturun

Yapay zeka asistanınızdan belirli verilerle tek bir PDF oluşturmasını isteyin. Asistan şablonu keşfeder, gerekli alanları kontrol eder ve PDF'yi tek akışta oluşturur:

“1234 numaralı sipariş için müşteri John Doe'ya, 3x Widget Blue ve 1x Gadget Pro olacak şekilde bir irsaliye oluştur”

Oluşturmadan önce şablonları keşfedin

Önce şablonlarınız hakkında sorun, ardından nelerin mevcut olduğunu öğrendikten sonra oluşturun:

“Şablonlarımı listele, ardından Receipt şablonunun alanlarını göster”

Hesap durumunu kontrol edin

Yapay zeka asistanınızdan ayrılmadan kullanımınızı izleyin:

“Kaç kredim kaldı? Son işlemlerimi göster”

Uzak sunucu (yakında)

https://api.templatefox.com/mcp adresinde barındırılan bir HTTP MCP uç noktası yakında geliyor. Bu, yerel olarak hiçbir şey kurmadan bağlanmanızı sağlayacak — MCP istemcinizi yalnızca URL'ye yönlendirmeniz yeterli.

Sorun Giderme

“MCP sunucusu bulunamadı” veya bağlantı hataları

  • Node.js 18+ kurulu olduğundan emin olun: node --version komutunu çalıştırın
  • npx komutunun çalıştığını kontrol edin: npx -y @templatefox/mcp-server --help komutunu çalıştırın
  • Yapılandırmayı güncelledikten sonra yapay zeka asistanınızı yeniden başlatın

“Geçersiz API anahtarı” veya kimlik doğrulama hataları

  • API anahtarınızın sk_ ile başladığını ve süresinin dolmadığını doğrulayın
  • Anahtarı Dashboard sayfanızda kontrol edin
  • TEMPLATEFOX_API_KEY değerinin doğru ortamda ayarlandığından emin olun (yalnızca kabuğunuzda değil, MCP sunucu yapılandırmasında)

Araçlar görünmüyor

  • Bazı istemciler MCP araç listelerini önbelleğe alır — istemciyi yeniden başlatın
  • İstemci düzeyinde bir sorun olup olmadığını anlamak için diğer MCP sunucularının çalışıp çalışmadığını kontrol edin

Sonraki adımlar