Połącz asystenta AI (MCP)

Quomerce ma serwer MCP. Po połączeniu asystent AI może czytać dane Twoich sklepów: sesje, lejek, zamówienia, problemy, dostępność i nagrania. Pytasz zwykłymi słowami, np. „dlaczego we wtorek spadły zamówienia?”

• Adres serwera: https://api.quomerce.com/mcp
• Logowanie: zwykłe konto Quomerce (OAuth). Nie trzeba kopiować klucza.
• Dostęp: tylko do odczytu. Asystent widzi te same sklepy i liczby co Ty w aplikacji, z Twoją rolą. Niczego nie zmienia.

Claude (web, aplikacja)

Działa w planach Free, Pro, Max, Team i Enterprise. W planie Free możesz dodać jeden własny konektor.

1. W Claude otwórz Customize → Connectors, kliknij Add, potem Add custom connector.

2. Nazwij go Quomerce i wklej adres serwera: https://api.quomerce.com/mcp.

3. Kliknij Continue, potem Add, i wybierz Connect. Otworzy się strona Quomerce. Zaloguj się e-mailem i hasłem, i zezwól na dostęp.

4. W rozmowie włącz konektor Quomerce i zadaj pytanie.

Team i Enterprise

Najpierw właściciel (Owner) Waszej organizacji w Claude musi dodać konektor w Organization settings → Connectors. Potem każda osoba klika Connect i sama loguje się do Quomerce.

Claude Code

1. Dodaj serwer:

   claude mcp add --transport http quomerce https://api.quomerce.com/mcp

2. Uruchom Claude Code i wpisz /mcp. Wybierz quomerce, potem Authenticate. Zaloguj się do Quomerce w przeglądarce.

3. Sprawdź, że /mcp pokazuje Connected, i zadaj pytanie.

Żeby dzielić ustawienie z zespołem, dodaj --scope project. Powstanie plik .mcp.json w repozytorium. Każda osoba i tak loguje się sama.

Dla skryptu, który nie otworzy przeglądarki, użyj tokenu.

Inne aplikacje

Połączy się każda aplikacja, która obsługuje zdalne serwery MCP przez HTTP (Cursor, VS Code, Codex i inne). Dodaj serwer typu http (czasem „streamable HTTP”) z tym adresem:

https://api.quomerce.com/mcp

Jeśli aplikacja obsługuje OAuth, sama otworzy logowanie do Quomerce. Jeśli nie, użyj tokenu.

Klient napisany tylko dla starszego typu SSE nie zadziała. Quomerce obsługuje tylko streamable HTTP.

Tokeny

Token jest tylko dla aplikacji, która sama nie umie się zalogować, np. skryptu.

1. W app.quomerce.com otwórz Ustawienia konta → Dostęp asystenta AI (MCP).
2. Podaj nazwę i czas ważności (7, 30 lub 90 dni), potem utwórz token.
3. Skopiuj go od razu. Pokazujemy go tylko raz.
4. Wysyłaj go w nagłówku: Authorization: Bearer qm_mcp_…

W Claude Code:

claude mcp add --transport http quomerce https://api.quomerce.com/mcp \
  --header "Authorization: Bearer qm_mcp_…"

Token czyta to, co Ty możesz czytać. Traktuj go jak hasło. Możesz go unieważnić na tej samej stronie.

Co potrafi asystent

Obszar	Przykłady
Twoje sklepy	Lista kont i stron, dostępność, stan instalacji
Przegląd	Sesje, zamówienia, przychód, konwersja, w porównaniu z poprzednim okresem
Lejek i ścieżki	Gdzie odpadają odwiedzający, co robią po stronie, kto utknął na płatności
Ruch	Źródła i kanały, strony wejścia
Problemy	Błędy i ich koszt, formularze i pola sprawiające kłopot
Odwiedzający	Szukanie sesji i opis tekstem, co zrobił odwiedzający
Strony	Raport stron i mapy kliknięć
Kontekst	Święta, wypłaty i dni zakupowe, które tłumaczą duży lub mały ruch
Własne pytania	SQL na danych sklepu

Claude może też pokazać nagranie sesji i mapę kliknięć w rozmowie.

Wizyty bez zgody na cookies i boty są pominięte we wszystkich liczbach, tak jak w aplikacji.

Rozłączenie

• Claude: Customize → Connectors, potem Remove.
• Claude Code: claude mcp remove quomerce.
• W Quomerce: w Ustawienia konta → Połączone aplikacje kliknij Odłącz. Aplikacja traci dostęp od razu. Tokeny unieważnisz w Dostęp dla asystenta AI (MCP).

Problemy

Problem	Co zrobić
Strona logowania mówi, że dane są złe	Użyj e-maila i hasła do konta Quomerce, tych z app.quomerce.com.
Asystent nie widzi żadnych sklepów	Twoje konto nie ma jeszcze dostępu do żadnego konta firmowego. Poproś właściciela o zaproszenie.
Nie łączy się	Sprawdź, czy adres kończy się na /mcp i nie ma spacji.
Token przestał działać	Wygasł albo został unieważniony. Utwórz nowy.