חיבור כלי AI לשרת MCP של meni.ge

הוראות שלב אחר שלב לחיבור עוזרי AI פופולריים לנתוני המסעדה שלכם דרך פרוטוקול MCP.

מה תצטרכו

לפני חיבור כל כלי תצטרכו:

• URL של השרת: https://api.meni.ge/mcp
• מפתח API: שנוצר בפאנל הניהול admin.meni.ge → ⚙️ הגדרות → 🔑 גישה → 🤖 מפתחות MCP API

💡 הוראות מפורטות ליצירת מפתח — במדריך המשתמש של MCP.

---

Claude Desktop

אפליקציית שולחן העבודה Claude מאת Anthropic.

שלב 1. פתחו את Claude Desktop

שלב 2. עברו ל-Settings (⚙️) → Developer → Edit Config

שלב 3. ייפתח קובץ claude_desktop_config.json. הוסיפו:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer המפתח_שלכם"
      }
    }
  }
}

שלב 4. שמרו את הקובץ והפעילו מחדש את Claude Desktop

שלב 5. בצ'אט חדש תופיע סמל 🔨 (כלים) — לחצו וודאו ששרת MCP meni מחובר

📁 מיקום קובץ הקונפיגורציה:

• 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)

עוזר AI טרמינלי מאת Anthropic.

שיטה 1 — באמצעות פקודה (מומלץ):

claude mcp add meni \
  --transport http \
  --url https://api.meni.ge/mcp \
  --header "Authorization: Bearer המפתח_שלכם"

שיטה 2 — קובץ קונפיגורציה:

ערכו את הקובץ ~/.claude/settings.json:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer המפתח_שלכם"
      }
    }
  }
}

בדיקה: הפעילו את claude ושאלו "אילו מיקומים יש לי?" — Claude יקרא ל-my_locations.

---

Cursor

עורך קוד AI עם תמיכה מובנית ב-MCP.

שיטה 1 — דרך הממשק:

1. פתחו את Cursor
2. עברו ל-Settings (Cmd/Ctrl + ,) → MCP
3. לחצו על "+ Add new MCP Server"
4. מלאו:
   • Name: meni
   • Type: HTTP
   • URL: https://api.meni.ge/mcp
5. לחצו על Save
6. פתחו את הקובץ .cursor/mcp.json והוסיפו כותרת הרשאה (ראו למטה)

שיטה 2 — קובץ קונפיגורציה:

צרו קובץ .cursor/mcp.json בשורש הפרויקט:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer המפתח_שלכם"
      }
    }
  }
}

בדיקה: בצ'אט Cursor (מצב Agent) שאלו "הראה לי את המיקומים שלי ב-meni.ge" — Cursor יתחבר לשרת.

💡 Cursor תומך ב-MCP במצב Agent. ודאו שנבחר מצב Agent ולא Ask.

---

VS Code (GitHub Copilot)

הרחבת GitHub Copilot ל-VS Code תומכת בשרתי MCP.

שיטה 1 — קובץ פרויקט (מומלץ):

צרו קובץ .vscode/mcp.json בשורש הפרויקט שלכם:

{
  "servers": {
    "meni": {
      "type": "http",
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer המפתח_שלכם"
      }
    }
  }
}

שיטה 2 — הגדרות גלובליות:

פתחו Settings (Cmd/Ctrl + ,) → חפשו mcp → פתחו settings.json והוסיפו:

{
  "mcp": {
    "servers": {
      "meni": {
        "type": "http",
        "url": "https://api.meni.ge/mcp",
        "headers": {
          "Authorization": "Bearer המפתח_שלכם"
        }
      }
    }
  }
}

בדיקה: פתחו את Copilot Chat (Ctrl+Alt+I), בחרו במצב Agent ושאלו: "אילו מיקומים יש לי ב-meni.ge?"

💡 שרתי MCP פועלים רק במצב Agent (לא ב-Edits ולא ב-Ask).

---

Windsurf

עורך AI מאת Codeium עם תמיכה ב-MCP.

שלב 1. פתחו את Windsurf

שלב 2. לחצו על סמל 🔨 (פטיש) בפאנל Cascade, ואז Configure

