TemplateFox

MCP Sunucusu

MCP (Model Context Protocol), yapay zeka asistanlarının harici araçları keşfetmesini ve kullanmasını sağlayan açık bir standarttır. TemplateFox MCP sunucusu, yapay zeka asistanınıza PDF oluşturma, şablonları yönetme ve kredileri kontrol etme için 8 araç sunar — hepsi doğal dil ile.

• npm: @templatefox/mcp-server
• GitHub: TemplateFoxPDF/mcp-server

Ön Koşullar

1. Makinenizde Node.js 18+ kurulu olmalıdır (npx için)
2. Bir TemplateFox API anahtarı — Kontrol Panelinizden edinin (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'ı 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 ayarlayın.

Global kurulum (alternatif)

npm install -g @templatefox/mcp-server

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

Kurulumu Doğrulama

Kurulumdan sonra yapay zeka asistanınıza sorun:

“TemplateFox şablonlarımı listele”

MCP sunucusu doğru yapılandırılmışsa, asistan list_templates çağıracak 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şkeni	Gerekli	Açıklama
TEMPLATEFOX_API_KEY	Evet	API anahtarınız (sk_ ile başlar). Kontrol Panelinizden edinin
TEMPLATEFOX_BASE_URL	Hayır	API temel URL'sini geçersiz kıl (varsayılan: https://api.templatefox.com)

Mevcut Araçlar

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

generate_pdf

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

Sorabilecekleriniz:

“John Doe için 250$ tutarında bir fatura oluştur, Fatura şablonumu kullan”

“Jane Smith için bir tamamlama sertifikası oluştur, kurs: İleri React”

generate_pdf_async

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

“Arka planda 10 sertifika oluştur ve bittiğinde bana bildir”

list_templates

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

“Hangi şablonlarım var?”

“Bana tüm PDF şablonlarımı göster”

get_template_fields

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

“Fatura şablonum hangi alanlara ihtiyaç duyuyor?”

get_pdf_job_status

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

“PDF işim bitti mi?”

list_pdf_jobs

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

“Son PDF işlerimi göster”

get_account_info

Kalan kredileri ve hesap bilgilerini kontrol edin.

“Kaç kredim kaldı?”

list_transactions

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

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

Kullanım Örnekleri

Tek bir belge oluşturma

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

“#1234 siparişi için bir irsaliye oluştur, müşteri John Doe, 3x Mavi Widget ve 1x Gadget Pro”

Oluşturmadan önce şablonları keşfetme

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

“Şablonlarımı listele, sonra bana Fiş şablonunun alanlarını göster”

Hesap durumunu kontrol etme

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 yüklemeden bağlanmanızı sağlayacak — sadece MCP istemcinizi URL'ye yönlendirin.

Sorun Giderme

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

• Node.js 18+ kurulu olduğundan emin olun: node --version çalıştırın
• npx komutunun çalıştığını kontrol edin: npx -y @templatefox/mcp-server --help ç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
• Kontrol Panelinizdeki anahtarı kontrol edin
• TEMPLATEFOX_API_KEY değerinin doğru ortamda ayarlandığından emin olun (sadece 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 sorunu elemek 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 ileteceğinizi öğrenin
• API Referansı — Tam uç nokta belgeleri