Vignetim Claude MCP

Vignetim Partner API'yi doğrudan Claude Code veya Claude Desktop'a bağlayın. Asistanınız ürünlere göz atabilir, sipariş oluşturabilir, webhook'ları yönetebilir ve dokümantasyonu arayabilir.

Hızlı Kurulum

Claude Code (CLI)

claude mcp add vignetim --transport http https://vignetim.com/api/mcp \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "X-API-Secret: YOUR_API_SECRET"

Sandbox testi için:

claude mcp add vignetim-sandbox --transport http https://vignetim.com/api/mcp \
  --header "X-API-Key: YOUR_SANDBOX_KEY" \
  --header "X-API-Secret: YOUR_SANDBOX_SECRET" \
  --header "X-Environment: sandbox"

Claude Desktop

Claude Desktop yapılandırma dosyanıza ekleyin:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
	"mcpServers": {
		"vignetim": {
			"url": "https://vignetim.com/api/mcp",
			"headers": {
				"X-API-Key": "YOUR_API_KEY",
				"X-API-Secret": "YOUR_API_SECRET"
			}
		}
	}
}

Kaydettikten sonra Claude Desktop'ı yeniden başlatın.

Kullanılabilir Araçlar

Ürünler

Araç	Açıklama	Örnek
`list_tickets`	Vinyet biletlerine göz at	"Arabalar için Avusturya vinyetlerini göster"
`get_ticket`	Bilet detaylarını getir	"abc-123 biletinin detaylarını getir"
`list_esim_packages`	eSIM paketlerine göz at	"Türkiye için hangi eSIM paketleri mevcut?"
`list_insurance_products`	Sigorta ürünlerine göz at	"Tüm sigorta ürünlerini listele"
`get_insurance_product`	Sigorta detaylarını getir	"Yeşil kart sigortası hakkında bilgi ver"
`list_vehicle_categories`	Araç türlerine göz at	"Hangi araç kategorileri var?"

Siparişler

Araç	Açıklama	Örnek
`create_order`	Sipariş oluştur	"Avusturya için bir vinyet siparişi oluştur"
`list_orders`	Siparişlerini listele	"Son siparişlerimi göster"
`get_order`	Sipariş detaylarını getir	"xyz siparişinin durumu ne?"
`get_order_status`	Sipariş durumunu kontrol et	"xyz siparişi tamamlandı mı?"

Webhook'lar

Araç	Açıklama	Örnek
`create_webhook`	Uç nokta kaydet	"order.completed olayları için bir webhook kur"
`list_webhooks`	Webhook'ları listele	"Kayıtlı webhook'larımı göster"
`update_webhook`	Webhook güncelle	"abc webhook'unu devre dışı bırak"
`delete_webhook`	Webhook sil	"abc webhook'unu kaldır"
`test_webhook`	Test olayı gönder	"abc webhook'una bir test olayı gönder"

Dokümantasyon

Araç	Açıklama	Örnek
`list_docs`	Dokümanlara göz at	"Hangi API dokümanları mevcut?"
`get_doc`	Bir bölümü oku	"Kimlik doğrulama dokümanlarını göster"
`search_docs`	Dokümanlarda ara	"Hataları nasıl yönetirim?"
`get_openapi_spec`	OpenAPI tanımını getir	"OpenAPI tanımı nerede?"

Kullanım Örnekleri

Ürünlere Göz Atma

Sen: Macaristan için hangi vinyetler mevcut?

Claude: [list_tickets aracını countryIsocode: "HU" ile çağırır]
        Macaristan için 12 vinyet seçeneği bulundu:
        - 10 günlük otoyol vinyeti (Kategori D1) — 14,90 €
        - Aylık otoyol vinyeti (Kategori D1) — 19,90 €
        ...

Webhook Yönetimi

Sen: https://myapp.com/webhooks/vignetim adresine sipariş
     tamamlandı ve başarısız olayları için webhook kur.

Claude: [create_webhook aracını url ve events ile çağırır]
        Webhook başarıyla kaydedildi!
        ID: 7f3a...
        İmza Anahtarı: abc123...  (kaydedin — sadece bir kez gösterilir)

Sipariş Durumu Kontrolü

Sen: Bu haftanın başarısız siparişlerini göster.

Claude: [list_orders aracını durum filtresi ve tarih aralığıyla çağırır]
        2 başarısız sipariş bulundu:
        1. Sipariş #abc - 2026-03-18'de başarısız oldu (vinyet, AT)
        2. Sipariş #def - 2026-03-19'da başarısız oldu (eSIM, global)

Takım Yapılandırması

Takım genelinde erişim için projenizin .claude/settings.json dosyasına ekleyin:

{
	"mcpServers": {
		"vignetim": {
			"url": "https://vignetim.com/api/mcp",
			"headers": {
				"X-API-Key": "YOUR_API_KEY",
				"X-API-Secret": "YOUR_API_SECRET"
			}
		}
	}
}

Sorun Giderme

"API credentials required"

Bu hata, kimlik bilgileri olmadan API araçlarını kullanırken görünür. Hem X-API-Key hem de X-API-Secret başlıklarının yapılandırıldığından emin olun.

"Authentication failed"

API anahtarınızın ve gizli anahtarınızın doğru olduğunu doğrulayın
Anahtarınızın Vignetim Partner Dashboard'da aktif olduğunu kontrol edin
IP'nizin beyaz listeye alındığından emin olun (IP kısıtlamaları etkinse)

Sandbox ve Üretim

Sandbox API'ye karşı test yapmak için X-Environment: sandbox başlığını kullanın. Sandbox modu simüle edilmiş ödemeler ve test verileri kullanır.