DataFast MCP

Bắt đầu với MCP

Kết nối trợ lý AI của bạn với DataFast để hỏi về lưu lượng truy cập, doanh thu và các mục tiêu tùy chỉnh, hoặc quản lý các hoạt động trang web mà bạn ủy quyền. Bạn cần một tài khoản DataFast có quyền truy cập API.

Chọn cách kết nối

Chọn một phương thức. Cả hai đều sử dụng Streamable HTTP để giao tiếp với DataFast.

• Đăng nhập bằng OAuth — được khuyến nghị cho các ứng dụng khách hỗ trợ đăng nhập OAuth, bao gồm Codex và Claude Code. Chọn trang web và quyền trên DataFast; ứng dụng khách tự động xử lý mã thông báo kết nối của nó. Bạn không cần tạo hoặc sao chép khóa API.
• Sử dụng mã thông báo API — dành cho các ứng dụng khách yêu cầu mã thông báo Bearer. Tạo mã thông báo tài khoản có phạm vi trong DataFast và thêm mã này vào cấu hình của ứng dụng khách.

Cả hai phương thức đều cung cấp các công cụ DataFast giống nhau. Quyền OAuth cho phép bạn phê duyệt riêng biệt phân tích, quản trị trang web, hành động tài khoản và quản lý thông tin xác thực. Xem tài liệu tham khảo công cụ để biết từng phương thức hỗ trợ những gì.

Kết nối bằng OAuth

1. Thêm DataFast vào ứng dụng khách của bạn

Thêm máy chủ MCP từ xa bằng URL bên dưới và chọn OAuth hoặc Đăng nhập.

https://datafa.st/api/mcp

Đối với Codex, thêm máy chủ và hoàn tất đăng nhập qua trình duyệt:

codex mcp add datafast --url https://datafa.st/api/mcp

Để đăng nhập lại sau đó, chạy codex mcp login datafast. Cả tài liệu siêu dữ liệu ứng dụng khách và đăng ký động đều được hỗ trợ, bao gồm cả callback loopback gốc. Nếu DataFast đã được cấu hình với mã thông báo Bearer, hãy xóa thông tin xác thực đó khỏi cấu hình DataFast của ứng dụng khách trước khi chuyển sang OAuth.

Đối với Claude Code, thêm máy chủ, sau đó mở /mcp trong Claude Code và xác thực DataFast:

claude mcp add --transport http datafast https://datafa.st/api/mcp

2. Đăng nhập và phê duyệt quyền truy cập

1. Đăng nhập trên datafa.st bằng tài khoản DataFast hiện có của bạn.
2. Chọn các trang web mà ứng dụng khách này có thể truy cập.
3. Xem lại các quyền được yêu cầu. Quyền đọc được chọn theo mặc định; chỉ bật quyền ghi nếu bạn muốn ứng dụng khách thực hiện các thay đổi đó.
4. Chọn Cho phép truy cập để quay lại ứng dụng khách của bạn.

DataFast cấp cho ứng dụng khách mã thông báo truy cập cho kết nối đó. Ứng dụng khách lưu trữ mã thông báo và tự động làm mới mã thông báo trong khi kết nối còn hiệu lực. Mật khẩu DataFast, phiên bảng điều khiển và khóa API hiện có của bạn không được chia sẻ với ứng dụng khách.

3. Thử nghiệm

Bắt đầu cuộc trò chuyện với DataFast được bật và hỏi:

Liệt kê các trang web có sẵn của tôi, sau đó hiển thị lượt truy cập và doanh thu cho trang web của tôi trong bảy ngày qua.

Xác nhận trang web và phạm vi ngày trước khi tiếp tục. Gói và quyền của bạn vẫn được áp dụng.

Quản lý hoặc thu hồi kết nối trong Cài đặt → API / MCP → Ứng dụng đã kết nối. Kết nối lại khi DataFast yêu cầu bạn phê duyệt quyền truy cập lần nữa hoặc khi bạn muốn chia sẻ các trang web hoặc quyền khác nhau.

Kết nối bằng mã thông báo API

Sử dụng phương thức này khi ứng dụng khách của bạn yêu cầu khóa API hoặc mã thông báo Bearer. Đối với MCP, hãy bắt đầu với mã thông báo truy cập tài khoản, bắt đầu bằng dft_.

1. Tạo mã thông báo tài khoản

1. Mở Cài đặt tài khoản → API / MCP.
2. Trong Mã thông báo truy cập mới, chọn Trang web cụ thể để giới hạn quyền truy cập hoặc Tất cả trang web nếu quy trình làm việc của bạn cần điều đó.
3. Chỉ chọn các quyền bạn cần. Đối với kết nối phân tích, hãy bắt đầu với Trang web → Đọc và Phân tích → Đọc, với tất cả các quyền khác bị tắt.
4. Đặt tên dễ nhận biết cho mã thông báo, chọn Tạo mã thông báo và sao chép giá trị dft_. Giá trị này chỉ được hiển thị một lần.

2. Thêm mã thông báo vào ứng dụng khách của bạn

Sử dụng https://datafa.st/api/mcp và gửi mã thông báo dưới dạng tiêu đề Authorization: Bearer …. Giữ mã thông báo trong cài đặt thông tin xác thực của ứng dụng khách hoặc biến môi trường, ngoài kiểm soát nguồn và tin nhắn trò chuyện.

Codex: đặt mã thông báo của bạn có sẵn dưới dạng biến môi trường DATAFAST_TOKEN, sau đó chạy:

