MCP სერვერი — მომხმარებლის სახელმძღვანელო

რა არის ეს?

MCP სერვერი (Model Context Protocol) meni.ge-სთვის საშუალებას გაძლევთ AI ასისტენტები (Claude, ChatGPT, Cursor, VS Code Copilot და სხვ.) დააკავშიროთ თქვენი რესტორნის მონაცემებთან. AI იღებს წვდომას მენიუზე, ლოკაციებზე, შეკვეთებზე, სურათებზე და შეუძლია მათი მართვა თქვენი სახელით.

სწრაფი დაწყება

1. მიიღეთ API გასაღები

API გასაღები გენერირდება თქვენი რესტორნის ადმინ-პანელში.

ნაბიჯ-ნაბიჯ:

შედით ადმინ-პანელში მისამართზე admin.meni.ge
გვერდითა მენიუში გახსენით ⚙️ პარამეტრები → 🔑 წვდომა
გვერდზე იპოვეთ სექცია 🤖 MCP API გასაღებები
დააჭირეთ ღილაკს „ახალი გასაღების გენერაცია"
შეიყვანეთ გასაღების სახელი (მაგ., „Claude Desktop", „Cursor", „ჩემი GPT") — ეს დაგეხმარებათ გასაღებების ერთმანეთისგან განსხვავებაში
დაუყოვნებლივ დააკოპირეთ გასაღები — ის მხოლოდ ერთხელ ჩანს!

💡 ამავე გვერდზე ნაჩვენებია სერვერის URL (https://api.meni.ge/mcp), რომელიც ასევე შეგიძლიათ ერთი დაჭერით დააკოპიროთ.

გასაღებების მართვა

შეგიძლიათ შექმნათ 10 გასაღებამდე ანგარიშზე
თითოეული გასაღები შეიძლება გაუქმდეს ნებისმიერ დროს — ღილაკი „გაუქმება" გასაღების გვერდით
გაუქმების შემდეგ გასაღები დაუყოვნებლივ წყვეტს მუშაობას
თუ გასაღები დაიკარგა — გააუქმეთ და შექმენით ახალი

2. დააკავშირეთ AI ასისტენტი

Claude Desktop / Claude Code

კონფიგურაციის ფაილი claude_desktop_config.json:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer თქვენი_API_გასაღები"
      }
    }
  }
}

Cursor

Cursor-ის პარამეტრებში → MCP Servers → Add, ან შექმენით .cursor/mcp.json:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer თქვენი_API_გასაღები"
      }
    }
  }
}

VS Code (GitHub Copilot)

პროექტის .vscode/mcp.json ფაილში:

{
  "servers": {
    "meni": {
      "type": "http",
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer თქვენი_API_გასაღები"
      }
    }
  }
}

სხვა AI ინსტრუმენტები

დეტალური ნაბიჯ-ნაბიჯ ინსტრუქციები Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Continue, ChatGPT და სხვებისთვის — ცალკე სახელმძღვანელოში:

👉 AI ინსტრუმენტების დაკავშირება MCP-სთან

რა შეუძლია AI ასისტენტს?

რესტორნის მფლობელებისთვის (ჩვეულებრივი მომხმარებლები)

ბრძანება	აღწერა
`whoami`	ანგარიშის მონაცემების ჩვენება
`my_profile`	თქვენი პროფილის მიღება
`update_my_profile`	პროფილის ველების განახლება
`my_locations`	ყველა ლოკაციის სია
`my_orders`	თქვენი შეკვეთების სია
`my_images`	თქვენი სურათების სია

მომხმარებლის პროფილები

ბრძანება	აღწერა
`get_user_profile`	მომხმარებლის პროფილის მიღება userId-ით
`update_user_profile`	მომხმარებლის პროფილის ველების განახლება
`list_users`	`[ADMIN]` ყველა მომხმარებლის სია
`search_user_by_email`	`[ADMIN]` მომხმარებლის ძიება email-ით Cognito-ში

ლოკაციებთან მუშაობა

ბრძანება	აღწერა
`list_locations`	მომხმარებლის ყველა ლოკაცია
`get_location_profile`	ლოკაციის პროფილი (სახელი, მისამართი, საათები, პარამეტრები)
`update_location_profile`	ლოკაციის პარამეტრების განახლება (CDN-თან ავტომატური სინქრონიზაცია)
`get_location_menu`	ლოკაციის სრული მენიუ კატეგორიებითა და ელემენტებით

მენიუსთან მუშაობა

