Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.sellfern.com/llms.txt

Use this file to discover all available pages before exploring further.

Sellfern cung cấp một máy chủ Model Context Protocol (MCP) phơi bày dữ liệu đơn hàng, phân tích và hoàn tất đơn của bạn dưới dạng công cụ nguyên bản cho các trợ lý AI. Sau khi kết nối, Claude Desktop có thể liệt kê đơn hàng, lấy tóm tắt lợi nhuận, cập nhật trạng thái và gán nhà cung cấp — tất cả từ một cuộc trò chuyện bằng ngôn ngữ tự nhiên, không cần mã tùy chỉnh từ phía bạn.

​
Điều kiện tiên quyết

  • Node.js 18 hoặc mới hơn được cài đặt trên máy chạy máy chủ MCP
  • Một token API Sellfern với các phạm vi yêu cầu bởi các công cụ bạn muốn sử dụng (xem bước tạo token bên dưới)
  • Claude Desktop, Cursor, OpenCode hoặc một client tương thích MCP khác

​
Thiết lập

1

Build máy chủ MCP

Từ thư mục gốc của dự án Sellfern, build máy chủ MCP:
cd mcp-server
npm install
npm run build
Điều này tạo ra mcp-server/build/index.js, điểm vào bạn sẽ tham chiếu trong tệp cấu hình.
2

Tìm vị trí tệp cấu hình của client

Đường dẫn tệp cấu hình phụ thuộc vào hệ điều hành của bạn:
HĐHĐường dẫn
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json
Tạo tệp nếu nó chưa tồn tại.
3

Thêm cấu hình máy chủ MCP Sellfern

Dán nội dung sau vào claude_desktop_config.json, hợp nhất với bất kỳ khóa mcpServers hiện có nào nếu tệp đã có nội dung:
{
  "mcpServers": {
    "sellfern": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/build/index.js"],
      "env": {
        "SELLFERN_API_URL": "https://api.sellfern.com",
        "SELLFERN_API_TOKEN": "sk_live_YOUR_TOKEN_HERE"
      }
    }
  }
}
Thay thế /absolute/path/to/ bằng đường dẫn thực tới repo đã clone trên máy của bạn.
TrườngMô tả
commandRuntime để dùng — node cho máy chủ MCP JS
argsĐường dẫn tuyệt đối đến điểm vào đã biên dịch
env.SELLFERN_API_URLURL cơ sở cho REST API Sellfern; dùng http://localhost:3000 cho phát triển cục bộ
env.SELLFERN_API_TOKENBearer token của bạn — phải bắt đầu bằng sk_live_
4

Tạo token API trong Sellfern

Trong Sellfern, vào Settings → API Tokens và tạo một token mới. Chọn các phạm vi mà agent của bạn cần:
  • orders:read — đọc dữ liệu đơn hàng
  • orders:write — cập nhật trường đơn hàng
  • orders:status:write — thay đổi trạng thái đơn hàng
  • analytics:read — truy cập tóm tắt doanh thu và lợi nhuận
  • fulfillment:read — xem hàng đợi hoàn tất đơn
  • fulfillment:write — gán nhà cung cấp
Sao chép giá trị sk_live_... và dán nó làm SELLFERN_API_TOKEN trong tệp cấu hình.
5

Khởi động lại client AI của bạn

Claude Desktop tải các máy chủ MCP khi khởi động. Thoát hoàn toàn ứng dụng và mở lại. Bạn sẽ thấy biểu tượng cái búa trong thanh soạn liệt kê các công cụ Sellfern có sẵn.

​
Các công cụ MCP có sẵn

Sau khi kết nối, trợ lý AI của bạn có thể gọi bất kỳ công cụ nào sau đây:
Công cụMô tả
list_ordersLiệt kê đơn hàng với các bộ lọc tùy chọn: trạng thái, ID cửa hàng, truy vấn tìm kiếm, khoảng ngày và phân trang
get_orderLấy chi tiết đầy đủ cho một đơn hàng theo ID
update_order_statusCập nhật trạng thái của một đơn hàng, tùy chọn thêm mã theo dõi
bulk_update_order_statusCập nhật nhiều trạng thái đơn hàng trong một lần gọi
add_order_noteThêm ghi chú vào một đơn hàng
get_analytics_summaryDoanh thu, số đơn hàng, COGS, lợi nhuận gộp và biên cho một kỳ nhất định (last_7_days, last_30_days, mtd, ytd)
list_fulfillment_queueLiệt kê các đơn hàng đang chờ một hành động hoàn tất đơn
assign_supplierGán một nhà cung cấp cho một hoặc nhiều đơn hàng

​
Các client tương thích khác

Máy chủ MCP sử dụng transport stdio mặc định, hoạt động với Claude Desktop và Cursor. Nó cũng hỗ trợ một transport HTTP/SSE cho các client kết nối qua mạng: 
# Khởi động với HTTP/SSE transport (cổng mặc định 8765)
node build/index.js --http
Bất kỳ client tương thích MCP nào — bao gồm OpenCode và các framework agent tùy chỉnh — có thể kết nối với điểm cuối SSE tại http://localhost:8765/sse.

​
Xử lý sự cố

Xác minh rằng đường dẫn trong args trỏ tới mcp-server/build/index.js và bạn đã chạy npm run build trong thư mục mcp-server/. Tệp phải tồn tại trước khi bạn khởi động client.
Kiểm tra rằng SELLFERN_API_TOKEN bắt đầu bằng sk_live_ và chưa bị thu hồi trong Settings → API Tokens.
Token bạn đang dùng không có phạm vi mà công cụ yêu cầu. Vào Settings → API Tokens, xoay vòng token và thêm phạm vi còn thiếu. Các phạm vi thường cần: orders:read, analytics:read, fulfillment:read.