MCP/API

MCP/API to jeden interfejs programowy do Qubix. Klienci zewnętrzni — asystent AI, skrypt BI, narzędzie do automatyzacji — łączą się z jednym endpointem przez MCP (Model Context Protocol) i wywołują metody wymienione na tej stronie. Każde wywołanie działa ściśle w ramach Pańskich uprawnień: administrator sięga do całego konta, a buyer tylko do danych swojego zespołu.

Nie ma osobnego REST API do nauki: metody, które Pan tu widzi, to dokładnie to, co serwuje endpoint, więc katalog nigdy nie może rozejść się z rzeczywistym interfejsem.

Te same metody napędzają wbudowanego asystenta

Te metody nie służą wyłącznie klientom zewnętrznym. Wbudowany asystent AI Qubix — panel dostępny na każdym ekranie panelu administracyjnego, bez żadnej konfiguracji — wywołuje dokładnie ten sam katalog. Niezależnie więc od tego, czy zapyta Pan wbudowanego asystenta, czy podłączy własnego agenta AI przez MCP, oba odczytują Pańskie dane i wykonują działania przez te same metody, zawsze w ramach Pańskich uprawnień.

• Wbudowany — asystent na każdej stronie. Zobacz Czat Analityka AI.
• Zewnętrzny — podłącz Claude, Cursor lub innego klienta MCP. Zobacz Podłączenie zewnętrznego AI.

Gdzie to znaleźć

W panelu administracyjnym otwórz menu konta (prawy górny róg, obok Pańskiej nazwy) i wybierz MCP/API.

Endpoint

Wszystko kierowane jest na jeden adres:

POST https://<your-domain>/api/mcp

Transportem jest Streamable HTTP (JSON-RPC 2.0) — pojedynczy endpoint, który gotowi klienci MCP obsługują natywnie i który można też wywołać bezpośrednio z dowolnego języka (zobacz Przykłady kodu poniżej).

Pański token API

Dostęp programowy korzysta z osobistego tokena (PAT) — tworzonego i zarządzanego bezpośrednio na tej stronie, w bloku API Token.

1. Naciśnij Wygeneruj token API (lub Wygeneruj ponownie, jeśli już go Pan ma).
2. Skopiuj token natychmiast — jest pokazywany tylko raz.

Token wygląda jak qbx_…. Qubix przechowuje wyłącznie jego hash i nigdy nie może go pokazać ponownie.

• Jeden token na użytkownika. Dziedziczy Pańską rolę i uprawnienia, więc przez API widzi Pan dokładnie te same dane i działania, co w interfejsie.
• Wygeneruj ponownie wydaje nowy token, a stary natychmiast przestaje działać.
• Odwołaj usuwa token i odcina cały dostęp, który z niego korzystał.

Traktuj token jak hasło

Osobisty token jest równoznaczny z zalogowaniem się jako Pan. Nie publikuj go ani nie udostępniaj. Jeśli wycieknie, naciśnij tutaj Wygeneruj ponownie — stary token od razu wygasa.

Podłącz klienta

Większość klientów MCP przyjmuje niewielką konfigurację: endpoint plus nagłówek Authorization. Dopóki token jest pokazywany zaraz po wygenerowaniu, ta strona już wstawia jego rzeczywistą wartość do poniższego przykładu — skopiuj go w takiej postaci.

JSON

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

Krok po kroku konfigurację konkretnego asystenta (Claude Code, Claude Desktop, Cursor) opisano w Podłączenie zewnętrznego AI.

Przykłady kodu

Aby wywołać endpoint z własnego kodu, wyślij żądanie JSON-RPC z nagłówkami autoryzacji i Streamable-HTTP. Strona oferuje gotowe fragmenty dla cURL, JavaScript i Python — przełącz zakładkę i skopiuj. Na przykład, aby wylistować dostępne metody:

Bash

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"}'

Python

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)

Dla niestandardowych integracji

Te surowe wywołania ilustrują protokół z dowolnego języka. Gotowi klienci (Claude, Cursor) ich nie potrzebują — korzystają z konfiguracji powyżej.

Co udostępnia API

Strona wymienia pełny katalog metod — dziś około stu metod — a każda jest oznaczona jako odczyt lub zapis. Obejmują one, w ramach Pańskich uprawnień:

• Analitykę — pulpit, geo, oferty, sieci, źródła ruchu, ekrany Facebook oraz lejek odwiedzających, a także drill-down dla pojedynczej reklamy, kampanii, oferty, kreacji, PWA, geo lub źródła ruchu.
• Kreacje — wyszukiwanie semantyczne oraz najlepiej działające 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, kampaniami trackera, pikselami, witrynami, domenami, PWA i kampaniami push.
• Zapytania dowolne — metoda zapytań tylko do odczytu dla pytań, których gotowe metody nie pokrywają.

Każda metoda pokazuje swoje parametry oraz to, czy zmienia dane. Skorzystaj z pola wyszukiwania, aby znaleźć metodę po nazwie lub opisie.

Metody zapisu są rzeczywiste

Wstrzymanie reklamy, usunięcie reguły lub oferty przez API zmienia Pańskie działające kampanie. W klientach czatu takie działania wykonują się dopiero po Pańskim potwierdzeniu — przejrzyj, co jest proponowane, zanim zatwierdzisz.

Co dalej

Podłączenie zewnętrznego AI

skonfiguruj Claude, Cursor lub innego klienta MCP krok po kroku.

Połączenia

klucze do zewnętrznych usług, z którymi integruje się Qubix.

Szablony

do jakich danych i działań może sięgnąć Pańska rola — a tym samym Pański token.