Vignetim OpenAI MCP

Vignetim Partner API'yi Cursor, Windsurf, Continue, OpenAI Agents SDK ve Model Context Protocol'ü destekleyen herhangi bir platforma bağlayın.

Hızlı Kurulum

Cursor

Cursor Ayarları → MCP → Yeni MCP sunucusu ekle:

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

Windsurf

Windsurf MCP yapılandırmanıza ekleyin:

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

Continue (VS Code)

.continue/config.json dosyasına ekleyin:

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

OpenAI Agents SDK (Python)

from openai_agents import Agent, MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    url="https://vignetim.com/api/mcp",
    name="vignetim",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "X-API-Secret": "YOUR_API_SECRET",
    },
) as mcp:
    agent = Agent(
        name="Vignetim Partner",
        instructions="You manage Vignetim API integration. Browse products, create orders, and manage webhooks.",
        mcp_servers=[mcp],
    )
    result = await agent.run("List all Hungarian vignettes for cars")

OpenAI Agents SDK (Node.js)

import { Agent, MCPServerStreamableHttp } from '@openai/agents';

const mcp = new MCPServerStreamableHttp({
	url: 'https://vignetim.com/api/mcp',
	name: 'vignetim',
	headers: {
		'X-API-Key': 'YOUR_API_KEY',
		'X-API-Secret': 'YOUR_API_SECRET',
	},
});

await mcp.connect();

const agent = new Agent({
	name: 'Vignetim Partner',
	instructions: 'You manage Vignetim API integration.',
	mcpServers: [mcp],
});

const result = await agent.run('Show me my recent orders');

Kullanılabilir Araçlar (toplam 19)

Ürünler (6 araç)

Araç	Metod	API Uç Noktası
`list_tickets`	GET	`/products/tickets`
`get_ticket`	GET	`/products/tickets/:id`
`list_esim_packages`	GET	`/products/esim`
`list_insurance_products`	GET	`/products/insurance`
`get_insurance_product`	GET	`/products/insurance/:slug`
`list_vehicle_categories`	GET	`/products/vehicle-categories`

Siparişler (4 araç)

Araç	Metod	API Uç Noktası
`create_order`	POST	`/orders`
`list_orders`	GET	`/orders`
`get_order`	GET	`/orders/:id`
`get_order_status`	GET	`/orders/:id/status`

Webhook'lar (5 araç)

Araç	Metod	API Uç Noktası
`create_webhook`	POST	`/webhooks`
`list_webhooks`	GET	`/webhooks`
`update_webhook`	PUT	`/webhooks/:id`
`delete_webhook`	DELETE	`/webhooks/:id`
`test_webhook`	POST	`/webhooks/:id/test`

Dokümantasyon (4 araç — kimlik doğrulama gerekmez)

Araç	Açıklama
`list_docs`	Tüm API dokümantasyon bölümlerini listele
`get_doc`	Slug'a göre bir bölümün tam içeriğini getir
`search_docs`	Tüm dokümantasyonda ara
`get_openapi_spec`	OpenAPI 3.0 tanım URL'sini getir

Özel Ajan Oluşturma

from openai_agents import Agent, MCPServerStreamableHttp, Runner

SYSTEM_PROMPT = """You are a Vignetim Partner API assistant.
You help manage e-vignette, eSIM, and insurance orders.

Available actions:
- Browse products (vignettes, eSIM packages, insurance)
- Create and track orders
- Set up and manage webhook notifications
- Search API documentation for integration help

Always confirm before creating orders or modifying webhooks.
Use sandbox mode for testing."""

async def main():
    async with MCPServerStreamableHttp(
        url="https://vignetim.com/api/mcp",
        name="vignetim",
        headers={
            "X-API-Key": "YOUR_KEY",
            "X-API-Secret": "YOUR_SECRET",
            "X-Environment": "sandbox",
        },
    ) as mcp:
        agent = Agent(
            name="Vignetim Assistant",
            instructions=SYSTEM_PROMPT,
            mcp_servers=[mcp],
        )
        result = await Runner.run(
            agent,
            "Set up webhooks for order.completed and order.failed events "
            "at https://myapp.com/api/webhooks/vignetim, then send a test event."
        )
        print(result.final_output)

Sandbox Modu

Simüle edilmiş ödemelerle sandbox API'yi kullanmak için başlıklarınıza X-Environment: sandbox ekleyin:

{
	"headers": {
		"X-API-Key": "YOUR_SANDBOX_KEY",
		"X-API-Secret": "YOUR_SANDBOX_SECRET",
		"X-Environment": "sandbox"
	}
}

Alternatif: Doğrudan HTTP Erişimi

Platformunuz MCP'yi desteklemiyorsa:

Kaynak	URL
OpenAPI Tanımı	`https://vignetim.com/api/partner-openapi`
LLMs.txt	`https://vignetim.com/llms.txt`
AI Plugin	`https://vignetim.com/.well-known/ai-plugin.json`
API Dokümanları	`https://vignetim.com/tr/developers/api-reference`

Sorun Giderme

"API credentials required"

API araçları hem X-API-Key hem de X-API-Secret başlıklarına ihtiyaç duyar. Dokümantasyon araçları kimlik bilgileri olmadan çalışır.

Bağlantı Sorunları

Uç noktanın erişilebilir olduğunu doğrulayın:

curl -X POST https://vignetim.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Hız Sınırlaması (Rate Limiting)

MCP sunucusu Partner API hız sınırlarına uyar: genel 100 istek/dk, sipariş oluşturma için 10 istek/dk. Sandbox'ta 5 kat çarpan uygulanır.