Kết nối công cụ AI với máy chủ MCP của meni.ge

Hướng dẫn từng bước để kết nối các trợ lý AI phổ biến với dữ liệu nhà hàng của bạn thông qua giao thức MCP.

Cần chuẩn bị

Trước khi kết nối bất kỳ công cụ nào, bạn cần:

URL máy chủ: https://api.meni.ge/mcp
API key: được tạo trong bảng điều khiển quản trị admin.meni.ge → ⚙️ Cài đặt → 🔑 Truy cập → 🤖 MCP API Keys

💡 Hướng dẫn chi tiết về cách tạo key — trong Hướng dẫn sử dụng MCP.

Claude Desktop

Ứng dụng máy tính để bàn Claude từ Anthropic.

Bước 1. Mở Claude Desktop

Bước 2. Đi tới Settings (⚙️) → Developer → Edit Config

Bước 3. Tệp claude_desktop_config.json sẽ mở ra. Thêm vào:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer API_KEY_CỦA_BẠN"
      }
    }
  }
}

Bước 4. Lưu tệp và khởi động lại Claude Desktop

Bước 5. Trong cuộc trò chuyện mới, biểu tượng 🔨 (công cụ) sẽ xuất hiện ở dưới cùng — nhấp vào và đảm bảo rằng máy chủ MCP meni đã được kết nối

📁 Vị trí tệp cấu hình:

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)

Trợ lý AI dòng lệnh từ Anthropic.

Cách 1 — Bằng lệnh (khuyến nghị):

claude mcp add meni \
  --transport http \
  --url https://api.meni.ge/mcp \
  --header "Authorization: Bearer API_KEY_CỦA_BẠN"

Cách 2 — Tệp cấu hình:

Chỉnh sửa tệp ~/.claude/settings.json:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer API_KEY_CỦA_BẠN"
      }
    }
  }
}

Kiểm tra: Chạy claude và hỏi “Tôi có những địa điểm nào?” — Claude sẽ gọi my_locations.

Cursor

Trình chỉnh sửa mã AI với hỗ trợ MCP tích hợp.

Cách 1 — Qua giao diện:

Mở Cursor
Đi tới Settings (Cmd/Ctrl + ,) → MCP
Nhấn "+ Add new MCP Server"
Điền vào:
- Name: meni
- Type: HTTP
- URL: https://api.meni.ge/mcp
Nhấn Save
Mở tệp .cursor/mcp.json và thêm tiêu đề ủy quyền (xem bên dưới)

Cách 2 — Tệp cấu hình:

Tạo tệp .cursor/mcp.json trong thư mục gốc của dự án:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer API_KEY_CỦA_BẠN"
      }
    }
  }
}

Kiểm tra: Trong cuộc trò chuyện Cursor (Agent mode), hỏi “Hiển thị các địa điểm của tôi trên meni.ge” — Cursor sẽ kết nối với máy chủ.

💡 Cursor hỗ trợ MCP trong chế độ Agent. Đảm bảo rằng chế độ Agent được chọn, không phải Ask.

VS Code (GitHub Copilot)

Tiện ích mở rộng GitHub Copilot cho VS Code hỗ trợ các máy chủ MCP.

Cách 1 — Tệp dự án (khuyến nghị):

Tạo tệp .vscode/mcp.json trong thư mục gốc của dự án của bạn:

{
  "servers": {
    "meni": {
      "type": "http",
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer API_KEY_CỦA_BẠN"
      }
    }
  }
}

Cách 2 — Cài đặt toàn cầu:

Mở Settings (Cmd/Ctrl + ,) → tìm mcp → mở settings.json và thêm vào:

{
  "mcp": {
    "servers": {
      "meni": {
        "type": "http",
        "url": "https://api.meni.ge/mcp",
        "headers": {
          "Authorization": "Bearer API_KEY_CỦA_BẠN"
        }
      }
    }
  }
}

Kiểm tra: Mở Copilot Chat (Ctrl+Alt+I), chọn chế độ Agent và hỏi: “Tôi có những địa điểm nào trên meni.ge?”

💡 Các máy chủ MCP chỉ hoạt động trong chế độ Agent (không trong Edits và không trong Ask).

Windsurf

Trình chỉnh sửa AI từ Codeium với hỗ trợ MCP.

Bước 1. Mở Windsurf

Bước 2. Nhấn vào biểu tượng 🔨 (búa) trên bảng Cascade, sau đó Configure

Hoặc đi tới: Settings → Cascade → MCP Servers

