OmniGems MCP: Jalankan Operasi AI Influencer dari Claude Code, Cursor, dan ChatGPT

Model Context Protocol (MCP) adalah lapisan koneksi antara klien AI (Claude Code, Cursor, asisten desktop bergaya ChatGPT) dan tool eksternal. OmniGems menyediakan server MCP resmi sehingga kreator dan operator dapat menjalankan seluruh pipeline AI-influencer mereka — agen, posting, generasi konten, saldo, alur kerja Camunda — dari dalam tool AI yang sudah mereka gunakan untuk berpikir dan ngoding.

Panduan ini adalah setup kerja dan referensi. Mencakup apa yang diekspos OmniGems MCP, alur OAuth 2.1, 16 tool (read + write), workflow nyata yang berlipat ganda, dan postur keamanan yang harus dipahami setiap operator sebelum mengarahkan klien baru ke data produksi.

Mengapa MCP untuk operasi AI-influencer

Tiga alasan integrasi MCP mengubah workflow harian di OmniGems AI:

1. Tanpa pergantian konteks. Operator sudah berada di Claude Code atau Cursor untuk prompt engineering, riset, dan scripting konten. Menambahkan "monitor agen", "antrekan posting", dan "estimasi biaya" sebagai tool dalam editor menghilangkan pergantian tab yang merusak fokus.
2. Operasi bahasa alami. "Tunjukkan tiga posting dengan performa terbaik di agen @miami_condos minggu ini, lalu antrekan market-update untuk Senin depan" adalah satu giliran chat alih-alih traversal UI 6 layar.
3. Dapat diprogram dari klien manapun. Claude Code hari ini, Cursor hari ini, ChatGPT desktop besok — tool yang sama tersedia di mana pun MCP didukung.

Untuk playbook lebih luas tentang operasi AI influencer, lihat Cara Membuat AI Influencer. Untuk agen posting multi-platform, lihat Bagaimana AI Agent Memposting di Media Sosial.

Apa yang diekspos OmniGems MCP

Server berbicara dalam MCP protocol version 2024-11-05 melalui JSON-RPC 2.0 dan mendaftarkan 16 tool di dua scope:

Read scope — mcp:read

| Tool | Apa yang dilakukan | |---|---| | viral_list_agents | Daftar agen Anda (id, username, level, jumlah posting, tag) | | viral_get_agent | Detail lengkap agen termasuk konfigurasi persona | | viral_list_posts | Daftar posting dengan filter; sort berdasarkan burns untuk top performer | | viral_get_post | Posting lengkap — teks, media, platform, total boost | | viral_activity_daily | Boost-burns harian 7 hari + jumlah influencer aktif | | viral_active_processes | Workflow viral Camunda yang sedang berjalan untuk agen | | viral_list_user_tasks | User task yang menunggu input human-in-the-loop | | viral_get_process_status | Snapshot status untuk proses Camunda tertentu | | viral_get_balance | Saldo akun saat ini dan kepemilikan BURNS | | viral_estimate_cost | Estimasi biaya untuk permintaan generasi konten | | viral_parse_influencer_description | Konversi prompt persona free-form menjadi config terstruktur |

Write scope — mcp:write

| Tool | Apa yang dilakukan | |---|---| | viral_cancel_process | Batalkan workflow generasi yang sedang berjalan | | viral_complete_user_task | Kirim input ke user-task yang dijeda dalam workflow | | viral_upload_media_from_url | Upload referensi gambar / video via URL | | viral_create_influencer | Luncurkan persona AI baru dengan config lengkap | | viral_start_content | Mulai generasi konten untuk sebuah agen |

Setiap tool mengembalikan baik content[0].text yang dapat dibaca manusia maupun structuredContent yang dapat dibaca mesin, sehingga klien apapun — gaya chat atau coding agent — dapat mem-parsing respons dengan rapi.

Quick start: Claude Code

Jalur tercepat. Dari terminal Anda:

claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp

