Kết nối

Máy chủ MCP nói giao thức streamable HTTP ở:

https://mcp.webmati.com/mcp

Đăng nhập bằng API key

Máy chủ nhận một API key của workspace trong header Authorization: Bearer wmk_….

1. Trong trang quản trị, mở một website ▸ Cài đặt ▸ API Keys ▸ tạo key. Chọn quyền cho key: quyền nào thiếu thì tool tương ứng bị từ chối (key toàn quyền làm được mọi việc).
2. Chép key ngay (key bắt đầu bằng wmk_ và chỉ hiện một lần). Giữ nó như mật khẩu: đừng dán vào chat hay commit vào git.
3. Nếu workspace có nhiều website, thêm header X-Store-Slug: <slug> (hoặc X-Store-Id: <id>) để chọn website cho phiên làm việc. Workspace chỉ có một website thì không cần.

Ví dụ dưới đây dùng wmk_… cho key và my-shop cho slug website: thay bằng của bạn.

Claude Code

claude mcp add --transport http shop https://mcp.webmati.com/mcp \
  --header "Authorization: Bearer wmk_…" \
  --header "X-Store-Slug: my-shop"

Thêm --scope user để dùng ở mọi project, --scope project để ghi vào .mcp.json dùng chung với nhóm.

Cursor

~/.cursor/mcp.json (mọi project) hoặc .cursor/mcp.json (một project):

{
  "mcpServers": {
    "shop": {
      "url": "https://mcp.webmati.com/mcp",
      "headers": {
        "Authorization": "Bearer wmk_…",
        "X-Store-Slug": "my-shop"
      }
    }
  }
}

Codex

~/.codex/config.toml:

[mcp_servers.shop]
url = "https://mcp.webmati.com/mcp"
bearer_token_env_var = "SHOP_MCP_KEY"
http_headers = { "X-Store-Slug" = "my-shop" }

Đặt key vào biến môi trường trước khi chạy Codex:

export SHOP_MCP_KEY=wmk_…

Claude Desktop và claude.ai

Connector của claude.ai (và mục Connectors trong Claude Desktop) chỉ đăng nhập bằng OAuth, không gửi được API key. Với Claude Desktop, nối qua mcp-remote trong file cấu hình (cần Node.js):

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

{
  "mcpServers": {
    "shop": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://mcp.webmati.com/mcp",
        "--header", "Authorization:${SHOP_AUTH}",
        "--header", "X-Store-Slug:my-shop"
      ],
      "env": { "SHOP_AUTH": "Bearer wmk_…" }
    }
  }
}

Khởi động lại Claude Desktop sau khi lưu.

Kiểm tra

Hỏi AI: "gọi get_context". Nó trả về website, theme đang sửa và việc website có bán hàng hay không. Thấy đúng website là xong.

Khi máy chủ có tool hay kỹ năng mới, kết nối lại trong client để thấy chúng: client giữ danh sách tool theo từng phiên.

Tiếp theo

• Tool và kỹ năng
• An toàn: cái gì ghi, cái gì hỏi trước