Model Context Protocol (MCP)

Vignetim Partner API предоставляет полноценный сервер Model Context Protocol (MCP), позволяющий вашему AI-ассистенту напрямую взаимодействовать с API -- просматривать продукты, создавать заказы, управлять вебхуками и искать по документации -- без выхода из 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-операций требуют учётных данных Partner API через HTTP-заголовки:

Заголовок	Описание
`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
Он обнаруживает доступные инструменты (продукты, заказы, вебхуки, документация)
Когда вы спрашиваете «покажи австрийские виньетки», ассистент вызывает list_tickets с countryIsocode: "AT"
MCP-сервер подписывает запрос с помощью HMAC-SHA256 и проксирует его в Partner API
Результаты возвращаются напрямую вашему ассистенту

MCP-сервер берёт на себя всю сложность аутентификации -- подпись HMAC, метки времени, nonce -- поэтому ваш 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