או עברו ל: Settings → Cascade → MCP Servers

שלב 3. ייפתח קובץ mcp_config.json. הוסיפו:

{
  "mcpServers": {
    "meni": {
      "serverUrl": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer המפתח_שלכם"
      }
    }
  }
}

שלב 4. שמרו והפעילו מחדש את Windsurf

בדיקה: בצ'אט Cascade הסמל 🔨 יציג את כלי ה-MCP הזמינים.

📁 מיקום הקובץ: ~/.codeium/windsurf/mcp_config.json

---

Cline (הרחבת VS Code)

סוכן AI עצמאי ל-VS Code.

שלב 1. פתחו את Cline ב-VS Code (פאנל צדדי)

שלב 2. לחצו על MCP Servers (סמל 🔌) בחלק העליון של פאנל Cline

שלב 3. לחצו על "Remote Servers", ואז "Add Remote MCP Server"

שלב 4. מלאו:

• Server URL: https://api.meni.ge/mcp
• Name: meni
• Headers (בפורמט JSON):

{
  "Authorization": "Bearer המפתח_שלכם"
}

שלב 5. לחצו על Save

או ערכו את הקובץ cline_mcp_settings.json ישירות:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer המפתח_שלכם"
      }
    }
  }
}

בדיקה: אינדיקטור ירוק ליד השרת מציין חיבור מוצלח.

---

Continue (VS Code / JetBrains)

עוזר AI בקוד פתוח ל-VS Code ו-JetBrains IDE.

שלב 1. פתחו את הגדרות Continue: לחצו על ⚙️ בפאנל Continue

שלב 2. עברו ללשונית MCP

שלב 3. לחצו על "Add MCP Server" ובחרו בסוג Streamable HTTP

שלב 4. או ערכו את הקובץ ~/.continue/config.yaml:

mcpServers:
  - name: meni
    url: https://api.meni.ge/mcp
    headers:
      Authorization: "Bearer המפתח_שלכם"

בדיקה: בצ'אט Continue שאלו "הראה לי את המיקומים שלי" — Continue יקרא לכלי MCP.

---

ChatGPT (Connectors)

OpenAI ChatGPT תומך בחיבור שרתי MCP חיצוניים דרך Connectors.

שלב 1. פתחו את chatgpt.com

שלב 2. עברו ל-Settings → Connectors → Add Connector

שלב 3. בחרו בסוג MCP

שלב 4. מלאו:

• URL: https://api.meni.ge/mcp
• Authentication: Bearer Token
• Token: המפתח_שלכם

שלב 5. לחצו על Save

בדיקה: בצ'אט חדש של ChatGPT שאלו "אילו מיקומים יש לי ב-meni.ge?" — ChatGPT ישתמש בכלי MCP.

⚠️ Connectors זמינים למנויי ChatGPT Plus / Team / Enterprise.

---

פתרון בעיות

בדקו את המפתח

ודאו שמפתח ה-API עובד לפני הגדרת כל כלי:

curl https://api.meni.ge/mcp/health \
  -H "Authorization: Bearer המפתח_שלכם"

תשובה מוצלחת: {"status":"ok"}

בעיות נפוצות

בעיה	פתרון
סירוב חיבור	בדקו את ה-URL: https://api.meni.ge/mcp
401 Unauthorized	בדקו את מפתח ה-API — ייתכן שהוא בוטל או הוזן בצורה שגויה
כלים לא מוצגים	הפעילו מחדש את כלי ה-AI לאחר שמירת הקונפיג
המפתח לא עובד	ודאו שהפורמט: Bearer <מפתח> (עם רווח אחרי Bearer)
המפתח אבד	בטלו אותו בפאנל הניהול וצרו חדש

טיפים כלליים

• העתיקו את מפתח ה-API ללא רווחים וסימנים מיותרים
• פורמט הכותרת תמיד: Authorization: Bearer המפתח_שלכם
• בדקו את מצב המפתח ב-admin.meni.ge → הגדרות → גישה
• ניתן ליצור עד 10 מפתחות — אחד לכל כלי
• מפתחות שבוטלו מפסיקים לעבוד מיידית