Lidhja e mjeteve AI me serverin MCP të menugo.al

Udhëzime hap pas hapi për lidhjen e asistentëve popullorë AI me të dhënat e restorantit tuaj përmes protokollit MCP.

Çfarë ju nevojitet

Përpara lidhjes së çdo instrumenti, ju nevojiten:

• URL e serverit: https://api.menugo.al/mcp
• Çelësi API: i gjeneruar në panelin e administrimit admin.menugo.al → ⚙️ Cilësimet → 🔑 Aksesi → 🤖 Çelësat API të MCP

💡 Udhëzimet e detajuara për gjenerimin e çelësit — te Udhëzuesi i Përdoruesit të MCP.

Claude Desktop

Aplikacioni për desktop Claude nga Anthropic.

Hapi 1. Hapni Claude Desktop

Hapi 2. Shkoni te Settings (⚙️) → Developer → Edit Config

Hapi 3. Do të hapet skedari claude_desktop_config.json. Shtoni:

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

Hapi 4. Ruani skedarin dhe rinisni Claude Desktop

Hapi 5. Në fund të një bisede të re do të shfaqet ikona 🔨 (vegla) — klikoni mbi të dhe sigurohuni që serveri MCP meni është i lidhur

📁 Vendndodhja e skedarit të konfigurimit:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Claude Code (CLI)

Asistent AI terminali nga Anthropic.

Metoda 1 — Me komandë (e rekomanduar):

claude mcp add meni \
  --transport http \
  --url https://api.menugo.al/mcp \
  --header "Authorization: Bearer CHELËSI_JUAJ_API"

Metoda 2 — Skedari i konfigurimit:

Redaktoni skedarin ~/.claude/settings.json:

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

Verifikimi: Ekzekutoni claude dhe pyesni «Cilat janë vendndodhjet e mia?» — Claude do të thërrasë my_locations.

Cursor

Redaktues kodi me AI me mbështetje të integruar për MCP.

Metoda 1 — Përmes ndërfaqes:

1. Hapni Cursor
2. Shkoni te Settings (Cmd/Ctrl + ,) → MCP
3. Klikoni "+ Add new MCP Server"
4. Plotësoni:
   • Name: meni
   • Type: HTTP
   • URL: https://api.menugo.al/mcp
5. Klikoni Save
6. Hapni skedarin .cursor/mcp.json dhe shtoni kokën e autorizimit (shih më poshtë)

Metoda 2 — Skedari i konfigurimit:

Krijoni skedarin .cursor/mcp.json në rrënjën e projektit:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.menugo.al/mcp",
      "headers": {
        "Authorization": "Bearer CHELËSI_API_JUAJ"
      }
    }
  }
}

Verifikimi: Në bisedën e Cursor (Agent mode) pyesni «Tregomë lokacionet e mia në menugo.al» — Cursor do të lidhet me serverin.

💡 Cursor mbështet MCP në modalitetin Agent. Sigurohuni që është zgjedhur modaliteti Agent dhe jo Ask.

VS Code (GitHub Copilot)

Zgjerimi GitHub Copilot për VS Code mbështet serverat MCP.

Metoda 1 — Skedari i projektit (rekomandohet):

Krijoni një skedar .vscode/mcp.json në rrënjën e projektit tuaj:

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

Metoda 2 — Cilësimet globale:

Hapni Settings (Cmd/Ctrl + ,) → kërkoni mcp → hapni settings.json dhe shtoni:

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

Verifikimi: Hapni Copilot Chat (Ctrl+Alt+I), zgjidhni regjimin Agent dhe pyesni: "Cilat janë lokacionet e mia në menugo.al?"

💡 Serverat MCP funksionojnë vetëm në regjimin Agent (jo në Edits dhe jo në Ask).

Windsurf

Redaktori AI nga Codeium me mbështetje për MCP.

Hapi 1. Hapni Windsurf

Hapi 2. Klikoni mbi ikonën 🔨 (hammer) në panelin Cascade, pastaj Configure

