TemplateFox

MCP Sunucusu

Sayfayı kopyala

MCP Sunucusu

MCP (Model Bağlam Protokolü), 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 tamamı doğal dil ile PDF oluşturmak, şablonları yönetmek ve kredileri kontrol etmek için 8 araç sunar.

• 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 bir tane 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ğrulayın

Kurulumdan sonra yapay zeka asistanınıza şunu 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)

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.

Sorabilecekleriniz:

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

“Jane Smith için kurs: Advanced React olan bir tamamlama sertifikası oluştur”

generate_pdf_async

İsteğe bağlı bir webhook geri çağrısı ile eşzamansız PDF oluşturmayı sıraya alın. 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 kullanılabilir 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ın. Oluşturmadan önce bir şablonun hangi verileri beklediğini anlamak için kullanışlıdır.

“Invoice şablonum hangi alanlara ihtiyaç duyuyor?”

get_pdf_job_status

Eşzamansız bir PDF oluşturma işinin durumunu kontrol edin.

“PDF işim henüz bitti mi?”

list_pdf_jobs

Tüm eşzamansız PDF oluşturma işlerini ve durumlarını listeleyin.

“Bana 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şturun

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:

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

Oluşturmadan önce şablonları keşfedin

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

“Şablonlarımı listele, ardından Fiş şablonu için alanları 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 yüklemeden bağlanmanıza olanak tanıyacak — 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 aktaracağınızı öğrenin
• API Referansı — Tam uç nokta belgeleri

Son güncelleme: 12 Temmuz 2026

PDF StandartlarıS3'e Yükle