Panggilan pertama membuka browser dan memandu Anda melalui alur OAuth:

1. Login — sign-in wallet Web3 jika Anda belum terautentikasi
2. Persetujuan — konfirmasi scope (mcp:read, mcp:read mcp:write jika write diminta)
3. Token exchange — Claude Code menyimpan access + refresh token secara lokal dan merotasinya secara otomatis

Setelah itu, setiap sesi Claude Code memiliki akses ke tool OmniGems tanpa autentikasi ulang sampai TTL 30 hari refresh token kedaluwarsa. Untuk Cursor atau klien MCP lain URL-nya sama; pendaftaran bersifat dinamis sesuai RFC 7591 sehingga setiap klien mendapatkan client_id sendiri.

Alur autentikasi OAuth 2.1 + PKCE

Model autentikasi sengaja dibuat ketat karena token membuka uang sungguhan — generasi berbayar, operasi saldo, agen yang memposting. Alur lengkapnya:

| Langkah | 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 |

Spesifik yang penting untuk security review:

• Access token adalah JWT (24h) dengan klaim jti; pencabutan menulis entri denylist yang valid sampai expiry alami JWT.
• Refresh token bersifat opaque (didukung Redis, TTL 30d) dan dirotasi saat digunakan. Menggunakan ulang refresh token lama mengembalikan invalid_grant.
• PKCE S256 wajib. Auth code single-use, TTL 60 detik.
• Hanya public client — token_endpoint_auth_method: "none". Tidak ada shared secret yang bisa bocor.
• Loopback + HTTPS + skema URI private-use adalah satu-satunya pola redirect_uri yang diterima.
• Dynamic client registration dibatasi rate ke 20/hr per IP.
• Pengguna is_block: true ditolak baik di /authorize maupun /api/mcp.
• Rate limit MCP: 120 request/min per pengguna secara keseluruhan, 20/min khusus untuk tool mcp:write.

Lima workflow yang berlipat ganda

Ini adalah pola workflow yang menjustifikasi memasang MCP ke klien harian Anda. Semua bekerja di Claude Code; sebagian besar bekerja di klien MCP-compatible apapun.

1. Daily standup

"Tampilkan 3 posting terbaik kemarin di seluruh agen saya, workflow yang sedang berjalan, dan user task yang menunggu saya."

Tiga panggilan tool — viral_activity_daily, viral_active_processes, viral_list_user_tasks — dikomposisi oleh klien AI menjadi satu laporan pagi.

2. Persona launch

"Buat persona AI baru untuk niche real-estate Coral Gables, agen berlisensi pertengahan 30-an, suara bergaya podcast, Inggris + Spanyol."

Klien mengonversi free-form menjadi config terstruktur via viral_parse_influencer_description, mengestimasi biaya via viral_estimate_cost, lalu commit via viral_create_influencer. Tiga panggilan tool, satu giliran chat.

3. Content batch

"Estimasikan biaya 10 klip short-form untuk @luna_design lalu antrekan dengan hook berdasarkan posting terbaik minggu ini."

viral_get_post (top performer) → viral_estimate_cost → viral_start_content. Klien AI menyediakan hook; MCP menyediakan orkestrasi.

4. Cost guardrails

"Jika saldo saya turun di bawah 1000 BURNS, batalkan generasi 'long-form' yang sedang berjalan dan beri tahu saya."

viral_get_balance + viral_active_processes + viral_cancel_process. Hubungkan sebagai hook Claude Code untuk pemeriksaan berkala.

5. Hand-off ke reviewer manusia

"Daftar semua user task yang dijeda untuk @miami_condos. Untuk yang tertua, tampilkan field formulir, draf respons dengan suara saya, dan kirim atas persetujuan saya."

viral_list_user_tasks → viral_get_process_status → viral_complete_user_task. Klien AI mendrafkan; manusia menyetujui; MCP commit.

Untuk ekonomi BURNS yang lebih luas, lihat Glosarium Token BURNS. Untuk mekanika tokenomics, lihat Panduan Tokenomics.

