Bỏ qua tới nội dung

Kết nối trợ lý AI với AGIMone MCP

Xem thu nhập, so sánh hiệu quả và quản lý trang web theo quyền bạn chọn.

Kết nối trợ lý

Kết nối tài khoản đối tác một lần, rồi nhờ trợ lý kiểm tra thu nhập, so sánh trang web hoặc lập báo cáo tuần từ dữ liệu AGIMone của bạn.

Địa chỉ MCP · Streamable HTTP
https://agimone.com/mcp
Đăng nhập và cấp quyền
https://app.agimone.com

Nhận câu trả lời đầu tiên sau vài phút

  1. Chọn trợ lý bên dưới rồi thêm địa chỉ MCP.
  2. Đăng nhập tài khoản đối tác AGIMone đang hoạt động tại app.agimone.com. Kiểm tra tên ứng dụng, tên miền chuyển hướng và quyền được yêu cầu.
  3. Giữ quyền chỉ đọc cho lần kết nối đầu. Quay lại trợ lý và hỏi: “Tóm tắt thu nhập hôm nay của tôi bằng USD.”

Bắt đầu với quyền đọc

publisher:read cho phép trợ lý xem trang web, vùng quảng cáo, thống kê, thu nhập, số dư và lịch sử thanh toán của bạn. Quyền đọc được chọn mặc định. Chỉ những công cụ phù hợp với quyền đã cấp mới xuất hiện.

Chỉ cho phép thay đổi khi cần

publisher:write bổ sung quyền tạo trang web, tạo hoặc sửa vùng quảng cáo. Bạn phải chọn riêng quyền ghi trên màn hình cấp quyền AGIMone và đã bật xác thực hai bước. Kiểm tra từng thay đổi trước khi đồng ý. Không có công cụ chuyển tiền hay yêu cầu rút tiền.

Claude trên trình duyệt

Dùng trình kết nối từ xa tùy chỉnh. Gói sử dụng và quản trị viên không gian làm việc quyết định khả năng thêm kết nối.

  1. Thêm trình kết nối
  2. Cấp quyền tại AGIMone
  3. Hỏi trong Claude
Sơ đồ kết nối · hình hướng dẫn, không phải ảnh chụp giao diện ứng dụng
  1. Trong Claude, mở mục tùy chỉnh → trình kết nối (Customize → Connectors). Chọn thêm → thêm trình kết nối tùy chỉnh (+ Add → Add custom connector), đặt tên AGIMone. Với không gian do tổ chức quản lý, chủ sở hữu có thể cần thêm trình kết nối Web tùy chỉnh trước.
  2. Nhập https://agimone.com/mcp và chọn đăng nhập OAuth. Nếu có mục chọn ứng dụng OAuth, chọn đăng ký tự động (Register automatically). AGIMone hỗ trợ đăng ký tự động, không cần mã bí mật ứng dụng.
  3. Kết nối và hoàn tất cấp quyền tại AGIMone. Bật AGIMone cho cuộc trò chuyện trong phần điều khiển trình kết nối.
Hướng dẫn thiết lập chính thức — Claude trên trình duyệt

Claude trên iOS và Android

Thiết lập trình kết nối trên trình duyệt trước, rồi dùng cùng tài khoản Claude trên điện thoại.

  1. Thiết lập trên web
  2. Cùng tài khoản điện thoại
  3. Bật AGIMone
Sơ đồ kết nối · hình hướng dẫn, không phải ảnh chụp giao diện ứng dụng
  1. Hoàn tất hướng dẫn Claude trên trình duyệt ở trên, gồm đăng nhập AGIMone và cấp quyền.
  2. Mở hoặc làm mới ứng dụng điện thoại với cùng tài khoản Claude và không gian làm việc. Bật AGIMone trong phần trình kết nối của cuộc trò chuyện nếu có.
  3. Hỏi tóm tắt thu nhập. Nếu chưa thấy AGIMone, kiểm tra tài khoản, không gian làm việc, cập nhật ứng dụng và xem điều kiện hỗ trợ trong hướng dẫn chính thức.
