Model Context Protocol (MCP)
Партньорският API на Vignetim предоставя пълен Model Context Protocol (MCP) сървър, който позволява на вашия AI асистент директно да взаимодейства с API-то -- да разглежда продукти, да създава поръчки, да управлява webhook-ове и да търси в документацията -- без да напуска вашата среда за разработка (IDE).
Какво е MCP?
MCP е отворен протокол, който стандартизира начина, по който AI приложенията се свързват с външни инструменти и източници на данни. С MCP сървъра на Vignetim вашият AI асистент за програмиране се превръща в клиент на Vignetim API.
Възможности
| Категория | Инструменти | Изисква удостоверяване |
|---|---|---|
| Продукти | list_tickets, get_ticket, list_esim_packages, list_insurance_products, get_insurance_product, list_vehicle_categories | Да |
| Поръчки | create_order, list_orders, get_order, get_order_status | Да |
| Webhooks | create_webhook, list_webhooks, update_webhook, delete_webhook, test_webhook | Да |
| Документация | list_docs, get_doc, search_docs, get_openapi_spec | Не |
MCP крайна точка
https://vignetim.com/api/mcp
Удостоверяване
Инструментите за API операции изискват вашите партньорски API идентификационни данни чрез HTTP хедъри:
| Header | Описание |
|---|---|
X-API-Key | Вашият API ключ на организацията |
X-API-Secret | Вашата API тайна на организацията |
X-Environment | Опционално: production (по подразбиране) или sandbox |
Инструментите за документация (
list_docs,get_doc,search_docs,get_openapi_spec) работят без удостоверяване.
Как работи
- Вашият AI асистент се свързва към
https://vignetim.com/api/mcp - Той открива наличните инструменти (продукти, поръчки, webhook-ове, документация)
- Когато попитате „покажи австрийските винетки", асистентът извиква
list_ticketsсcountryIsocode: "AT" - MCP сървърът подписва заявката с HMAC-SHA256 и я препраща към партньорския API
- Резултатите се връщат директно на вашия асистент
MCP сървърът обработва цялата сложност на удостоверяването -- HMAC подписване, timestamps, nonces -- така че вашият AI агент просто извиква инструменти с прости параметри.
Поддръжка на платформи
| Платформа | Транспорт | Ръководство за настройка |
|---|---|---|
| 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 → |
Допълнителни ресурси
- OpenAPI спецификация:
https://vignetim.com/api/partner-openapi - LLMs.txt:
https://vignetim.com/llms.txt - AI Plugin:
https://vignetim.com/.well-known/ai-plugin.json