Ana içeriğe geç

Harici bir yapay zekânın bağlanması (MCP)

Yerleşik AI Analist dışında, Qubix kendi yapay zekâ asistanınıza da bağlanabilir — Claude Desktop, Claude Code, Cursor ya da MCP (Model Context Protocol) destekleyen herhangi bir istemci. Asistan, kampanyalarınızla ilgili soruları canlı verileri kullanarak yanıtlar — arayüzde sahip olduğunuzla tam olarak aynı erişim ve izinlerle.

Gereksinimler

  • Bir kişisel token (PAT) — bunu MCP/API sayfasında oluşturun. Daha fazlası — MCP/API.
  • https://<your-domain>/api/mcp biçimindeki Qubix adresiniz.
Token yalnızca bir kez gösterilir

Token yalnızca onu oluşturduğunuz anda gösterilir. Hemen kopyalayın ve güvenli bir yerde saklayın — Qubix yalnızca onun hash'ini saklar ve tekrar gösteremez. Kaybettiniz mi? Yenisini almak için Yeniden oluştur'a basın (eskisi anında çalışmayı durdurur).

Nasıl bağlanır

İki şeye ihtiyacınız var: https://<your-domain>/api/mcp adresi ve Authorization: Bearer <your-token> başlığı. Gerisi istemciye bağlıdır.

Claude Code (CLI)

Bash
claude mcp add --transport http qubix https://<your-domain>/api/mcp \
--header "Authorization: Bearer qbx_YOUR_TOKEN"

Claude Code'u yeniden başlatın — Qubix araçları sohbette kullanılabilir hâle gelir.

Claude Desktop

Settings → Connectors → Add custom connector menüsünü açın, https://<your-domain>/api/mcp adresini girin ve Authorization: Bearer qbx_YOUR_TOKEN başlığını ekleyin.

Cursor

Sunucuyu ~/.cursor/mcp.json dosyasına (veya projenin .cursor/mcp.json dosyasına) ekleyin:

JSON
{
"mcpServers": {
"qubix": {
"url": "https://<your-domain>/api/mcp",
"headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
}
}
}

Asistan neler yapabilir

Bağlandıktan sonra, asistan analizlerinizi okuyabilir ve işlemler gerçekleştirebilir — hepsi izinleriniz dâhilinde:

  • Analizler — gösterge paneli, geo, teklifler, ağlar, trafik kaynakları, Facebook ekranları, ziyaretçi hunisi ve herhangi bir tek reklam, kampanya, teklif, kreatif, PWA, geo veya trafik kaynağı için ayrıntılı inceleme.
  • Kreatifler — anlamsal arama ("sahte sohbet ekran görüntüsü gibi kreatifler bul") ve en iyi performans gösteren kreatif temaları.
  • Britva — otomasyon kurallarını, duraklatılmış reklamları ve tetiklenme geçmişini görüntüleme; kural oluşturma, düzenleme ve yayınlama.
  • İşlemler — reklamları ve kampanyaları duraklatma ve sürdürme; teklifleri, ağları, trafik kaynaklarını ve tracker kampanyalarını yönetme.
  • Serbest biçimli sorgular — hazır araçların kapsamadığı sorular için.
Yalnızca sizin verileriniz

Asistan, arayüzde gördüğünüzün tam olarak aynısını görür: bir yönetici tüm hesabı alır, bir alıcı yalnızca kendi ekibinin verilerini alır. İşlemler, tıpkı yönetim panelinde olduğu gibi izinlerinizle sınırlıdır.

İşlemler gerçektir

Bir reklamı duraklatmak, asistan aracılığıyla bir kuralı veya teklifi silmek gerçek kampanyalarınızı değiştirir. Sohbet istemcilerinde bu tür işlemler yalnızca sizin onayınızdan sonra gerçekleştirilir — onaylamadan önce asistanın önerdiğini okuyun.

Güvenlik

  • Token, erişim anahtarınızdır — onu bir parola gibi ele alın, paylaşılan dosyalara veya herkese açık depolara koymayın.
  • Kullanıcı başına bir token. Erişimi iptal etmek için MCP/API sayfasını açın ve İptal et'e basın (veya değiştirmek için Yeniden oluştur'a).

Sırada ne var