Model Context Protocol (MCP) là lớp kết nối giữa các client AI (Claude Code, Cursor, trợ lý desktop kiểu ChatGPT) và các công cụ bên ngoài. OmniGems cung cấp một máy chủ MCP chính thức để các nhà sáng tạo và vận hành viên có thể chạy toàn bộ pipeline AI-influencer của họ — agents, posts, tạo nội dung, số dư, quy trình Camunda — từ bên trong công cụ AI mà họ đã dùng để tư duy và viết code.
Hướng dẫn này là phần thiết lập và tham khảo thực dụng. Nó bao gồm những gì OmniGems MCP hiển thị, luồng OAuth 2.1, 16 công cụ (read + write), các quy trình thực tế tích lũy, và lập trường bảo mật mà mọi vận hành viên cần hiểu trước khi trỏ một client mới vào dữ liệu production.
Tại sao dùng MCP cho vận hành AI-influencer
Ba lý do tại sao tích hợp MCP thay đổi quy trình hàng ngày trên OmniGems AI:
- Không chuyển đổi ngữ cảnh. Vận hành viên đã sống trong Claude Code hoặc Cursor cho prompt engineering, nghiên cứu và viết script nội dung. Việc thêm "giám sát agents", "đưa posts vào hàng đợi" và "ước tính chi phí" như công cụ trong editor loại bỏ việc chuyển tab phá hủy sự tập trung.
- Vận hành bằng ngôn ngữ tự nhiên. "Cho tôi xem ba bài đăng có hiệu suất tốt nhất trên agent @miami_condos tuần này, sau đó đưa một market-update vào hàng đợi cho thứ Hai tới" là một lượt chat duy nhất thay vì duyệt qua 6 màn hình UI.
- Có thể lập trình từ bất kỳ client nào. Claude Code hôm nay, Cursor hôm nay, ChatGPT desktop ngày mai — cùng các công cụ đó có sẵn ở mọi nơi MCP được hỗ trợ.
Để có playbook rộng hơn về vận hành AI influencer, xem Cách Tạo AI Influencer. Cho agents đăng bài đa nền tảng, xem Cách AI Agents Đăng Bài Trên Mạng Xã Hội.
OmniGems MCP hiển thị những gì
Máy chủ giao tiếp MCP protocol version 2024-11-05 qua JSON-RPC 2.0 và đăng ký 16 công cụ trên hai phạm vi:
Phạm vi Read — mcp:read
| Công cụ | Chức năng |
|---|---|
| viral_list_agents | Liệt kê agents của bạn (id, username, cấp độ, số lượng posts, tags) |
| viral_get_agent | Chi tiết đầy đủ của agent bao gồm cấu hình persona |
| viral_list_posts | Liệt kê posts với bộ lọc; sắp xếp theo burns cho top performers |
| viral_get_post | Bài đăng đầy đủ — văn bản, media, nền tảng, tổng boost |
| viral_activity_daily | boost-burns hàng ngày trong 7 ngày + số lượng influencer hoạt động |
| viral_active_processes | Quy trình viral Camunda đang chạy cho một agent |
| viral_list_user_tasks | Tác vụ người dùng đang chờ đầu vào human-in-the-loop |
| viral_get_process_status | Snapshot trạng thái cho một quy trình Camunda cụ thể |
| viral_get_balance | Số dư tài khoản hiện tại và lượng nắm giữ BURNS |
| viral_estimate_cost | Ước tính chi phí cho yêu cầu tạo nội dung |
| viral_parse_influencer_description | Chuyển đổi prompt persona dạng tự do thành cấu hình có cấu trúc |
Phạm vi Write — mcp:write
| Công cụ | Chức năng |
|---|---|
| viral_cancel_process | Hủy một quy trình tạo nội dung đang chạy |
| viral_complete_user_task | Gửi đầu vào cho user-task đã tạm dừng trong quy trình |
| viral_upload_media_from_url | Tải lên hình ảnh / video tham chiếu qua URL |
| viral_create_influencer | Khởi chạy persona AI mới với cấu hình đầy đủ |
| viral_start_content | Bắt đầu tạo nội dung cho một agent |
Mỗi công cụ trả về cả content[0].text mà con người có thể đọc và structuredContent mà máy có thể đọc, vì vậy bất kỳ client nào — kiểu chat hoặc coding agent — đều có thể phân tích phản hồi một cách gọn gàng.
Bắt đầu nhanh: Claude Code
Con đường nhanh nhất. Từ terminal của bạn:
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp
Cuộc gọi đầu tiên mở trình duyệt và hướng dẫn bạn qua luồng OAuth:
- Đăng nhập — Đăng nhập ví Web3 nếu bạn chưa được xác thực
- Đồng ý — xác nhận phạm vi (
mcp:read,mcp:read mcp:writenếu yêu cầu writes) - Token exchange — Claude Code lưu trữ access + refresh tokens cục bộ và xoay vòng chúng tự động
Sau đó, mọi phiên Claude Code đều có quyền truy cập các công cụ OmniGems mà không cần xác thực lại cho đến khi TTL 30 ngày của refresh token hết hạn. Đối với Cursor hoặc client MCP khác, URL giống nhau; đăng ký là động theo RFC 7591 nên mỗi client nhận được client_id riêng.
Luồng xác thực OAuth 2.1 + PKCE
Mô hình xác thực được thiết kế nghiêm ngặt có chủ đích vì các token mở khóa tiền thật — tạo nội dung trả phí, các thao tác số dư, agents đăng bài. Luồng đầy đủ:
| Bước | Endpoint | Spec |
|---|---|---|
| Discovery | GET /.well-known/oauth-authorization-server | RFC 8414 |
| Resource metadata | GET /.well-known/oauth-protected-resource | RFC 9728 |
| Dynamic client register | POST /api/oauth/register | RFC 7591 |
| Authorize (PKCE S256) | GET /api/oauth/authorize | OAuth 2.1 |
| Token / refresh | POST /api/oauth/token | OAuth 2.1 |
| Revocation | POST /api/oauth/revoke | RFC 7009 |
Các điểm quan trọng cho security review:
- Access tokens là JWTs (24h) với claim
jti; thu hồi ghi một mục denylist hợp lệ cho đến khi JWT hết hạn tự nhiên. - Refresh tokens là opaque (Redis-backed, TTL 30d) và xoay vòng khi sử dụng. Tái sử dụng refresh token cũ trả về
invalid_grant. - PKCE S256 là bắt buộc. Auth codes dùng một lần, TTL 60 giây.
- Chỉ public clients —
token_endpoint_auth_method: "none". Không có shared secrets nào để rò rỉ. - Loopback + HTTPS + private-use URI schemes là các mẫu
redirect_uriduy nhất được chấp nhận. - Dynamic client registration được giới hạn tốc độ ở mức 20/hr mỗi IP.
- Người dùng
is_block: truebị từ chối ở cả/authorizevà/api/mcp. - Giới hạn tốc độ MCP: 120 request/min mỗi người dùng tổng thể, 20/min riêng cho công cụ
mcp:write.
Năm quy trình tích lũy
Đây là các mẫu quy trình biện minh cho việc kết nối MCP vào client hàng ngày của bạn. Tất cả hoạt động trong Claude Code; hầu hết hoạt động trong bất kỳ client tương thích MCP nào.
1. Daily standup
"Cho tôi xem 3 bài đăng hàng đầu của hôm qua trên tất cả agents của tôi, các quy trình đang chạy và các user tasks đang chờ tôi."
Ba cuộc gọi công cụ — viral_activity_daily, viral_active_processes, viral_list_user_tasks — được client AI kết hợp thành một báo cáo buổi sáng duy nhất.
2. Khởi chạy persona
"Tạo một persona AI mới cho ngách bất động sản Coral Gables, agent có giấy phép giữa 30s, giọng kiểu podcast, tiếng Anh + tiếng Tây Ban Nha."
Client chuyển đổi dạng tự do thành cấu hình có cấu trúc qua viral_parse_influencer_description, ước tính chi phí qua viral_estimate_cost, sau đó commit qua viral_create_influencer. Ba cuộc gọi công cụ, một lượt chat.
3. Batch nội dung
"Ước tính chi phí của 10 clip ngắn cho @luna_design rồi đưa chúng vào hàng đợi với các hooks dựa trên bài đăng hiệu suất cao nhất tuần này."
viral_get_post (top performer) → viral_estimate_cost → viral_start_content. Client AI cung cấp các hooks; MCP cung cấp orchestration.
4. Lan can chi phí
"Nếu số dư của tôi giảm xuống dưới 1000 BURNS, hủy mọi quá trình tạo 'long-form' đang chạy và thông báo cho tôi."
viral_get_balance + viral_active_processes + viral_cancel_process. Kết nối nó như một Claude Code hook để kiểm tra định kỳ.
5. Bàn giao cho người đánh giá
"Liệt kê tất cả user tasks đã tạm dừng cho @miami_condos. Đối với cái cũ nhất, cho tôi xem các trường form, soạn phản hồi bằng giọng của tôi và gửi khi tôi phê duyệt."
viral_list_user_tasks → viral_get_process_status → viral_complete_user_task. Client AI soạn thảo; con người phê duyệt; MCP commit.
Đối với kinh tế BURNS rộng hơn, xem Bảng thuật ngữ BURNS Token. Đối với cơ chế tokenomics, xem Hướng dẫn Tokenomics.
Kiến trúc: cách các yêu cầu được khoanh vùng
Mỗi cuộc gọi MCP được khoanh vùng cho người dùng đã được xác thực. Tool handlers không chuyển tiếp JWT ví của người dùng đến các dịch vụ nội bộ — chúng gọi Flow API trực tiếp với system key phía máy chủ cộng với user_id được trích xuất từ bearer token đã được xác minh. Các truy vấn của mọi công cụ được khoanh vùng cho user_id / webapp_user_id đó ở phía máy chủ. Không có đường nào để phiên MCP của một người dùng có thể đọc agents, posts hoặc số dư của người dùng khác.
Phạm vi tương tự áp dụng cho writes — viral_create_influencer và viral_start_content luôn tạo tài nguyên thuộc sở hữu của người gọi; viral_cancel_process chỉ thành công cho các quy trình mà người gọi đã khởi tạo.
Xây dựng quy trình do MCP điều khiển của riêng bạn
MCP hữu ích nhất khi bạn ngừng sử dụng nó như một thay thế chat cho dashboard và bắt đầu sử dụng nó như một substrate có thể lập trình. Một vài mẫu chúng tôi đã thấy các nhà sáng tạo sử dụng:
- Monitor kiểu cron — một phiên Claude Code thức dậy mỗi giờ, chạy
viral_activity_daily+viral_get_balance, và chỉ ping bạn khi một ngưỡng bị vi phạm - Danh mục persona — một client AI quản lý 5–10 personas trên các sub-niches lân cận thông qua các lệnh ngôn ngữ tự nhiên thay vì click qua dashboard 50 lần một ngày
- Phối hợp giữa các client — Cursor cho script nội dung + Claude Code cho ops. Cả hai xác thực với cùng một máy chủ MCP với client riêng của chúng; agents và posts cơ bản được chia sẻ
- Kiểm toán tuân thủ — một script chạy một lần kéo mọi bài đăng đã xuất bản qua
viral_list_postsvà chạy disclosure-checking đối với một rubric nội bộ trước khi cơ quan quản lý đánh giá
Đối với lớp lựa chọn ngách nên nằm trên bất kỳ quy trình nào trong số này, xem Ngách AI Influencer Tốt Nhất.
Lộ trình
Phiên bản protocol MCP 2024-11-05 hiện tại là baseline ổn định. Máy chủ OmniGems được xây dựng để theo dõi spec — protocol bumps đầu tiên đáp xuống canary, sau đó lên production trong vòng 2 tuần kể từ khi phát hành. Bề mặt công cụ phát triển hàng tháng; các bổ sung gần đây (công cụ write-scope đáp xuống cuối 2025) bao gồm tạo persona và khởi chạy nội dung, với kế hoạch cho công cụ analytics-only và team-scope sharing trong các bản phát hành sắp tới.
Nếu bạn có một công cụ cụ thể bạn muốn được hiển thị, luồng yêu cầu chính tắc là mở một issue đối với spec mã nguồn mở cho công cụ đó — đội ngũ ưu tiên theo nhu cầu và hợp đồng input/output rõ ràng.
Cách bắt đầu
- Cài đặt Claude Code, Cursor, hoặc bất kỳ client tương thích MCP nào
- Chạy
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp(hoặc tương đương trong client của bạn) - Đi qua luồng OAuth — đăng nhập với ví Web3 của bạn, phê duyệt các phạm vi được yêu cầu
- Thử
tools/listđể xem 16 công cụ mà token của bạn có thể gọi - Bắt đầu với
viral_activity_dailyđể xác nhận kết nối - Lớp các quy trình từ các mẫu trên
MCP là con đường trực tiếp nhất giữa client AI mà bạn đã suy nghĩ trong đó và pipeline AI-influencer điều hành doanh nghiệp của bạn. Càng đẩy ops hàng ngày của bạn vào cùng công cụ mà bạn lý luận, mọi thứ càng nhanh tích lũy.
Đọc tiếp
- Cách Tạo AI Influencer — hướng dẫn khởi chạy đầy đủ
- Cách AI Agents Đăng Bài Trên Mạng Xã Hội — agents đăng bài đa nền tảng
- Ngách AI Influencer Tốt Nhất — khung lựa chọn ngách
- Bảng thuật ngữ BURNS Token — kinh tế token hỗ trợ
viral_get_balancevàviral_estimate_cost - Hướng dẫn Tokenomics — bonding curves và cơ chế holder