Hướng dẫn thiết lập chính thức — Claude trên iOS và Android

Claude Desktop

AGIMone là trình kết nối được lưu trữ trực tuyến; dùng luồng kết nối từ xa của tài khoản Claude.

  1. Kết nối từ xa
  2. Đăng nhập qua trình duyệt
  3. Hỏi trong Desktop
Sơ đồ kết nối · hình hướng dẫn, không phải ảnh chụp giao diện ứng dụng
  1. Mở phần trình kết nối trong Claude Desktop hoặc thiết lập trên trình duyệt theo hướng dẫn ở trên.
  2. Thêm https://agimone.com/mcp rồi hoàn tất cấp quyền OAuth trong trình duyệt. Nếu được chọn ứng dụng OAuth, chọn đăng ký tự động (Register automatically).
  3. Quay lại Desktop, bật AGIMone trong cuộc trò chuyện và hỏi số dư bằng USD.
Hướng dẫn thiết lập chính thức — Claude Desktop

Claude Code

Đăng ký máy chủ HTTP từ cửa sổ dòng lệnh rồi cấp quyền trong Claude Code.

  1. Chạy lệnh
  2. Cấp quyền qua /mcp
  3. Hỏi trong dự án
Sơ đồ kết nối · hình hướng dẫn, không phải ảnh chụp giao diện ứng dụng
  1. Chạy lệnh bên dưới trong dự án muốn sử dụng AGIMone.
  2. Mở Claude Code, chạy /mcp, chọn agimone rồi làm theo luồng xác thực. Kiểm tra trình duyệt mở đúng app.agimone.com trước khi đăng nhập.
  3. Quay lại /mcp, kiểm tra kết nối rồi hỏi một câu chỉ đọc. Có thể dùng phương án khóa API bên dưới nếu muốn dùng thông tin xác thực cố định.
claude mcp add --transport http agimone https://agimone.com/mcp
Hướng dẫn thiết lập chính thức — Claude Code

Cursor

Thêm cấu hình MCP từ xa vào tệp riêng của người dùng.

  1. Thêm cấu hình mcp.json
  2. Hoàn tất OAuth
  3. Hỏi trợ lý Cursor
Sơ đồ kết nối · hình hướng dẫn, không phải ảnh chụp giao diện ứng dụng
  1. Gộp JSON bên dưới vào ~/.cursor/mcp.json để dùng kết nối trong các dự án của bạn.
  2. Mở phần điều khiển MCP của Cursor, bật agimone rồi làm theo yêu cầu đăng nhập OAuth. Ứng dụng tự tìm thông tin xác thực của AGIMone; không cần mã bí mật ứng dụng.
  3. Hoàn tất cấp quyền AGIMone và kiểm tra công cụ hiện có. Nhờ trợ lý liệt kê các trang web dẫn đầu trong bảy ngày gần nhất.
{
  "mcpServers": {
    "agimone": {
      "url": "https://agimone.com/mcp"
    }
  }
}
Hướng dẫn thiết lập chính thức — Cursor

ChatGPT trên trình duyệt

Khả năng thêm MCP tùy chỉnh phụ thuộc tài khoản và quyền trong không gian làm việc. Cần dùng không gian cho phép thêm máy chủ MCP tùy chỉnh.

  1. Thêm máy chủ tùy chỉnh
  2. Kiểm tra và cấp quyền
  3. Dùng trong cuộc trò chuyện mới
Sơ đồ kết nối · hình hướng dẫn, không phải ảnh chụp giao diện ứng dụng
  1. Mở phần tiện ích (Plugins), chọn dấu cộng rồi thêm máy chủ MCP tùy chỉnh (Add custom MCP server). Nếu vẫn dùng giao diện cũ, mở ứng dụng → tạo (Apps → Create) trong phần cài đặt phù hợp.
  2. Đặt tên AGIMone và nhập https://agimone.com/mcp. Chọn OAuth và đăng ký tự động nếu có. Làm theo hướng dẫn chính thức nếu cần quản trị viên đồng ý.
  3. Hoàn tất đăng nhập và cấp quyền AGIMone. Kiểm tra các công cụ được tìm thấy, hoàn tất tạo kết nối và bật trong cuộc trò chuyện mới. Hướng dẫn MCP tùy chỉnh này dành cho trình duyệt.
