Vignetim Claude MCP

Свържете партньорския API на Vignetim директно с 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"

За тестване в sandbox среда:

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 €
        - Месечна магистрална винетка (Категория D1) — 19,90 €
        ...

Управление на 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
Уверете се, че вашият IP е в списъка с разрешени (ако IP ограниченията са активирани)

Sandbox спрямо Production

Използвайте хедъра X-Environment: sandbox, за да тествате срещу sandbox API-то. Sandbox режимът използва симулирани плащания и тестови данни.