Podłączenie zewnętrznej AI (MCP)

Oprócz wbudowanego Analityka AI Qubix można podłączyć do własnego asystenta AI — Claude Desktop, Claude Code, Cursor lub dowolnego klienta, który obsługuje MCP (Model Context Protocol). Asystent odpowiada wtedy na pytania o Pana/Pani kampanie na podstawie danych na żywo — z dokładnie takim samym dostępem i uprawnieniami, jakie ma Pan/Pani w interfejsie.

Co jest potrzebne

• Osobisty token (PAT) — proszę utworzyć go na stronie MCP/API. Więcej — MCP/API.
• Adres Qubix w postaci https://<your-domain>/api/mcp.

Token jest pokazywany tylko raz

Token jest wyświetlany wyłącznie w momencie jego utworzenia. Proszę skopiować go od razu i przechowywać w bezpiecznym miejscu — Qubix przechowuje tylko jego hash i nie może pokazać go ponownie. Zgubił się? Proszę nacisnąć Wygeneruj ponownie, aby otrzymać nowy (stary przestaje działać natychmiast).

Jak podłączyć

Potrzebne są dwie rzeczy: adres https://<your-domain>/api/mcp oraz nagłówek Authorization: Bearer <your-token>. Reszta zależy od klienta.

Claude Code (CLI)

Bash

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

Proszę zrestartować Claude Code — narzędzia Qubix stają się dostępne w czacie.

Claude Desktop

Proszę otworzyć Settings → Connectors → Add custom connector, ustawić adres https://<your-domain>/api/mcp i dodać nagłówek Authorization: Bearer qbx_YOUR_TOKEN.

Cursor

Proszę dodać serwer do ~/.cursor/mcp.json (lub do .cursor/mcp.json projektu):

JSON

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

Co potrafi asystent

Po podłączeniu asystent może odczytywać Pana/Pani analitykę oraz wykonywać działania — wszystko w ramach Pana/Pani uprawnień:

• Analityka — pulpit, geo, oferty, sieci, źródła ruchu, ekrany Facebook, lejek odwiedzających oraz szczegółowy wgląd w dowolną pojedynczą reklamę, kampanię, ofertę, kreację, PWA, geo lub źródło ruchu.
• Kreacje — wyszukiwanie semantyczne („znajdź kreacje podobne do zrzutu fałszywego czatu”) oraz najskuteczniejsze tematy kreacji.
• Britva — przeglądanie reguł automatyzacji, wstrzymanych reklam i historii uruchomień; tworzenie, edytowanie i publikowanie reguł.
• Akcje — wstrzymywanie i wznawianie reklam oraz kampanii; zarządzanie ofertami, sieciami, źródłami ruchu i kampaniami trackera.
• Zapytania dowolne — dla pytań, których nie obejmują gotowe narzędzia.

Tylko Pana/Pani dane

Asystent widzi dokładnie to, co Pan/Pani widzi w interfejsie: administrator otrzymuje całe konto, a kupujący — wyłącznie dane swojego zespołu. Działania są ograniczone Pana/Pani uprawnieniami, tak samo jak w panelu administracyjnym.

Działania są rzeczywiste

Wstrzymanie reklamy, usunięcie reguły lub oferty za pośrednictwem asystenta zmienia Pana/Pani rzeczywiste kampanie. W klientach czatu takie działania są wykonywane dopiero po Pana/Pani potwierdzeniu — proszę przeczytać, co proponuje asystent, przed zatwierdzeniem.

Bezpieczeństwo

• Token to Pana/Pani klucz dostępu — proszę traktować go jak hasło, nie umieszczać go we współdzielonych plikach ani w publicznych repozytoriach.
• Jeden token na użytkownika. Aby cofnąć dostęp, proszę otworzyć stronę MCP/API i nacisnąć Odwołaj (lub Wygeneruj ponownie, aby go zastąpić).

Co dalej

Czat z Analitykiem AI

wbudowany asystent, bez żadnej konfiguracji.

MCP/API

endpoint, Pana/Pani token i pełny katalog metod.

AI (przegląd)

dane analityka stojące za narzędziami.