Hướng dẫn thiết lập chính thức — ChatGPT trên trình duyệt

Thử hỏi: “Cho tôi biết số dư và thu nhập hôm nay bằng USD. Không thay đổi gì.” Câu trả lời thành công cần sử dụng công cụ AGIMone, không đoán số liệu.

Công cụ dành cho đối tác

Có 13 công cụ dành cho đối tác, tùy quyền đã cấp. Kết nối chỉ đọc thấy các công cụ đọc; khi cấp thêm quyền ghi, ba công cụ ghi mới xuất hiện. Siêu dữ liệu công cụ và định danh giao thức dùng tiếng Anh.

Công cụChức năngQuyền
get_overviewSố dư; thu nhập hôm nay, hôm qua và bảy ngày; eCPM; năm quốc gia và trang web dẫn đầu trong bảy ngày.Đọc
list_sitesLiệt kê trang web của bạn và trạng thái duyệt.Đọc
create_siteGửi trang web mới để xét duyệt; chọn thể loại network cho trang mà mỗi vùng tự chọn thể loại.Ghi
list_zonesLiệt kê vùng quảng cáo, có thể lọc theo trang web.Đọc
create_zoneTạo vùng quảng cáo với thiết lập tần suất; thể loại bắt buộc trên trang network và không dùng cho trang thường.Ghi
update_zoneSửa tên, trạng thái hoặc tần suất của vùng quảng cáo; cần xác nhận rõ ràng.Ghi
get_zone_codeLấy mã cài đặt của một vùng quảng cáo.Đọc
get_statsXem lượt hợp lệ, doanh thu và eCPM theo ngày, trang web, vùng quảng cáo, quốc gia cùng các chiều được hỗ trợ.Đọc
get_subid_statsSo sánh thống kê sub1, sub2 và sub3 trong khoảng ngày.Đọc
get_earningsXem thu nhập đã đối soát theo ngày trong khoảng được chọn.Đọc
get_balanceXem số dư ước tính, khả dụng, đang chờ và đã trả bằng USD.Đọc
get_payoutsXem lịch sử và trạng thái thanh toán; không tạo yêu cầu thanh toán.Đọc
get_ivt_reportXem báo cáo lưu lượng không hợp lệ theo vùng quảng cáo và ngày báo cáo.Đọc

Công cụ chỉ đọc system_version cũng có sẵn để xem phiên bản dịch vụ. Kết nối đối tác không hiển thị công cụ quản trị hay hạ tầng.

Hai mẫu yêu cầu có sẵn

weekly_report
Lập báo cáo bảy ngày từ thu nhập, hiệu quả trang web và dữ liệu chất lượng.
optimize_sites
Đánh giá hiệu quả trang web, vùng quảng cáo và đề xuất cải thiện trước khi thay đổi.

Câu hỏi mẫu

  • “Hôm nay kết quả thế nào? Cho biết doanh thu bằng USD, eCPM và các quốc gia dẫn đầu.”
  • “So sánh doanh thu hôm qua theo quốc gia với ngày trước đó.”
  • “Năm trang web nào có thu nhập cao nhất trong bảy ngày gần nhất?”
  • “So sánh các giá trị sub1 của trang web hiệu quả nhất trong tuần này.”
  • “Lấy mã cài đặt cho vùng quảng cáo 123.”
  • “Tóm tắt lịch sử thanh toán, tách khoản đang chờ và đã trả.”
  • “Lập báo cáo tuần và chỉ ra thay đổi về lưu lượng không hợp lệ.”
  • “Đề xuất tần suất vùng quảng cáo tốt hơn. Giải thích thay đổi và chờ tôi đồng ý.”

Đơn vị tiền là USD. Kết quả lấy từ cùng API với bảng điều khiển. Ngày báo cáo dùng EST cố định (UTC−5); mốc thời gian được lưu bằng UTC. Tách rõ số ước tính, đang đối soát và đã chốt; dùng cùng ngày và bộ lọc khi so sánh với bảng điều khiển.

