Dokumentacja GSC Magic

Czym jest GSC Magic

GSC Magic to hostowany serwer MCP. Logujesz się raz, dodajesz jeden adres do swojego klienta AI, a agent może czytać Twoje dane z wyszukiwarki bezpośrednio, zamiast pracować na eksportach CSV i zrzutach ekranu.

Przy okazji panel pod adresem app.gscmagic.com pokazuje te same dane na wykresach, przechowuje historię dłuższą niż 16 miesięcy Google, wysyła alerty i rejestruje wszystko, co robią Twoi agenci.

Szybki start

1. Załóż konto. Otwórz panel i kontynuuj przez Google albo załóż konto z e-mailem i hasłem (adres potwierdzisz e-mailem). Użyj konta Google, które jest właścicielem Twoich usług Search Console.
2. Zezwól na dostęp. Pierwsze logowanie jednorazowo prosi Google o Search Console (odczyt i zapis) i Google Analytics 4 tylko do odczytu. Narzędzia zapisu są dostępne tylko w planach Pro i Agency, a wyłączysz je w Settings → Write access.
3. Zaimportuj witryny. Na ekranie Welcome wybierz usługi do dodania. GSC Magic pokazuje najpierw te z największym ruchem i respektuje limit witryn w Twoim planie. Witryny Bing i usługi GA4 z tym samym hostem są łączone automatycznie.
4. Połącz swojego klienta AI. Skorzystaj z sekcji Klienci AI poniżej. Endpoint to https://mcp.gscmagic.com/mcp.
5. Zadaj pytanie. Zacznij od „Wypisz moje witryny w GSC Magic.” Potem wypróbuj prompt z sekcji Przykładowe prompty.

Strona Connect w panelu zawiera te same instrukcje, z przyciskami jednego kliknięcia i testem połączenia.

Klienci AI

Endpoint jest wszędzie taki sam:

https://mcp.gscmagic.com/mcp

Klienci obsługujący OAuth logują Cię przez stronę GSC Magic. Dla pozostałych użyj tokenu dostępu.

Claude (claude.ai, desktop i mobile)

1. Użyj Add to Claude: otwiera GSC Magic w katalogu konektorów Claude. Możesz też otworzyć Customize → Connectors → Add custom connector, nazwać konektor GSC Magic i wkleić endpoint.
2. Kliknij Connect obok GSC Magic, kontynuuj przez Google (lub e-mail) i zezwól na dostęp.
3. W nowym czacie włącz GSC Magic w + → Connectors i zapytaj „Wypisz moje witryny w GSC Magic.”

W planach Team i Enterprise konektor może dodać tylko Owner (Organization settings → Connectors → Add → Custom); członkowie klikają potem Connect samodzielnie. Konektory dodane w wersji www pojawiają się w aplikacjach desktopowych i mobilnych.

ChatGPT

1. Na chatgpt.com otwórz Plugins, kliknij + i wybierz Add custom MCP server. Developer mode nie jest potrzebny.
2. Nazwij serwer GSC Magic, wklej powyższy URL serwera i wybierz OAuth. Pola client ID i secret zostaw puste, zaakceptuj ostrzeżenie o ryzyku i kliknij Create.
3. Zaloguj się przez Google (albo e-mailem i hasłem do GSC Magic), gdy ChatGPT otworzy stronę GSC Magic, a potem w nowym czacie wpisz @ i wybierz GSC Magic.

Własne serwery MCP wymagają płatnego planu ChatGPT; w planie Business mogą je dodawać tylko właściciele i administratorzy workspace. ChatGPT nie ma pola na własny nagłówek, więc nie może użyć tokenu dostępu. Jeśli na Twoim koncie nadal widać starszą ścieżkę <em>Settings → Apps → Create app</em>, użyj tam tej samej nazwy, adresu URL i ustawień OAuth.

Claude Code

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Następnie wpisz /mcp, wybierz gsc-magic i kliknij Authenticate. Z tokenem zamiast logowania w przeglądarce:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

Cursor

Dodaj to do ~/.cursor/mcp.json, a potem kliknij Connect obok gsc-magic w Settings → MCP:

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp"
    }
  }
}

Starsze wersje Cursora kończą logowanie na cursor://, czego GSC Magic nie akceptuje. Tam użyj tokenu:

{
  "mcpServers": {
    "gsc-magic": {
      "url": "https://mcp.gscmagic.com/mcp",
      "headers": {
        "Authorization": "Bearer gsm_YOUR_TOKEN"
      }
    }
  }
}

VS Code, Windsurf i inne

Działa każdy klient obsługujący zdalny MCP przez Streamable HTTP. Podaj mu endpoint i, jeśli nie obsługuje OAuth, ten nagłówek żądania:

Authorization: Bearer gsm_YOUR_TOKEN

Strona Connect w panelu zawiera gotowe fragmenty konfiguracji dla VS Code, Windsurf, Hermes Agent, OpenClaw, Grok i DeepSeek.

Tokeny dostępu

Token dostępu (gsm_…) pozwala klientowi połączyć się bez logowania w przeglądarce. Nadaje się do skryptów, narzędzi automatyzacji i klientów bez OAuth.

