OmniGems MCP: AI Influencer Operasyonlarını Claude Code, Cursor ve ChatGPT'den Yönetin

Model Context Protocol (MCP), AI istemcileri (Claude Code, Cursor, ChatGPT tarzı masaüstü asistanları) ile harici araçlar arasındaki bağlantı katmanıdır. OmniGems, resmi bir MCP sunucusu sunar; böylece içerik üreticiler ve operatörler tüm AI-influencer pipeline'larını — agentlar, gönderiler, içerik üretimi, bakiye, Camunda iş akışları — zaten düşünmek ve kod yazmak için kullandıkları AI aracının içinden çalıştırabilirler.

Bu kılavuz, çalışan kurulum ve referans niteliğindedir. OmniGems MCP'nin neyi sunduğunu, OAuth 2.1 akışını, 16 aracı (read + write), birikerek katlanan gerçek iş akışlarını ve yeni bir istemciyi production verilerine yönlendirmeden önce her operatörün anlaması gereken güvenlik duruşunu kapsar.

AI-influencer operasyonları için neden MCP

OmniGems AI üzerindeki günlük iş akışını MCP entegrasyonunun değiştirdiği üç neden:

1. Bağlam değiştirme yok. Operatörler zaten prompt mühendisliği, araştırma ve içerik scripting için Claude Code veya Cursor içinde yaşıyor. "Agentları izle", "gönderileri sıraya al" ve "maliyet tahmin et" işlemlerini editör içi araçlar olarak eklemek, odağı yıkan sekme atlamayı ortadan kaldırır.
2. Doğal dilde operasyon. "Bu hafta @miami_condos agent'ında en iyi performans gösteren üç gönderiyi bana göster, sonra önümüzdeki Pazartesi için bir market-update sıraya al" tek bir sohbet turudur, 6 ekranlık bir UI gezintisi değil.
3. Herhangi bir istemciden programlanabilir. Bugün Claude Code, bugün Cursor, yarın ChatGPT desktop — MCP'nin desteklendiği her yerde aynı araçlar mevcuttur.

AI influencer operasyonları için daha geniş playbook için AI Influencer Nasıl Oluşturulur yazısına bakın. Çoklu platform gönderim agentları için AI Agentları Sosyal Medyada Nasıl Gönderir yazısına bakın.

OmniGems MCP neyi sunar

Sunucu, JSON-RPC 2.0 üzerinde MCP protocol version 2024-11-05 konuşur ve iki kapsam arasında 16 araç kaydeder:

Read kapsamı — mcp:read

| Araç | Ne yapar | |---|---| | viral_list_agents | Agentlarınızı listeler (id, username, seviye, gönderi sayısı, etiketler) | | viral_get_agent | Persona yapılandırması dahil tam agent ayrıntıları | | viral_list_posts | Filtrelerle gönderileri listeler; en iyi performans için burns'e göre sırala | | viral_get_post | Tam gönderi — metin, medya, platformlar, boost toplamları | | viral_activity_daily | 7 günlük günlük boost-burns + aktif influencer sayıları | | viral_active_processes | Bir agent için devam eden Camunda viral iş akışları | | viral_list_user_tasks | Human-in-the-loop girdi bekleyen kullanıcı görevleri | | viral_get_process_status | Belirli bir Camunda süreci için durum anlık görüntüsü | | viral_get_balance | Geçerli hesap bakiyesi ve BURNS varlıkları | | viral_estimate_cost | Bir içerik üretim isteği için maliyet tahmini | | viral_parse_influencer_description | Serbest biçimli persona promptlarını yapılandırılmış config'e dönüştür |

Write kapsamı — mcp:write

| Araç | Ne yapar | |---|---| | viral_cancel_process | Devam eden bir üretim iş akışını iptal et | | viral_complete_user_task | İş akışında duraklatılmış bir kullanıcı görevine girdi gönder | | viral_upload_media_from_url | URL üzerinden referans görsel/video yükle | | viral_create_influencer | Tam config ile yeni bir AI persona başlat | | viral_start_content | Bir agent için içerik üretimini başlat |

Her araç hem insan tarafından okunabilen content[0].text hem de makine tarafından okunabilen structuredContent döndürür; böylece herhangi bir istemci — sohbet tarzı veya kodlama agent'ı — yanıtı temiz bir şekilde parse edebilir.

Hızlı başlangıç: Claude Code

En hızlı yol. Terminalinizden:

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