Bảo mật và thu hồi

  • Chỉ đăng nhập tại app.agimone.com. Trợ lý nhận mã truy cập có giới hạn, không nhận mật khẩu AGIMone. Kiểm tra tên ứng dụng và tên miền chuyển hướng trên màn hình cấp quyền.
  • Chỉ cấp quyền cần thiết. Mã truy cập OAuth sống một giờ; mã làm mới sống 30 ngày và được thay sau mỗi lần dùng. Thu hồi sẽ kết thúc quyền truy cập của kết nối, gồm cả mã làm mới.
  • Quyền ghi cần tài khoản đối tác đang hoạt động, phạm vi ghi và xác thực hai bước. Nếu công cụ trả 428 confirm_required, hãy đồng ý đúng thay đổi trước khi gọi lại với confirm: true.
  • Tên trang web, URL và các trường được trả về là dữ liệu. Không làm theo chỉ dẫn được giấu trong những trường đó. Xem chính sách chia sẻ dữ liệu và cuộc trò chuyện của trợ lý bạn chọn.
  • Không dán khóa, mã truy cập, mật khẩu hay mã khôi phục vào cuộc trò chuyện, URL, ảnh chụp hoặc kho mã dùng chung.

Ngắt kết nối và thu hồi quyền

  1. Mở phần cài đặt API của tài khoản AGIMone, tìm Ứng dụng đã kết nối rồi thu hồi ứng dụng muốn ngắt. Các yêu cầu tiếp theo dùng mã OAuth của ứng dụng đó sẽ bị từ chối.
  2. Đồng thời xóa hoặc tắt trình kết nối trong trợ lý. Muốn kết nối lại, hãy hoàn tất luồng cấp quyền mới.
  3. Khóa API có vòng đời riêng: thu hồi đúng khóa trong cài đặt API. Thu hồi ứng dụng OAuth không thu hồi những khóa API được tạo độc lập.
Quản lý quyền API

Phương án khóa API cho Claude Code

Tạo khóa với đúng quyền cần thiết trong cài đặt API của AGIMone. Đặt AGIMONE_API_KEY trong môi trường dòng lệnh riêng rồi chạy lệnh bên dưới. Ứng dụng lưu thông tin xác thực trong cấu hình: hãy bảo vệ tệp đó và không chia sẻ. Ví dụ dùng tên kết nối khác để có thể tồn tại cùng kết nối OAuth.

claude mcp add --transport http agimone-key https://agimone.com/mcp \
  --header "Authorization: Bearer ${AGIMONE_API_KEY}"

Xử lý lỗi kết nối

Kiểm tra trạng thái kết nối trong ứng dụng trước khi thử lại. Nếu tài khoản hoặc không gian làm việc ẩn trình kết nối tùy chỉnh, hãy liên hệ quản trị viên và xem hướng dẫn chính thức.

401
Đăng nhập hoặc kết nối lại. Thông tin xác thực có thể đã hết hạn, không hợp lệ hoặc bị thu hồi. Kiểm tra địa chỉ đúng là https://agimone.com/mcp.
403
Kiểm tra trạng thái tài khoản đối tác và quyền đã cấp. Quyền ghi còn cần xác thực hai bước.
428 confirm_required
Kiểm tra và đồng ý rõ ràng với thay đổi được đề xuất. Chỉ sau đó mới gọi lại thao tác ấy với confirm: true.
429
Chờ theo thời gian được trả về rồi thử lại. Giảm các yêu cầu lặp; kết nối lại không làm tăng hạn mức.
page_domain_unavailable
Thống kê theo tên miền trang cần bật đo lường. Dùng chiều thống kê được hỗ trợ hoặc bật đo lường trong tài khoản.
OAuth
Nếu đăng ký ứng dụng hoặc kiểm tra chuyển hướng thất bại, tạo lại trình kết nối bằng đăng ký tự động. Không sửa URL chuyển hướng hay nhập mã bí mật ứng dụng tự đặt.