MCP Server — Udhëzuesi i përdoruesit

Çfarë është?

Serveri MCP (Model Context Protocol) për menugo.al ju lejon të lidhni asistentët AI (Claude, ChatGPT, Cursor, VS Code Copilot etj.) me të dhënat e restorantit tuaj. AI merr akses në menu, lokacione, porosi, imazhe dhe mund t'i menaxhojë ato në emrin tuaj.

Fillimi i shpejtë

1. Merrni çelësin API

Çelësi API gjenerohet në panelin e administrimit të restorantit tuaj.

Hap pas hapi:

1. Hyni në Panelin e administrimit në adresën admin.menugo.al
2. Në menunë anësore hapni ⚙️ Cilësimet → 🔑 Aksesi
3. Në faqe gjeni seksionin 🤖 Çelësat API MCP
4. Klikoni butonin "Gjenero çelës të ri"
5. Vendosni emrin e çelësit (për shembull, "Claude Desktop", "Cursor", "GPT-ja ime") — kjo do t'ju ndihmojë të dalloni çelësat nga njëri-tjetri
6. Kopjoni çelësin menjëherë — ai shfaqet vetëm një herë!

💡 Në të njëjtën faqe shfaqet URL-ja e serverit (https://api.menugo.al/mcp), e cila gjithashtu mund të kopjohet me një klikim.

Menaxhimi i çelësave

• Mund të krijoni deri në 10 çelësa për llogari
• Çdo çelës mund të revokohet në çdo moment — butoni "Revoko" pranë çelësit
• Pas revokimit, çelësi ndalon së funksionuari menjëherë
• Nëse çelësi humbet — revokojeni atë dhe krijoni një të ri

2. Lidhni asistentin AI

Claude Desktop / Claude Code

Skedari i konfigurimit claude_desktop_config.json:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.menugo.al/mcp",
      "headers": {
        "Authorization": "Bearer ÇELËSI_JUAJ_API"
      }
    }
  }
}

Cursor

Në cilësimet e Cursor → MCP Servers → Add, ose skedari .cursor/mcp.json:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.menugo.al/mcp",
      "headers": {
        "Authorization": "Bearer ÇELËSI_JUAJ_API"
      }
    }
  }
}

VS Code (GitHub Copilot)

Në .vscode/mcp.json të projektit:

{
  "servers": {
    "meni": {
      "type": "http",
      "url": "https://api.menugo.al/mcp",
      "headers": {
        "Authorization": "Bearer ÇELËSI_JUAJ_API"
      }
    }
  }
}

Mjete të tjera AI

Udhëzime të detajuara hap pas hapi për Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Continue, ChatGPT dhe të tjerë — në një udhëzues të veçantë:

👉 Lidhja e mjeteve AI me MCP

Çfarë mund të bëjë asistenti AI?

Për pronarët e restoranteve (përdoruesit e thjeshtë)

Profilet e përdoruesve

Puna me lokacionet

Puna me menunë

Porositë

Domenet

CDN (të dhënat e publikuara)

Imazhet

Aksesi i nivelit të ulët në S3

Cognito

Statistikat

Autentikimi

Serveri mbështet tri mënyra autorizimi:

1. Çelësi API (rekomandohet për asistentët AI)

Authorization: Bearer ваш_64_символьный_ключ

Çelësi gjenerohet në panelin e administrimit. Është i lidhur me llogarinë tuaj — AI sheh vetëm të dhënat tuaja.

2. Tokeni Cognito JWT

Për integrim programor, mund të merrni një token përmes hyrjes (login):

# Получить токен
curl -X POST https://api.menugo.al/mcp/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "ваш@email.com", "password": "ваш_пароль"}'

# Ответ содержит idToken — используйте его:
Authorization: Bearer eyJraWQ...

Tokeni është i vlefshëm për 1 orë, pas së cilës kërkohet hyrje e sërishme.

3. Admin API Key (vetëm për administratorët)

Authorization: Bearer admin_key

Çelësi i administratorit jep qasje të plotë në të gjitha të dhënat e të gjithë përdoruesve.

Siguria

• Çdo çelës API është i lidhur me një llogari specifike
• Përdoruesit e thjeshtë shohin vetëm të dhënat e tyre
• Çelësi mund të revokohet në çdo moment në panelin e administrimit
• Maksimumi 10 çelësa për llogari
• Të gjitha kërkesat kalojnë përmes HTTPS
• Komandat me shënimin [ADMIN] nuk janë të disponueshme për përdoruesit e thjeshtë

Shembuj përdorimi

Kërko nga AI të përditësojë çmimin e pjatës

«Përditëso çmimin e artikullit «Khachapuri» në menunë time — bëje 15 lari në vend të 12»

AI do të thërrasë my_locations → get_location_menu → update_menu_item.

Shto një artikull të ri në menu

«Shto në kategorinë «Ëmbëlsira» pjatën e re «Churchkhela» për 8 lari»

AI do të thërrasë my_locations → get_location_menu → create_menu_item.

Krijo një kategori të re

«Krijo kategorinë «Pije» me përkthime në gjeorgjisht dhe anglisht»

AI do të thërrasë create_menu_category me nameTranslations.

Zhvendos pjatën midis kategorive

«Zhvendos «Limonadë» nga «Pije të ftohta» te «Pije joalkoolike»»

AI do të thërrasë move_menu_item duke specifikuar kategorinë e origjinës dhe atë të destinacionit.

Shiko porositë për sot

«Tregomë porositë e mia për sot»

AI do të thërrasë my_orders dhe do t'i filtrojë sipas datës.

Kontrollo menunë e publikuar

«Si duket menuja ime në gjuhën ruse për vizitorët?»

AI do të thërrasë resolve_domain → get_cdn_menu me gjuhën ru.

Ndrysho domenin e restorantit

«Kontrollo nëse domeni my-restaurant është i disponueshëm, dhe nëse po — vendose atë»

AI do të thërrasë check_domain_availability → set_location_domain.

Ngarko foto për pjatën

«Më jep një link për të ngarkuar foton për pjatën X»

AI do të thërrasë get_image_upload_url dhe do të kthejë një presigned URL për ngarkim.

Endpoint-et e API

Menaxhimi i çelësave

Shikimi i çelësave

Në panelin e administrimit → Cilësimet → Aksesi → Çelësat MCP API. Ose përmes API:

curl https://api.menugo.al/mcp/api/keys \
  -H "Authorization: Bearer COGNITO_JWT_TOKEN"

Krijimi i një çelësi

curl -X POST https://api.menugo.al/mcp/api/keys \
  -H "Authorization: Bearer COGNITO_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Claude Desktop"}'

Përgjigjja përmban fushën key — ky është çelësi juaj. Ruajeni atë!

Revokimi i çelësit

curl -X DELETE https://api.menugo.al/mcp/api/keys/mk_abc123 \
  -H "Authorization: Bearer COGNITO_JWT_TOKEN"

⚠️ Krijimi dhe revokimi i çelësave kërkon një token Cognito JWT (jo çelës API). Përdorni panelin e administrimit — është më e thjeshtë.

Zgjidhja e problemeve