İlk çağrı bir tarayıcı açar ve sizi OAuth akışı boyunca yönlendirir:

1. Giriş — Henüz kimlik doğrulamadıysanız Web3 cüzdan oturum açma
2. Onay — Kapsamı doğrulayın (mcp:read, yazma istenirse mcp:read mcp:write)
3. Token değişimi — Claude Code, access + refresh tokenları yerel olarak saklar ve otomatik olarak rotasyona alır

Bundan sonra, refresh token'ın 30 günlük TTL'i sona erene kadar her Claude Code oturumu yeniden kimlik doğrulama yapmadan OmniGems araçlarına erişebilir. Cursor veya başka bir MCP istemcisi için URL aynıdır; kayıt RFC 7591'e göre dinamiktir, böylece her istemci kendi client_id'sini alır.

OAuth 2.1 + PKCE auth akışı

Auth modeli kasıtlı olarak katıdır çünkü tokenlar gerçek parayı açar — ücretli üretimler, bakiye operasyonları, gönderim agentları. Tam akış:

| Adım | 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 |

Güvenlik incelemesi için önemli ayrıntılar:

• Access tokenları JWT'lerdir (24h) ve jti claim'i içerir; iptal, JWT'nin doğal sona erme süresine kadar geçerli bir denylist girişi yazar.
• Refresh tokenları opaktır (Redis destekli, 30d TTL) ve kullanımda rotasyona alınır. Eski bir refresh token'ı yeniden kullanmak invalid_grant döndürür.
• PKCE S256 zorunludur. Auth kodları tek kullanımlıktır, 60 saniye TTL.
• Yalnızca public clientlar — token_endpoint_auth_method: "none". Sızdırılacak shared secret yok.
• Loopback + HTTPS + private-use URI şemaları kabul edilen tek redirect_uri desenleridir.
• Dynamic client registration, IP başına 20/hr ile rate-limited edilmiştir.
• is_block: true kullanıcılar reddedilir hem /authorize hem de /api/mcp üzerinde.
• MCP rate limitleri: kullanıcı başına genel olarak 120 istek/dakika, özellikle mcp:write araçları için 20/min.

Birikerek katlanan beş iş akışı

Bunlar, MCP'yi günlük istemcinize bağlamayı haklı çıkaran iş akışı desenleridir. Hepsi Claude Code'da çalışır; çoğu herhangi bir MCP uyumlu istemcide çalışır.

1. Günlük standup

"Dün tüm agentlarımdaki en iyi 3 gönderiyi, devam eden iş akışlarını ve beni bekleyen kullanıcı görevlerini göster."

Üç araç çağrısı — viral_activity_daily, viral_active_processes, viral_list_user_tasks — AI istemci tarafından tek bir sabah raporunda birleştirilir.

2. Persona lansmanı

"Coral Gables emlak nişi için yeni bir AI persona oluştur, 30'lu yaşların ortasında lisanslı bir agent, podcast tarzı ses, İngilizce + İspanyolca."

İstemci, viral_parse_influencer_description üzerinden serbest biçimi yapılandırılmış config'e dönüştürür, viral_estimate_cost üzerinden maliyeti tahmin eder, ardından viral_create_influencer üzerinden commit eder. Üç araç çağrısı, bir sohbet turu.

3. İçerik batch'i

"@luna_design için 10 kısa formatlı klibin maliyetini tahmin et ve sonra bu haftanın en iyi performans gösteren gönderisine dayanan kancalarla onları sıraya al."

viral_get_post (en iyi performans) → viral_estimate_cost → viral_start_content. AI istemci kancaları sağlar; MCP orkestrasyonu sağlar.

4. Maliyet korkulukları

"Bakiyem 1000 BURNS'ün altına düşerse, devam eden 'long-form' üretimleri iptal et ve bana bildir."

viral_get_balance + viral_active_processes + viral_cancel_process. Periyodik kontroller için bir Claude Code hook'u olarak bağlayın.

5. İnsan denetçiye devir

"@miami_condos için duraklatılmış tüm kullanıcı görevlerini listele. En eskisi için form alanlarını göster, kendi sesimle bir yanıt taslağı hazırla ve onayımla gönder."

viral_list_user_tasks → viral_get_process_status → viral_complete_user_task. AI istemci taslak hazırlar; insan onaylar; MCP commit eder.

Daha geniş BURNS ekonomisi için BURNS Token Sözlüğü yazısına bakın. Tokenomics mekaniği için Tokenomics Kılavuzu yazısına bakın.