Bước 3. Tệp mcp_config.json sẽ mở ra. Thêm vào:

{
  "mcpServers": {
    "meni": {
      "serverUrl": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer API_KEY_CỦA_BẠN"
      }
    }
  }
}

Bước 4. Lưu và khởi động lại Windsurf

Kiểm tra: Trong cuộc trò chuyện Cascade, biểu tượng 🔨 sẽ hiển thị các công cụ MCP có sẵn.

📁 Vị trí tệp: ~/.codeium/windsurf/mcp_config.json

Cline (tiện ích mở rộng VS Code)

AI-agent độc lập cho VS Code.

Bước 1. Mở Cline trong VS Code (bảng bên)

Bước 2. Nhấn MCP Servers (biểu tượng 🔌) ở phần trên của bảng Cline

Bước 3. Nhấn "Remote Servers", sau đó "Add Remote MCP Server"

Bước 4. Điền vào:

Server URL: https://api.meni.ge/mcp
Name: meni
Headers (dưới dạng JSON):

{
  "Authorization": "Bearer API_KEY_CỦA_BẠN"
}

Bước 5. Nhấn Save

Hoặc chỉnh sửa tệp cline_mcp_settings.json trực tiếp:

{
  "mcpServers": {
    "meni": {
      "url": "https://api.meni.ge/mcp",
      "headers": {
        "Authorization": "Bearer API_KEY_CỦA_BẠN"
      }
    }
  }
}

Kiểm tra: Đèn báo màu xanh lá cây bên cạnh máy chủ có nghĩa là kết nối thành công.

Continue (VS Code / JetBrains)

Trợ lý AI mã nguồn mở cho VS Code và JetBrains IDE.

Bước 1. Mở cài đặt Continue: nhấn ⚙️ trên bảng Continue

Bước 2. Chuyển sang tab MCP

Bước 3. Nhấn "Add MCP Server" và chọn loại Streamable HTTP

Bước 4. Hoặc chỉnh sửa tệp ~/.continue/config.yaml:

mcpServers:
  - name: meni
    url: https://api.meni.ge/mcp
    headers:
      Authorization: "Bearer API_KEY_CỦA_BẠN"

Kiểm tra: Trong cuộc trò chuyện Continue, hỏi “Hiển thị các địa điểm của tôi” — Continue sẽ gọi các công cụ MCP.

ChatGPT (Connectors)

OpenAI ChatGPT hỗ trợ kết nối các máy chủ MCP bên ngoài thông qua Connectors.

Bước 1. Mở chatgpt.com

Bước 2. Đi tới Settings → Connectors → Add Connector

Bước 3. Chọn loại MCP

Bước 4. Điền vào:

URL: https://api.meni.ge/mcp
Authentication: Bearer Token
Token: API_KEY_CỦA_BẠN

Bước 5. Nhấn Save

Kiểm tra: Trong cuộc trò chuyện mới của ChatGPT, hỏi “Tôi có những địa điểm nào trên meni.ge?” — ChatGPT sẽ sử dụng các công cụ MCP.

⚠️ Connectors có sẵn cho người đăng ký ChatGPT Plus / Team / Enterprise.

Khắc phục sự cố

Kiểm tra key

Đảm bảo rằng API key hoạt động trước khi cấu hình bất kỳ công cụ nào:

curl https://api.meni.ge/mcp/health \
  -H "Authorization: Bearer API_KEY_CỦA_BẠN"

Phản hồi thành công: {"status":"ok"}

Các vấn đề thường gặp

Vấn đề	Giải pháp
Từ chối kết nối	Kiểm tra URL: `https://api.meni.ge/mcp`
`401 Unauthorized`	Kiểm tra API key — có thể đã bị thu hồi hoặc nhập sai
Công cụ không hiển thị	Khởi động lại công cụ AI sau khi lưu cấu hình
Key không hoạt động	Đảm bảo định dạng: `Bearer <key>` (có khoảng trắng sau Bearer)
Key bị mất	Thu hồi trong bảng điều khiển quản trị và tạo mới

Lời khuyên chung

Sao chép API key không có khoảng trắng và ký tự thừa
Định dạng tiêu đề luôn là: Authorization: Bearer key_của_bạn
Kiểm tra trạng thái key tại admin.meni.ge → Cài đặt → Truy cập
Có thể tạo tối đa 10 key — mỗi key cho một công cụ
Key bị thu hồi sẽ ngừng hoạt động ngay lập tức