invitation.az MCP & AI Agent İnteqrasiya Bələdçisi

invitation.az platforması süni intellekt köməkçilərinin (Claude, Cursor, ChatGPT, Antigravity) platforma ilə birbaşa qarşılıqlı əlaqədə bulunması üçün MCP (Model Context Protocol) dəstəyini aktivləşdirib. Bu inteqrasiya vasitəsilə proqramçılar və müştərilər AI agentlərinə təbii dildə əmrlər verərək dəvətnamələr yarada, qonaq siyahılarını idarə edə və yerlərin doluluq statusunu yoxlaya bilərlər.

1. MCP Nədir və Necə İşləyir?

MCP (Model Context Protocol) AI asistentlərin xarici API və xidmətlərlə heç bir məlumat kopyalamadan, birbaşa JSON-RPC protokol üzərindən təhlükəsiz ünsiyyət qurmasına imkan verən açıq standartdır.

2. Avtomatik Kəşfiyyat (Auto-Discovery) və Quraşdırma

Əksər MCP müştəriləri avtomatik kəşfiyyatı dəstəkləyir. Tədbir sistemini AI köməkçinizə tanıtmaq üçün aşağıdakı keçidlərdən istifadə edə bilərsiniz:

• Server Card (Auto-Discovery):  /.well-known/mcp/server-card.json
• Agent Card (A2A Protocol):  /.well-known/agent-card.json
• MCP Endpoint: https://invitation.az/api/mcp

Claude Desktop Üçün Konfiqurasiya (claude_desktop_config.json):

{
 "mcpServers": {
   "invitation-az": {
     "type": "streamable_http",
     "url": "https://invitation.az/api/mcp",
     "headers": {
       "Authorization": "Bearer YOUR_API_TOKEN"
     }
   }
 }
}

3. Əsas MCP Alətləri (Available Tools)

Sistemdə mövcud olan əsas MCP alətlərinin funksionallığı:

• create_invitation — Yeni rəqəmsal dəvətnamə yaradır və dizayn parametrini təyin edir.
• get_guest_rsvps — Qonaq siyahısını və real-time RSVP cavablarını gətirir.
• check_booking_availability — Təqvim üzrə məkan və zal doluluğunu yoxlayır.

4. Proqramçılar üçün Resurslar və API Sənədləri

Platformanın tam REST API və OpenAPI spesifikasiyaları ilə tanış olmaq üçün aşağıdakı keçidlərdən istifadə edin:

• Sistem haqqında ətraflı MCP İnteqrasiya Bələdçisi (mcp-integration-guide.md) sənədini oxuyun.
• Bütün test əməliyyatları və icra nəticələri üçün İcra Xülasəsi (EXECUTION_SUMMARY.md) sənədinə baxın.
• İnteraktiv API sənədləşməsi: Swagger UI Documentation
• OpenAPI JSON Faylı: OpenAPI Specification
• LLM Kontekst faylı: llms.txt (Azerbaijani Context)