Model Context Protocol (MCP)

API-ul Vignetim pentru Parteneri oferă un server complet Model Context Protocol (MCP), permițând asistentului dumneavoastră AI să interacționeze direct cu API-ul -- să răsfoiască produse, să creeze comenzi, să gestioneze webhook-uri și să caute în documentație -- toate fără a părăsi IDE-ul.

Ce este MCP?

MCP este un protocol deschis care standardizează modul în care aplicațiile AI se conectează la instrumente și surse de date externe. Cu serverul MCP al Vignetim, asistentul dumneavoastră AI de programare devine un client al API-ului Vignetim.

Capabilități

Categorie	Instrumente	Autentificare necesară
Produse	`list_tickets`, `get_ticket`, `list_esim_packages`, `list_insurance_products`, `get_insurance_product`, `list_vehicle_categories`	Da
Comenzi	`create_order`, `list_orders`, `get_order`, `get_order_status`	Da
Webhooks	`create_webhook`, `list_webhooks`, `update_webhook`, `delete_webhook`, `test_webhook`	Da
Documentație	`list_docs`, `get_doc`, `search_docs`, `get_openapi_spec`	Nu

Endpoint MCP

https://vignetim.com/api/mcp

Autentificare

Instrumentele de operațiuni API necesită credențialele API ale Partenerului prin anteturi HTTP:

Antet	Descriere
`X-API-Key`	Cheia API a organizației dumneavoastră
`X-API-Secret`	Secretul API al organizației dumneavoastră
`X-Environment`	Opțional: `production` (implicit) sau `sandbox`

Instrumentele de documentație (list_docs, get_doc, search_docs, get_openapi_spec) funcționează fără autentificare.

Cum funcționează

Asistentul dumneavoastră AI se conectează la https://vignetim.com/api/mcp
Descoperă instrumentele disponibile (produse, comenzi, webhook-uri, documentație)
Când întrebați „listează vignetele austriece", asistentul apelează list_tickets cu countryIsocode: "AT"
Serverul MCP semnează cererea cu HMAC-SHA256 și o transmite către API-ul pentru Parteneri
Rezultatele sunt returnate direct asistentului dumneavoastră

Serverul MCP gestionează toată complexitatea autentificării -- semnarea HMAC, mărci temporale, nonce-uri -- astfel încât agentul dumneavoastră AI apelează doar instrumentele cu parametri simpli.

Suport platforme

Platformă	Transport	Ghid de configurare
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 →

Resurse suplimentare

Specificație OpenAPI: https://vignetim.com/api/partner-openapi
LLMs.txt: https://vignetim.com/llms.txt
AI Plugin: https://vignetim.com/.well-known/ai-plugin.json