TemplateFox

resmi

TemplateFox ile PDF belgeleri oluşturun

TemplateFox MCP ile neler yapabilirsiniz?

  • Şablonlardan PDF oluşturun — Asistanınızdan fatura veya sertifika gibi dinamik veriler içeren bir şablondan PDF oluşturmasını isteyin.
  • PDF işlerini kuyruğa alın — Büyük veya toplu işler için arka planda oluşturma talep edin; işlem tamamlandığında isteğe bağlı bir webhook geri çağrısı alın.
  • Şablonları ve alanları inceleyin — Oluşturmadan önce kullanılabilir şablonları listeleyin ve belirli bir şablonun beklediği alanları öğrenin.
  • PDF işlerini takip edin — Asenkron bir işin durumunu kontrol edin veya son PDF işlerini ve durumlarını listeleyin.
  • Kredileri ve işlemleri kontrol edin — Kalan krediler, hesap bilgileri veya kredi işlem geçmişi hakkında bilgi alın.

Dokümantasyon

MCP (Model Context Protocol), yapay zekâ asistanlarının harici araçları keşfedip kullanmasını sağlayan açık bir standarttır. TemplateFox MCP sunucusu, yapay zekâ asistanınıza PDF oluşturmak, şablonları yönetmek ve kredileri kontrol etmek için doğal dille kullanabileceğiniz 8 araç sunar.

Ön koşullar

  1. Makinenizde yüklü Node.js 18+ (npx için)
  2. Bir TemplateFox API anahtarı — Dashboard üzerinden edinebilirsiniz (sk_ ile başlar)

Kurulum

Claude Desktop

Claude Desktop yapılandırmanıza ekleyin (macOS'te ~/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'ı 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 sunucusu 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.

Genel kurulum (alternatif)

npm install -g @templatefox/mcp-server

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

Kurulumu doğrulayın

Kurulumdan sonra yapay zekâ asistanınıza şunu sorun:

“TemplateFox şablonlarımı listele”

MCP sunucusu doğru yapılandırılmışsa asistan list_templates aracını çağırır ve şablon listenizi döndürür. 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 üzerinden edinebilirsiniz
TEMPLATEFOX_BASE_URLHayırAPI temel URL'sini geçersiz kılar (varsayılan: https://api.templatefox.com)

Kullanılabilir araçlar

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

generate_pdf

Dinamik verilerle bir şablondan PDF oluşturur. Her PDF için 1 kredi harcanır.

Şunları isteyebilirsiniz:

“Fatura şablonumu kullanarak John Doe için toplamı 250 $ olan bir fatura oluştur”

“Jane Smith için Advanced React kursunu tamamladığına dair bir sertifika oluştur”

generate_pdf_async

İsteğe bağlı bir webhook geri çağrısıyla asenkron PDF oluşturma işini kuyruğa alır. Büyük veya toplu işler için kullanışlıdır. Her PDF için 1 kredi harcanır.

Şunları isteyebilirsiniz:

“Arka planda 10 sertifika oluştur ve tamamlandığında bana haber ver”

list_templates

Hesabınızdaki tüm kullanılabilir PDF şablonlarını keşfeder.

Şunları isteyebilirsiniz:

“Hangi şablonlarım var?”

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

get_template_fields

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

Şunları isteyebilirsiniz:

“Fatura şablonum hangi alanları gerektiriyor?”

get_pdf_job_status

Asenkron PDF oluşturma işinin durumunu kontrol eder.

Şunları isteyebilirsiniz:

“PDF işim tamamlandı mı?”

list_pdf_jobs

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

Şunları isteyebilirsiniz:

“Son PDF işlerimi göster”

get_account_info

Kalan kredileri ve hesap bilgilerini kontrol eder.

Şunları isteyebilirsiniz:

“Kaç kredim kaldı?”

list_transactions

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

Şunları isteyebilirsiniz:

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

Kullanım örnekleri

Tek bir belge oluşturma

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

“1234 numaralı sipariş için John Doe müşterisine 3x Widget Blue ve 1x Gadget Pro içeren bir paketleme fişi oluştur”

Oluşturmadan önce şablonları inceleme

Önce şablonlarınızı sorun, ardından nelerin kullanılabilir olduğunu öğrendikten sonra belge oluşturun:

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

Hesap durumunu kontrol etme

Yapay zekâ asistanınızdan ayrılmadan kullanımınızı takip edin:

“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 kullanıma sunulacak. Böylece yerel olarak herhangi bir şey yüklemeden bağlanabileceksiniz — MCP istemcinizi URL'ye yönlendirmeniz yeterli.

Sorun giderme

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

  • Node.js 18+ yüklü 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 zekâ 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 üzerinden kontrol edin
  • TEMPLATEFOX_API_KEY değişkeninin doğru ortamda ayarlandığından emin olun (yalnızca kabuğunuzda değil, MCP sunucusu yapılandırmasında da)

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 olmadığını doğrulamak için diğer MCP sunucularının çalışıp çalışmadığını kontrol edin

Sonraki adımlar