Vignetim Claude MCP

Підключіть Vignetim Partner API безпосередньо до Claude Code або Claude Desktop. Ваш асистент зможе переглядати продукти, створювати замовлення, керувати webhook-ами та шукати документацію.

Швидке налаштування

Claude Code (CLI)

claude mcp add vignetim --transport http https://vignetim.com/api/mcp \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "X-API-Secret: YOUR_API_SECRET"

Для тестування в пісочниці:

claude mcp add vignetim-sandbox --transport http https://vignetim.com/api/mcp \
  --header "X-API-Key: YOUR_SANDBOX_KEY" \
  --header "X-API-Secret: YOUR_SANDBOX_SECRET" \
  --header "X-Environment: sandbox"

Claude Desktop

Додайте до файлу конфігурації Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
	"mcpServers": {
		"vignetim": {
			"url": "https://vignetim.com/api/mcp",
			"headers": {
				"X-API-Key": "YOUR_API_KEY",
				"X-API-Secret": "YOUR_API_SECRET"
			}
		}
	}
}

Перезапустіть Claude Desktop після збереження.

Доступні інструменти

Продукти

Інструмент	Опис	Приклад
`list_tickets`	Перегляд віньєток	«Покажи австрійські віньєтки для легкових авто»
`get_ticket`	Деталі віньєтки	«Отримай деталі віньєтки abc-123»
`list_esim_packages`	Перегляд eSIM-пакетів	«Які eSIM-пакети доступні для Туреччини?»
`list_insurance_products`	Перегляд страхування	«Список усіх страхових продуктів»
`get_insurance_product`	Деталі страхування	«Розкажи про страхування зеленої картки»
`list_vehicle_categories`	Перегляд типів транспорту	«Які категорії транспортних засобів існують?»

Замовлення

Інструмент	Опис	Приклад
`create_order`	Створити замовлення	«Створи замовлення на віньєтку для Австрії»
`list_orders`	Список замовлень	«Покажи мої останні замовлення»
`get_order`	Деталі замовлення	«Який статус замовлення xyz?»
`get_order_status`	Перевірка статусу замовлення	«Чи виконано замовлення xyz?»

Webhooks

Інструмент	Опис	Приклад
`create_webhook`	Реєстрація ендпоінта	«Налаштуй webhook для подій order.completed»
`list_webhooks`	Список webhook-ів	«Покажи мої зареєстровані webhook-и»
`update_webhook`	Оновлення webhook	«Вимкни webhook abc»
`delete_webhook`	Видалення webhook	«Видали webhook abc»
`test_webhook`	Надсилання тестової події	«Надішли тестову подію на webhook abc»

Документація

Інструмент	Опис	Приклад
`list_docs`	Перегляд документації	«Яка API-документація доступна?»
`get_doc`	Читання розділу	«Покажи документацію з автентифікації»
`search_docs`	Пошук у документації	«Як обробляти помилки?»
`get_openapi_spec`	Отримати специфікацію OpenAPI	«Де специфікація OpenAPI?»

Приклади використання

Перегляд продуктів

Ви: Які віньєтки доступні для Угорщини?

Claude: [викликає list_tickets з countryIsocode: "HU"]
        Знайдено 12 варіантів віньєток для Угорщини:
        - 10-денна автодорожня віньєтка (Категорія D1) — 14,90 EUR
        - Місячна автодорожня віньєтка (Категорія D1) — 19,90 EUR
        ...

Керування Webhooks

Ви: Налаштуй webhook на https://myapp.com/webhooks/vignetim
     для подій завершення та невдачі замовлення.

Claude: [викликає create_webhook з url, events]
        Webhook успішно зареєстровано!
        ID: 7f3a...
        Секрет підпису: abc123...  (збережіть — він показується лише один раз)

Перевірка статусу замовлення

Ви: Покажи всі невдалі замовлення за цей тиждень.

Claude: [викликає list_orders з фільтром статусу та діапазоном дат]
        Знайдено 2 невдалих замовлення:
        1. Замовлення #abc - Невдача 2026-03-18 (віньєтка, AT)
        2. Замовлення #def - Невдача 2026-03-19 (eSIM, глобальний)

Конфігурація для команди

Додайте до .claude/settings.json вашого проєкту для доступу всієї команди:

{
	"mcpServers": {
		"vignetim": {
			"url": "https://vignetim.com/api/mcp",
			"headers": {
				"X-API-Key": "YOUR_API_KEY",
				"X-API-Secret": "YOUR_API_SECRET"
			}
		}
	}
}

Усунення неполадок

«API credentials required»

Ця помилка з'являється при використанні API-інструментів без облікових даних. Переконайтеся, що обидва заголовки X-API-Key та X-API-Secret налаштовані.

«Authentication failed»

Перевірте правильність вашого API-ключа та секрету
Переконайтеся, що ваш ключ активний у Vignetim Partner Dashboard
Переконайтеся, що ваша IP-адреса в білому списку (якщо увімкнено обмеження за IP)

Пісочниця vs Продакшн

Використовуйте заголовок X-Environment: sandbox для тестування з sandbox API. Режим пісочниці використовує імітовані платежі та тестові дані.