Volio Store MCP — Hướng dẫn kết nối

Bắt đầu

MCP Server này làm gì?

Cho phép AI (Cursor, Claude) tương tác trực tiếp với Volio Store — đăng nhập, quản lý apps, categories, items và đồng bộ dữ liệu.

🔗

Kết nối HTTP

Chỉ cần thêm URL vào config — không cần cài đặt gì trên máy.

🛍️

Quản lý Store

Xem apps, categories, items, tạo mới và đồng bộ dữ liệu qua AI.

🔐

OAuth Xác thực

Đăng nhập qua browser — mỗi người có token riêng, không bị lẫn.

Cursor IDE

Kết nối với Cursor

Thêm URL vào file cấu hình MCP của Cursor — chỉ mất 30 giây.

1

Thêm cấu hình MCP

Tạo file .cursor/mcp.json trong project (hoặc ~/.cursor/mcp.json cho global), thêm:

{
  "mcpServers": {
    "volio-store": {
      "url": "https://volio-store-mcp.route.volio.vn/mcp"
    }
  }
}

💡

Chỉ cần URL, không cần thêm headers hay token. OAuth sẽ tự xử lý.

2

Đăng nhập

Mở Cursor Settings → MCP → bấm nút Connect bên cạnh volio-store.

Trình duyệt sẽ mở trang đăng nhập CMS. Đăng nhập bằng tài khoản Volio của bạn.

🔐

Mỗi người đăng nhập bằng tài khoản riêng — token không bị lẫn giữa các máy.

3

Sử dụng

Sau khi đăng nhập, server hiện trạng thái xanh. Trong chat, thử:

"Dùng tool volio_store_list_apps để xem danh sách apps"

Claude Desktop

Kết nối với Claude Desktop

Thêm URL vào file config của Claude Desktop, sau đó khởi động lại app.

1

Mở file cấu hình

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Nếu file chưa tồn tại, tạo mới.

2

Thêm cấu hình

{
  "mcpServers": {
    "volio-store": {
      "url": "https://volio-store-mcp.route.volio.vn/mcp"
    }
  }
}

3

Đăng nhập và sử dụng

Tắt và mở lại Claude Desktop. Khi sử dụng tool lần đầu, Claude sẽ mở browser để bạn đăng nhập CMS.

Kiểm tra: trong chat, hỏi "Bạn có tool nào từ volio-store?"

Tham khảo

Danh sách Tools

Các tool có sẵn khi kết nối — AI sẽ tự gọi khi cần.

Xem & Truy vấn

Tool	Mô tả
`volio_store_status`	Kiểm tra trạng thái cấu hình Volio Store
`volio_store_list_apps`	Liệt kê tất cả apps có cấu hình Volio Store
`volio_store_list_categories`	Lấy danh sách categories của một app
`volio_store_list_items`	Lấy danh sách items trong một category
`volio_store_item_detail`	Lấy thông tin chi tiết + custom fields của item
`volio_store_sync`	Đồng bộ dữ liệu từ Volio Store API về DB cache

Tạo & Cập nhật

Tool	Mô tả
`volio_store_create_item`	Tạo item mới (kèm thumbnail, number, level)
`volio_store_update_item`	Cập nhật item (name, status, priority, custom fields)
`volio_store_create_category`	Tạo category mới (hỗ trợ sub-category)
`volio_store_update_category`	Cập nhật category (name, status, priority)

Upload

Tool	Mô tả
`volio_store_upload_photo`	Upload ảnh → Volio S3, cập nhật photo/thumbnail + custom fields (number, level)
`volio_store_upload_file`	Upload file local lên Volio S3 (file_path / base64 / URL → multipart), tự gán CDN URL vào custom field