TemplateFox
resmiTemplateFox 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
- Makinenizde yüklü Node.js 18+ (
npxiçin) - 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şkeni | Gerekli | Açıklama |
|---|---|---|
TEMPLATEFOX_API_KEY | Evet | API anahtarınız (sk_ ile başlar). Dashboard üzerinden edinebilirsiniz |
TEMPLATEFOX_BASE_URL | Hayır | API 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 --versionkomutunu çalıştırın npxkomutunun çalıştığını kontrol edin:npx -y @templatefox/mcp-server --helpkomutunu ç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_KEYdeğ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
- 5 Dakikada Başlayın — İlk şablonunuzu oluşturun
- Veri Bağlama — Dinamik verileri nasıl aktaracağınızı öğrenin
- API Referansı — Uç noktaların tüm belgeleri