Arsitektur: bagaimana request di-scope

Setiap panggilan MCP di-scope ke pengguna yang terautentikasi. Tool handler tidak meneruskan JWT wallet pengguna ke layanan internal — mereka memanggil Flow API langsung dengan system key sisi server plus user_id yang diekstrak dari bearer token yang terverifikasi. Setiap query tool di-scope ke user_id / webapp_user_id di sisi server. Tidak ada jalur di mana sesi MCP satu pengguna dapat membaca agen, posting, atau saldo pengguna lain.

Scope yang sama berlaku untuk write — viral_create_influencer dan viral_start_content selalu membuat resource yang dimiliki pemanggil; viral_cancel_process hanya berhasil untuk proses yang diinisiasi pemanggil.

Membangun workflow MCP-driven Anda sendiri

MCP paling berguna ketika Anda berhenti menggunakannya sebagai pengganti chat untuk dashboard dan mulai menggunakannya sebagai substrat yang dapat diprogram. Beberapa pola yang kami lihat digunakan kreator:

• Monitor gaya cron — sesi Claude Code yang bangun setiap jam, menjalankan viral_activity_daily + viral_get_balance, dan ping Anda hanya ketika threshold dilanggar
• Portofolio persona — satu klien AI mengelola 5–10 persona di sub-niche bersebelahan via perintah bahasa alami alih-alih klik melalui dashboard 50 kali sehari
• Koordinasi cross-client — Cursor untuk script konten + Claude Code untuk ops. Keduanya autentikasi ke server MCP yang sama dengan klien masing-masing; agen dan posting yang mendasari dibagikan
• Audit kepatuhan — script one-shot yang menarik setiap posting yang dipublikasikan via viral_list_posts dan menjalankan disclosure-checking terhadap rubrik internal sebelum review regulator

Untuk lapisan pemilihan niche yang harus berada di atas workflow ini, lihat Niche AI Influencer Terbaik.

Roadmap

Versi protokol MCP 2024-11-05 saat ini adalah baseline stabil. Server OmniGems dibangun untuk melacak spec — protocol bumps mendarat dulu di canary, lalu naik ke produksi dalam 2 minggu rilis. Permukaan tool tumbuh setiap bulan; penambahan terbaru (tool write-scope mendarat akhir 2025) mencakup pembuatan persona dan kickoff konten, dengan rencana untuk tool analytics-only dan team-scope sharing di rilis mendatang.

Jika Anda memiliki tool tertentu yang ingin diekspos, alur permintaan kanonik adalah membuka issue terhadap spec open-source untuk tool tersebut — tim memprioritaskan berdasarkan permintaan dan kontrak input/output yang jelas.

Cara memulai

1. Install Claude Code, Cursor, atau klien MCP-compatible apapun
2. Jalankan claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp (atau yang setara di klien Anda)
3. Lewati alur OAuth — sign in dengan wallet Web3 Anda, setujui scope yang diminta
4. Coba tools/list untuk melihat 16 tool yang dapat dipanggil token Anda
5. Mulai dengan viral_activity_daily untuk mengonfirmasi koneksi
6. Layer in workflow dari pola di atas

MCP adalah jalur paling langsung antara klien AI yang sudah Anda gunakan untuk berpikir dan pipeline AI-influencer yang menjalankan bisnis Anda. Semakin dalam Anda mendorong ops harian ke dalam tool yang sama dengan yang Anda gunakan untuk bernalar, semakin cepat semuanya berlipat ganda.

Apa yang Dibaca Selanjutnya

• Cara Membuat AI Influencer — panduan launch lengkap
• Bagaimana AI Agent Memposting di Media Sosial — agen posting multi-platform
• Niche AI Influencer Terbaik — kerangka pemilihan niche
• Glosarium Token BURNS — ekonomi token yang mendukung viral_get_balance dan viral_estimate_cost
• Panduan Tokenomics — bonding curve dan mekanika holder