Vignetim Claude MCP

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

Быстрая настройка

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`	Детали страховки	«Расскажи о страховании green card»
`list_vehicle_categories`	Просмотр типов ТС	«Какие категории транспортных средств существуют?»

Заказы

Инструмент	Описание	Пример
`create_order`	Создание заказа	«Создай заказ виньетки для Австрии»
`list_orders`	Список заказов	«Покажи мои последние заказы»
`get_order`	Детали заказа	«Какой статус у заказа xyz?»
`get_order_status`	Проверка статуса	«Заказ xyz выполнен?»

Webhooks

Инструмент	Описание	Пример
`create_webhook`	Регистрация эндпоинта	«Настрой вебхук для событий order.completed»
`list_webhooks`	Список вебхуков	«Покажи зарегистрированные вебхуки»
`update_webhook`	Обновление вебхука	«Отключи вебхук abc»
`delete_webhook`	Удаление вебхука	«Удали вебхук abc»
`test_webhook`	Отправка тестового события	«Отправь тестовое событие на вебхук abc»

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

Инструмент	Описание	Пример
`list_docs`	Просмотр документации	«Какая документация API доступна?»
`get_doc`	Чтение раздела	«Покажи документацию по аутентификации»
`search_docs`	Поиск по документации	«Как обрабатывать ошибки?»
`get_openapi_spec`	Получение спецификации OpenAPI	«Где находится спецификация OpenAPI?»

Примеры использования

Просмотр продуктов

You: What vignettes are available for Hungary?

Claude: [calls list_tickets with countryIsocode: "HU"]
        Found 12 vignette options for Hungary:
        - 10-day highway vignette (Category D1) — €14.90
        - Monthly highway vignette (Category D1) — €19.90
        ...

Управление вебхуками

You: Set up a webhook at https://myapp.com/webhooks/vignetim
     for order completed and failed events.

Claude: [calls create_webhook with url, events]
        Webhook registered successfully!
        ID: 7f3a...
        Signing Secret: abc123...  (save this — it's only shown once)

Проверка статуса заказа

You: Show me all failed orders from this week.

Claude: [calls list_orders with status filter and date range]
        Found 2 failed orders:
        1. Order #abc - Failed at 2026-03-18 (vignette, AT)
        2. Order #def - Failed at 2026-03-19 (eSIM, global)

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

Добавьте в файл .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)

Песочница и продакшен

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