ბრძანება	აღწერა
`list_menu_items`	მენიუს ყველა ელემენტი (categoryId-ით — სრული მონაცემები, გარეშე — ID წყვილები)
`get_menu_item`	ელემენტის მიღება სრული დეტალებით (თარგმანები, ვარიანტები, დამატებები)
`update_menu_item`	მენიუს ელემენტის განახლება (ფასი, აღწერა, სტატუსი, ტეგები, ვარიანტები)
`create_menu_item`	ახალი მენიუს ელემენტის შექმნა კატეგორიაში
`create_menu_category`	ახალი მენიუს კატეგორიის შექმნა
`update_menu_category`	კატეგორიის განახლება (სახელი, თარგმანები, სტატუსი, სორტირების რიგი)
`move_menu_item`	ელემენტის გადატანა ერთი კატეგორიიდან მეორეში
`merge_categories`	ორი კატეგორიის გაერთიანება (ყველა ელემენტი გადაინაცვლებს, წყარო წაიშლება)
`delete_menu_category`	კატეგორიის წაშლა (`force: true` — ყველა ელემენტთან ერთად)

შეკვეთები

ბრძანება	აღწერა
`list_orders`	შეკვეთების სია (userId-ით ან დომენით)
`get_order`	კონკრეტული შეკვეთის დეტალები

დომენები

ბრძანება	აღწერა
`check_domain_availability`	დომენის ხელმისაწვდომობის შემოწმება
`set_location_domain`	ლოკაციის დომენის სახელის შეცვლა (CDN და მეპინგების განახლება)
`resolve_domain`	userId და locationId-ის გარკვევა დომენით
`list_domains`	`[ADMIN]` ყველა რეგისტრირებული დომენის სია

CDN (გამოქვეყნებული მონაცემები)

ბრძანება	აღწერა
`get_cdn_profile`	გამოქვეყნებული ლოკაციის პროფილი (CDN-ზე)
`get_cdn_menu`	გამოქვეყნებული მენიუ მითითებულ ენაზე
`list_cdn_files`	დომენის ყველა გამოქვეყნებული ფაილი
`invalidate_cdn_cache`	`[ADMIN]` CloudFront CDN-ის ქეშის გაწმენდა

სურათები

ბრძანება	აღწერა
`list_user_images`	მომხმარებლის ყველა სურათი
`get_image_upload_url`	Presigned URL-ის მიღება სურათის S3-ში ასატვირთად (JPEG/PNG/WebP)
`delete_image`	სურათის წაშლა (მომხმარებლები — მხოლოდ საკუთარი)

დაბალი დონის S3 წვდომა

ბრძანება	აღწერა
`s3_read`	ფაილის წაკითხვა S3-დან (მომხმარებლები — მხოლოდ საკუთარი)
`s3_write`	`[ADMIN]` JSON მონაცემების ჩაწერა S3-ში
`s3_list`	ფაილების სია S3-ში (მომხმარებლები — მხოლოდ საკუთარი პრეფიქსი)
`s3_delete`	`[ADMIN]` ობიექტის წაშლა S3-დან

Cognito

ბრძანება	აღწერა
`cognito_list_users`	`[ADMIN]` მომხმარებლების სია Cognito User Pool-დან
`cognito_get_user`	`[ADMIN]` Cognito მომხმარებლის დეტალური ინფორმაცია

სტატისტიკა

ბრძანება	აღწერა
`get_system_stats`	`[ADMIN]` სისტემის საერთო სტატისტიკა

ავთენტიფიკაცია

1. API გასაღები (რეკომენდებული AI ასისტენტებისთვის)

Authorization: Bearer თქვენი_64_სიმბოლოიანი_გასაღები

გასაღები გენერირდება ადმინ-პანელში. მიბმულია თქვენს ანგარიშზე — AI ხედავს მხოლოდ თქვენს მონაცემებს.

2. Cognito JWT ტოკენი

curl -X POST https://api.meni.ge/mcp/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "თქვენი@email.com", "password": "პაროლი"}'

ტოკენი მოქმედებს 1 საათი.

უსაფრთხოება

თითოეული API გასაღები მიბმულია კონკრეტულ ანგარიშზე
ჩვეულებრივი მომხმარებლები ხედავენ მხოლოდ საკუთარ მონაცემებს
გასაღები შეიძლება გაუქმდეს ნებისმიერ დროს
მაქსიმუმ 10 გასაღები ანგარიშზე
ყველა მოთხოვნა HTTPS-ით

API ენდპოინტები

მეთოდი	URL	აღწერა
`GET`	`https://api.meni.ge/mcp`	სერვერის ინფო + ინსტრუმენტების სია
`POST`	`https://api.meni.ge/mcp`	MCP JSON-RPC (ძირითადი პროტოკოლი)
`GET`	`https://api.meni.ge/mcp/health`	ჯანმრთელობის შემოწმება
`POST`	`https://api.meni.ge/mcp/auth/login`	შესვლა → JWT ტოკენები
`GET`	`https://api.meni.ge/mcp/api/keys`	თქვენი API გასაღებების სია
`POST`	`https://api.meni.ge/mcp/api/keys`	ახალი API გასაღების შექმნა
`DELETE`	`https://api.meni.ge/mcp/api/keys/{id}`	API გასაღების გაუქმება