MCP/API
MCP/API, Qubix'e tek programlama arayüzüdür. Harici istemciler — bir yapay zeka asistanı, bir BI betiği, bir otomasyon aracı — MCP (Model Context Protocol) üzerinden tek bir uç noktaya bağlanır ve bu sayfada listelenen yöntemleri çağırır. Her çağrı kesinlikle sizin izinleriniz dahilinde çalışır: bir yönetici tüm hesaba erişir, bir alıcı yalnızca kendi ekibinin verilerine.
Öğrenilecek ayrı bir REST API yoktur: burada gördüğünüz yöntemler tam olarak uç noktanın sunduğu yöntemlerdir, bu yüzden katalog gerçek arayüzden asla sapamaz.
Aynı yöntemler yerleşik asistana da güç verir
Bu yöntemler yalnızca harici istemciler için değildir. Yerleşik Qubix yapay zeka asistanı — yönetim panelinin her ekranında, herhangi bir kurulum olmadan kullanılabilen panel — tıpatıp aynı kataloğu çağırır. Yani ister yerleşik asistana sorun ister kendi yapay zeka aracınızı MCP üzerinden bağlayın, ikisi de verilerinizi okur ve aynı yöntemler aracılığıyla, her zaman izinleriniz dahilinde işlem yapar.
- Yerleşik — her sayfadaki asistan. Bkz. Yapay zeka analisti sohbeti.
- Harici — Claude, Cursor veya başka bir MCP istemcisini bağlayın. Bkz. Harici bir yapay zeka bağlama.
Nerede bulunur
Yönetim panelinde hesap menüsünü (sağ üst köşede, adınızın yanında) açın ve MCP/API seçeneğini seçin.
Uç nokta
Her şey tek bir adrese gider:
POST https://<your-domain>/api/mcp
Taşıma Streamable HTTP'dir (JSON-RPC 2.0) — hazır MCP istemcilerinin doğal olarak konuştuğu ve herhangi bir dilden doğrudan da çağırabileceğiniz tek bir uç nokta (aşağıdaki Kod örnekleri bölümüne bakın).
API jetonunuz
Programatik erişim, doğrudan bu sayfada API Token bloğunda oluşturulan ve yönetilen kişisel jetonu (PAT) kullanır.
- API token oluştur düğmesine basın (veya zaten bir jetonunuz varsa Yeniden oluştur).
- Jetonu hemen kopyalayın — yalnızca bir kez gösterilir.
Jeton qbx_… biçiminde görünür. Qubix yalnızca onun karmasını saklar ve onu bir daha asla
gösteremez.
- Kullanıcı başına bir jeton. Rolünüzü ve izinlerinizi devralır, bu yüzden API üzerinden arayüzdekiyle tam olarak aynı verileri ve işlemleri görürsünüz.
- Yeniden oluştur yeni bir jeton verir ve eski jeton anında çalışmayı durdurur.
- İptal et jetonu siler ve onu kullanan tüm erişimi keser.
Kişisel bir jeton, sizin olarak oturum açmaya eşdeğerdir. Onu yayınlamayın veya paylaşmayın. Sızdırılırsa, burada Yeniden oluştur düğmesine basın — eski jeton anında ölür.
Bir istemci bağlama
Çoğu MCP istemcisi küçük bir yapılandırma alır: uç nokta artı Authorization başlığı. Jeton
oluşturulduktan hemen sonra gösterilirken, bu sayfa gerçek değeri zaten aşağıdaki örneğe
doldurur — onu olduğu gibi kopyalayın.
{
"mcpServers": {
"qubix": {
"url": "https://<your-domain>/api/mcp",
"headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
}
}
}
Belirli bir asistanın (Claude Code, Claude Desktop, Cursor) adım adım kurulumu için bkz. Harici bir yapay zeka bağlama.
Kod örnekleri
Uç noktayı kendi kodunuzdan çağırmak için, kimlik doğrulama ve Streamable-HTTP başlıklarıyla bir JSON-RPC isteği gönderin. Sayfa cURL, JavaScript ve Python için hazır parçacıklar sunar — sekmeyi değiştirin ve kopyalayın. Örneğin, kullanılabilir yöntemleri listelemek için:
curl -X POST 'https://<your-domain>/api/mcp' \
-H 'Authorization: Bearer qbx_YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
import requests
res = requests.post(
"https://<your-domain>/api/mcp",
headers={
"Authorization": "Bearer qbx_YOUR_TOKEN",
"Content-Type": "application/json",
"Accept": "application/json, text/event-stream",
},
json={"jsonrpc": "2.0", "id": 1, "method": "tools/list"},
)
print(res.text)
Bu ham çağrılar protokolü herhangi bir dilden gösterir. Hazır istemciler (Claude, Cursor) bunlara ihtiyaç duymaz — yukarıdaki yapılandırmayı kullanırlar.
API'nin sunduğu şeyler
Sayfa, tam yöntem kataloğunu — bugün yaklaşık yüz yöntem — listeler ve her biri okuma veya yazma olarak etiketlenir. İzinleriniz dahilinde şunları kapsarlar:
- Analitik — kontrol paneli, coğrafya, teklifler, ağlar, trafik kaynakları, Facebook ekranları ve ziyaretçi hunisi, ayrıca tek bir reklam, kampanya, teklif, kreatif, PWA, coğrafya veya trafik kaynağı için ayrıntılı inceleme.
- Kreatifler — anlamsal arama ve en iyi performans gösteren kreatif temaları.
- Britva — otomasyon kurallarını, duraklatılmış reklamları ve tetiklenme geçmişini görüntüleyin; kurallar oluşturun, düzenleyin ve yayınlayın.
- İşlemler — reklamları ve kampanyaları duraklatın ve sürdürün; teklifleri, ağları, trafik kaynaklarını, izleyici kampanyalarını, pikselleri, web sitelerini, alan adlarını, PWA'ları ve push kampanyalarını yönetin.
- Serbest biçimli sorgular — hazır yöntemlerin kapsamadığı sorular için salt okunur bir sorgu yöntemi.
Her yöntem, parametrelerini ve veriyi değiştirip değiştirmediğini gösterir. Bir yöntemi adına veya açıklamasına göre bulmak için arama kutusunu kullanın.
Bir reklamı duraklatmak, bir kuralı veya bir teklifi API üzerinden silmek, canlı kampanyalarınızı değiştirir. Claude gibi sohbet istemcilerinde bu tür işlemler yalnızca sizin onayınızdan sonra çalışır — onaylamadan önce önerileni gözden geçirin.