codex mcp add datafast \
  --url https://datafa.st/api/mcp \
  --bearer-token-env-var DATAFAST_TOKEN

Claude Code: thay thế dft_xxx bằng mã thông báo của bạn:

claude mcp add --transport http datafast https://datafa.st/api/mcp \
  --header "Authorization: Bearer dft_xxx"

Cursor: thêm mục này vào mcp.json của bạn. Đặt DATAFAST_TOKEN có sẵn trong môi trường của Cursor; Cursor mở rộng biến môi trường khi kết nối.

{
  "mcpServers": {
    "datafast": {
      "url": "https://datafa.st/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DATAFAST_TOKEN}"
      }
    }
  }
}

Ứng dụng khách khác: nhập URL máy chủ và mã thông báo Bearer trong cài đặt MCP từ xa của họ. Các ứng dụng khách chỉ hỗ trợ máy chủ stdio cục bộ cần một cầu nối như mcp-remote.

3. Thử nghiệm và quản lý quyền truy cập

Yêu cầu ứng dụng khách của bạn liệt kê các trang web có sẵn, sau đó yêu cầu lượt truy cập và doanh thu cho một trang web trong bảy ngày qua.

Quản lý mã thông báo trong Mã thông báo truy cập của bạn trong Cài đặt tài khoản → API / MCP. Sử dụng Chỉnh sửa quyền để thay đổi những gì mã thông báo có thể làm, Roll để thay thế bí mật của nó hoặc Xóa để thu hồi. Sau khi roll mã thông báo, hãy cập nhật giá trị trong ứng dụng khách của bạn.

Đã có khóa API trang web df_? Điểm cuối MCP chung cũng chấp nhận các khóa này, với quyền truy cập gắn với trang web đó. Kiểm tra Xác thực API để biết các thao tác được hỗ trợ. Bạn cũng có thể giới hạn mã thông báo tài khoản cho một trang web bằng Trang web cụ thể ở trên.

Cách giới hạn quyền truy cập

Cả hai phương thức đều cấp cho ứng dụng khách một thông tin xác thực bí mật. OAuth tự động hóa việc cấp và gia hạn thông tin xác thực đó sau khi bạn đồng ý; mã thông báo API là thông tin xác thực bạn tự tạo và cấu hình.

DataFast kiểm tra thông tin xác thực, hành động được phép, quyền truy cập trang web, tư cách thành viên hiện tại và các hạn chế áp dụng của tài khoản hoặc gói trên máy chủ. ID trang web trong yêu cầu công cụ là mục tiêu để kiểm tra, không phải bằng chứng truy cập. Ví dụ: kết nối OAuth được phê duyệt để đọc Trang web A không thể đọc Trang web B hoặc chỉnh sửa Trang web A.

Kết nối OAuth chỉ truy cập các trang web được phê duyệt. Một trang web được tạo thông qua công cụ OAuth được phê duyệt sẽ được thêm vào kết nối đó; các trang web được thêm ở nơi khác không được chia sẻ tự động. Mã thông báo OAuth hết hạn sau một giờ, tự động làm mới tối đa 30 ngày kể từ ngày cấp và yêu cầu sự đồng ý mới sau tối đa 90 ngày. Mã thông báo tài khoản được tạo trong bảng điều khiển vẫn có hiệu lực cho đến khi bạn roll hoặc xóa chúng, tùy thuộc vào quyền truy cập và quyền của tài khoản bạn. Khóa API và mã thông báo tài khoản được cấp qua OAuth cũng phụ thuộc vào kết nối gốc còn hiệu lực.

Mã thông báo OAuth chỉ hoạt động tại điểm cuối MCP mà chúng được cấp. Chúng không thể được dán vào REST API công khai hoặc dùng để đăng nhập vào bảng điều khiển DataFast. Mã thông báo tài khoản cũng hoạt động với các điểm cuối REST API được hỗ trợ.

An toàn

• Bắt đầu với quyền truy cập hạn chế. Chỉ cấp cho ứng dụng khách các trang web và quyền mà nó cần. Hành động tài khoản, quản lý thông tin xác thực và chi tiết khách truy cập đầy đủ yêu cầu quyền OAuth riêng biệt được tắt theo mặc định.
• Xem lại các thay đổi. Công cụ ghi OAuth yêu cầu xác nhận và khóa thử lại. Công cụ mã thông báo API yêu cầu xác nhận cho các thao tác nhạy cảm như xóa dữ liệu hoặc cấp thông tin xác thực. Các kiểm tra này bổ sung cho giao diện xác nhận của ứng dụng khách; chúng không thay thế việc chọn một ứng dụng khách đáng tin cậy.
• Giữ thông tin xác thực riêng tư. Cả hai phương thức đều sử dụng mã thông báo Bearer: người có được mã thông báo hợp lệ có thể sử dụng quyền truy cập được phép của nó cho đến khi mã hết hạn hoặc bị thu hồi. Không bao giờ đặt thông tin xác thực trong URL, kiểm soát nguồn hoặc tin nhắn trò chuyện.
• Ngắt kết nối khi cần. Thu hồi kết nối OAuth chặn các yêu cầu và làm mới tiếp theo. Một yêu cầu đang chạy có thể hoàn tất và dữ liệu đã chia sẻ với ứng dụng khác không bị xóa khi thu hồi.
• Các thao tác chỉ dành cho bảng điều khiển vẫn nằm trong bảng điều khiển. MCP không thể xóa trang web hoặc kết nối/ngắt kết nối nhà cung cấp thanh toán.