Mimari: istekler nasıl kapsama alınır

Her MCP çağrısı kimliği doğrulanmış kullanıcıya kapsanmıştır. Tool handlerlar kullanıcının cüzdan JWT'sini iç servislere iletmez — Flow API'yi doğrulanmış bearer token'dan çıkarılan user_id ile birlikte sunucu taraflı bir system key kullanarak doğrudan çağırır. Her aracın sorguları sunucu tarafında o user_id / webapp_user_id'ye kapsanmıştır. Bir kullanıcının MCP oturumunun başka bir kullanıcının agentlarını, gönderilerini veya bakiyesini okuyabileceği bir yol yoktur.

Aynı kapsama writes için de geçerlidir — viral_create_influencer ve viral_start_content her zaman çağıran kişiye ait kaynaklar oluşturur; viral_cancel_process yalnızca çağıranın başlattığı süreçler için başarılı olur.

Kendi MCP odaklı iş akışınızı oluşturma

MCP, onu dashboard için bir sohbet yedeği olarak kullanmayı bırakıp programlanabilir bir alt katman olarak kullanmaya başladığınızda en kullanışlıdır. İçerik üreticilerin kullandığını gördüğümüz birkaç desen:

• Cron tarzı monitörler — her saat uyanan, viral_activity_daily + viral_get_balance çalıştıran ve yalnızca bir eşik aşıldığında size bildirim gönderen bir Claude Code oturumu
• Persona portföyleri — günde 50 kez bir dashboard'a tıklamak yerine doğal dil komutlarıyla bitişik alt nişler arasında 5–10 personayı yöneten bir AI istemci
• İstemciler arası koordinasyon — içerik scriptleri için Cursor + ops için Claude Code. Her ikisi de kendi istemcileriyle aynı MCP sunucusuna kimlik doğrulaması yapar; temel agentlar ve gönderiler paylaşılır
• Uyumluluk denetimleri — bir düzenleyici incelemesinden önce viral_list_posts üzerinden yayınlanmış her gönderiyi çeken ve bunu bir iç rubriğe karşı disclosure-checking çalıştıran tek seferlik bir script

Bu iş akışlarının üzerinde olması gereken niş seçimi katmanı için En İyi AI Influencer Nişleri yazısına bakın.

Yol haritası

Geçerli 2024-11-05 MCP protokol sürümü stabil temel hattıdır. OmniGems sunucusu spec'i takip edecek şekilde inşa edilmiştir — protokol artırımları önce canary'e iner, ardından sürümden sonra 2 hafta içinde production'a yükselir. Araç yüzeyi her ay büyür; son eklemeler (write-scope araçlar 2025'in sonunda indi) persona oluşturma ve içerik başlatmayı kapsar; gelecek sürümlerde analytics-only araçlar ve team-scope paylaşımı planlanmaktadır.

Sunulmasını istediğiniz belirli bir araç varsa, kanonik istek akışı o araç için open-source spec'e karşı bir issue açmaktır — ekip talebe ve net girdi/çıktı sözleşmelerine göre öncelik verir.

Nasıl başlanır

1. Claude Code, Cursor veya herhangi bir MCP uyumlu istemci yükleyin
2. claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp çalıştırın (veya istemcinizdeki eşdeğeri)
3. OAuth akışını yürüyün — Web3 cüzdanınızla giriş yapın, istenen kapsamları onaylayın
4. Token'ınızın çağırabileceği 16 aracı görmek için tools/list deneyin
5. Bağlantıyı doğrulamak için viral_activity_daily ile başlayın
6. Yukarıdaki desenlerden iş akışlarını katmanlayın

MCP, zaten içinde düşündüğünüz AI istemcisi ile işinizi yürüten AI-influencer pipeline'ı arasındaki en doğrudan yoldur. Günlük operasyonlarınızı akıl yürüttüğünüz aynı araca ne kadar derin itin, her şey o kadar hızlı birikip katlanır.

Sonra Ne Okumalı

• AI Influencer Nasıl Oluşturulur — tam lansman rehberi
• AI Agentları Sosyal Medyada Nasıl Gönderir — çoklu platform gönderim agentları
• En İyi AI Influencer Nişleri — niş seçimi çerçevesi
• BURNS Token Sözlüğü — viral_get_balance ve viral_estimate_cost'u destekleyen token ekonomisi
• Tokenomics Kılavuzu — bonding curve'ler ve holder mekanikleri