Ose shkoni te: Settings → Cascade → MCP Servers

Hapi 3. Do të hapet skedari mcp_config.json. Shtoni:

{
  "mcpServers": {
    "meni": {
      "serverUrl": "https://api.menugo.al/mcp",
      "headers": {
        "Authorization": "Bearer API_KEY_I_JUAJ"
      }
    }
  }
}

Hapi 4. Ruajeni dhe rinisni Windsurf

Verifikimi: Në bisedën Cascade ikona 🔨 do të tregojë mjetet MCP të disponueshme.

📁 Vendndodhja e skedarit: ~/.codeium/windsurf/mcp_config.json

Cline (shtesë për VS Code)

Agjent autonom AI për VS Code.

Hapi 1. Hapni Cline në VS Code (paneli anësor)

Hapi 2. Klikoni MCP Servers (ikona 🔌) në pjesën e sipërme të panelit Cline

Hapi 3. Klikoni "Remote Servers", pastaj "Add Remote MCP Server"

Hapi 4. Plotësoni:

• Server URL: https://api.menugo.al/mcp
• Name: meni
• Headers (në formatin JSON):

{
  "Authorization": "Bearer CHELËSI_API_I_JUAJ"
}

Hapi 5. Klikoni Save

Ose redaktoni skedarin cline_mcp_settings.json drejtpërdrejt:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.menugo.al/mcp",
      "headers": {
        "Authorization": "Bearer CHELËSI_API_I_JUAJ"
      }
    }
  }
}

Verifikimi: Indikatori i gjelbër pranë serverit tregon lidhjen e suksesshme.

Continue (VS Code / JetBrains)

Asistent AI me burim të hapur për VS Code dhe JetBrains IDE.

Hapi 1. Hapni cilësimet e Continue: klikoni ⚙️ në panelin e Continue

Hapi 2. Kaloni te skeda MCP

Hapi 3. Klikoni "Add MCP Server" dhe zgjidhni llojin Streamable HTTP

Hapi 4. Ose modifikoni skedarin ~/.continue/config.yaml:

mcpServers:
  - name: meni
    url: https://api.menugo.al/mcp
    headers:
      Authorization: "Bearer CHELËSI_JUAJ_API"

Verifikimi: Në bisedën e Continue pyesni «Tregomë lokacionet e mia» — Continue do të thërrasë mjetet MCP.

ChatGPT (Connectors)

OpenAI ChatGPT mbështet lidhjen e serverëve të jashtëm MCP përmes Connectors.

Hapi 1. Hapni chatgpt.com

Hapi 2. Shkoni te Settings → Connectors → Add Connector

Hapi 3. Zgjidhni llojin MCP

Hapi 4. Plotësoni:

• URL: https://api.menugo.al/mcp
• Authentication: Bearer Token
• Token: ÇELËSI_JUAJ_API

Hapi 5. Klikoni Save

Verifikimi: Në një bisedë të re në ChatGPT pyesni «Cilat janë lokacionet e mia në menugo.al?» — ChatGPT do të përdorë mjetet MCP.

⚠️ Connectors janë të disponueshme për abonentët e ChatGPT Plus / Team / Enterprise.

Zgjidhja e problemeve

Verifikoni çelësin

Sigurohuni që çelësi API funksionon përpara se të konfiguroni ndonjë instrument:

curl https://api.menugo.al/mcp/health \
  -H "Authorization: Bearer ÇELËSI_JUAJ_API"

Përgjigjja e suksesshme: {"status":"ok"}

Problemet e shpeshta

Këshilla të përgjithshme

• Kopjoni çelësin API pa hapësira dhe karaktere të tepërta
• Formati i kokës është gjithmonë: Authorization: Bearer çelësi_juaj
• Verifikoni statusin e çelësit në admin.menugo.al → Cilësimet → Aksesi
• Mund të krijoni deri në 10 çelësa — nga një për çdo instrument
• Çelësat e revokuar ndalojnë së funksionuari menjëherë