Model Context Protocol (MCP)

Vignetim Partner API, tam bir Model Context Protocol (MCP) sunucusu sağlar. Bu sayede yapay zeka asistanınız API ile doğrudan etkileşime geçebilir -- ürünlere göz atabilir, sipariş oluşturabilir, webhook'ları yönetebilir ve dokümantasyonu arayabilir -- tüm bunları IDE'nizden ayrılmadan yapabilirsiniz.

MCP Nedir?

MCP, yapay zeka uygulamalarının harici araçlara ve veri kaynaklarına nasıl bağlanacağını standartlaştıran açık bir protokoldür. Vignetim'in MCP sunucusu ile yapay zeka kodlama asistanınız bir Vignetim API istemcisine dönüşür.

Yetenekler

Kategori	Araçlar	Kimlik Doğrulama Gerekli
Ürünler	`list_tickets`, `get_ticket`, `list_esim_packages`, `list_insurance_products`, `get_insurance_product`, `list_vehicle_categories`	Evet
Siparişler	`create_order`, `list_orders`, `get_order`, `get_order_status`	Evet
Webhook'lar	`create_webhook`, `list_webhooks`, `update_webhook`, `delete_webhook`, `test_webhook`	Evet
Dokümantasyon	`list_docs`, `get_doc`, `search_docs`, `get_openapi_spec`	Hayır

MCP Uç Noktası

https://vignetim.com/api/mcp

Kimlik Doğrulama (Authentication)

API işlem araçları, HTTP başlıkları aracılığıyla Partner API kimlik bilgilerinizi gerektirir:

Başlık	Açıklama
`X-API-Key`	Kuruluşunuzun API anahtarı
`X-API-Secret`	Kuruluşunuzun API gizli anahtarı
`X-Environment`	İsteğe bağlı: `production` (varsayılan) veya `sandbox`

Dokümantasyon araçları (list_docs, get_doc, search_docs, get_openapi_spec) kimlik doğrulama olmadan çalışır.

Nasıl Çalışır

Yapay zeka asistanınız https://vignetim.com/api/mcp adresine bağlanır
Kullanılabilir araçları (ürünler, siparişler, webhook'lar, dokümantasyon) keşfeder
"Avusturya vinyetlerini listele" dediğinizde, asistan list_tickets aracını countryIsocode: "AT" parametresiyle çağırır
MCP sunucusu isteği HMAC-SHA256 ile imzalar ve Partner API'ye iletir
Sonuçlar doğrudan asistanınıza döndürülür

MCP sunucusu tüm kimlik doğrulama karmaşıklığını -- HMAC imzalama, zaman damgaları, nonce'lar -- yönetir, böylece yapay zeka ajanınız basit parametrelerle araçları çağırır.

Platform Desteği

Platform	Aktarım	Kurulum Rehberi
Claude Code	Streamable HTTP	Vignetim Claude MCP →
Claude Desktop	Streamable HTTP	Vignetim Claude MCP →
Cursor	Streamable HTTP	Vignetim OpenAI MCP →
Windsurf	Streamable HTTP	Vignetim OpenAI MCP →
OpenAI Agents SDK	Streamable HTTP	Vignetim OpenAI MCP →
Continue	Streamable HTTP	Vignetim OpenAI MCP →

Ek Kaynaklar

OpenAPI Tanımı: https://vignetim.com/api/partner-openapi
LLMs.txt: https://vignetim.com/llms.txt
AI Plugin: https://vignetim.com/.well-known/ai-plugin.json