• Utwórz go w panelu w Connect → Access tokens (właściciel lub admin workspace). Pełny token jest pokazywany raz. Zapisz go w konfiguracji klienta, nigdy w czacie.
• Tokeny domyślnie wygasają po 365 dniach. Możesz wybrać inny okres, do 730 dni, lub brak terminu.
• Zaznacz Read-only, aby token nie mógł zapisywać, niezależnie od tego, na co pozwala Twój plan.
• Token działa tylko na endpoincie MCP, nie na API panelu, i można go unieważnić w każdej chwili. Unieważnienie działa natychmiast.
• Przycisk Test connection na stronie Connect sprawdza, czy endpoint i token działają.

Źródła danych

Połączone to nie powiązane. Dostęp do GA4 lub klucz Bing sprawia tylko, że usługi można wykryć. Aby zobaczyć dane na stronie Overview, powiąż usługę GA4 i witrynę Bing z każdą witryną w Sites. Sources pokazuje, ile witryn jest powiązanych.

Każde źródło ma Reconnect i Disconnect. Rozłączenie GA4 powoduje, że GSC Magic przestaje go czytać i usuwa zapisane przez nas wiersze GA4; Twoje połączenie z Google i Search Console pozostają bez zmian.

Panel

Historia. Po dodaniu witryny GSC Magic uzupełnia do 16 miesięcy dziennych danych wstecz (14 dni na Free), a potem odświeża je co sześć godzin. Podniesienie planu dociąga starsze miesiące. Przechowywaną historię możesz w każdej chwili wyeksportować lub usunąć.

Alerty i digest

W Pro i Agency GSC Magic sprawdza Twoje witryny po każdej synchronizacji i wysyła e-mail, gdy coś wymaga uwagi. Alerty trafiają e-mailem do właściciela workspace. Każda wiadomość ma link do wypisania się.

• Spadek ruchu: strona straciła duży udział kliknięć (domyślnie 30%).
• Indeksowanie: strona, która miała ruch, przestała się pojawiać.
• Kanibalizacja: dwie Twoje strony zaczęły dzielić się zapytaniem.
• Pozycje: ważne zapytanie spadło o kilka pozycji.
• Ruch z AI: sesje z asystentów AI gwałtownie wzrosły (wymaga GA4).

Możesz edytować progi, wyłączać reguły i je usuwać (z możliwością cofnięcia przez kilka sekund). Cotygodniowy digest podsumowuje Twoje witryny. Na Free karta What changed na stronie Overview pokazuje podgląd tego, co te reguły by znalazły. Każde znalezisko jest zgłaszane raz w tygodniu.

Przykładowe prompty

Zastąp example.com swoją witryną. Agent sam dobierze właściwe narzędzia.

Więcej pomysłów w bibliotece promptów.

Opis narzędzi

Narzędzia oznaczone zapis coś zmieniają w Google, Bing lub IndexNow. Są oferowane agentowi tylko w planach Pro i Agency, gdy tryb zapisu jest włączony w Settings (włącza się sam, gdy Google przy logowaniu przyzna pełny dostęp do Search Console), a źródło na to zezwala. Cała reszta jest tylko do odczytu.

Plany i limity

• 7-dniowy okres próbny Pro dla nowych kont, bez karty. Po jego zakończeniu konto wraca na Free. Jeden okres próbny na adres e-mail.
• Liczy się każde wywołanie narzędzia, także nieudane. Dzienny limit resetuje się o północy UTC.
• Jeśli plan się kończy, a masz więcej witryn, niż pozwala nowy plan, panel zapyta, które zachować, a endpoint MCP jest wstrzymany do czasu Twojego wyboru.
• Płatności i faktury obsługuje Polar. Zrezygnować można w każdej chwili; plan pozostaje aktywny do końca opłaconego okresu.

Zespoły i role

Plan Agency obejmuje pięć miejsc, wliczając właściciela. Wszyscy pracują na workspace, danych i planie właściciela.

Grupy klientów ograniczają osobę do wybranych witryn. Osoba z rolą member lub admin w grupie widzi tylko te witryny w panelu, w alertach i przez MCP, i nic poza nimi. Subdomeny liczą się jako osobne witryny, więc możesz dać a.com jednemu klientowi, a blog.a.com innemu. Zaproszenia są wysyłane e-mailem i ważne przez siedem dni.

Bezpieczeństwo i prywatność

• Poświadczenia Google i Bing są szyfrowane w spoczynku. Tokeny dostępu są przechowywane wyłącznie jako skróty.
• Twój agent widzi tylko dane z połączonych przez Ciebie kont, w zakresie Twojego workspace i roli.
• Konta Free mają tylko odczyt. W planach Pro i Agency narzędzia zapisu są dostępne, dopóki właściciel nie wyłączy trybu zapisu w Settings; członkowie zespołu zawsze mają tylko odczyt, a każdy token można wymusić jako tylko do odczytu.
• Sesje wygasają po 14 dniach bezczynności. Wrażliwe działania, takie jak usunięcie konta, wymagają niedawnego logowania.
• Wyeksportuj wszystko, co o Tobie przechowujemy, z Settings albo usuń tam konto i dane. Aktywne płatne subskrypcje trzeba najpierw anulować.

Szczegóły w polityce prywatności i regulaminie. Aby zgłosić podatność, napisz na support@gscmagic.com.

Rozwiązywanie problemów

Nadal nie działa? Napisz na support@gscmagic.com, podając używanego klienta i komunikat błędu. Nigdy nie dołączaj tokenu dostępu.

Krótkie odpowiedzi