Model Context Protocol (MCP)
Vignetim Partner API надає повноцінний сервер Model Context Protocol (MCP), що дозволяє вашому ШІ-асистенту безпосередньо взаємодіяти з API — переглядати продукти, створювати замовлення, керувати webhook-ами та шукати документацію — не залишаючи вашого IDE.
Що таке MCP?
MCP — це відкритий протокол, який стандартизує спосіб підключення ШІ-додатків до зовнішніх інструментів та джерел даних. З MCP-сервером Vignetim ваш ШІ-асистент для написання коду стає клієнтом 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 потребують ваших облікових даних Partner API через HTTP-заголовки:
| Заголовок | Опис |
|---|---|
X-API-Key | Ваш API-ключ організації |
X-API-Secret | Ваш секрет API організації |
X-Environment | Необов'язковий: production (за замовчуванням) або sandbox |
Інструменти документації (
list_docs,get_doc,search_docs,get_openapi_spec) працюють без автентифікації.
Як це працює
- Ваш ШІ-асистент підключається до
https://vignetim.com/api/mcp - Він виявляє доступні інструменти (продукти, замовлення, webhook-и, документація)
- Коли ви запитуєте «покажи австрійські віньєтки», асистент викликає
list_ticketsзcountryIsocode: "AT" - MCP-сервер підписує запит за допомогою HMAC-SHA256 та проксує його до Partner API
- Результати повертаються безпосередньо вашому асистенту
MCP-сервер обробляє всю складність автентифікації — HMAC-підписи, мітки часу, nonce — тому ваш ШІ-агент просто викликає інструменти з простими параметрами.
Підтримка платформ
| Платформа | Транспорт | Посібник з налаштування |
|---|---|---|
| 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