Połącz GSC z Gemini

Jak połączyć dane z Google Search Console z Gemini?

Gemini czyta Twoje dane z Search Console przez ten sam endpoint MCP, z którego korzysta każdy inny asystent. Wklej mcp.gscwizard.com do aplikacji Gemini (USA, konta osobiste), Antigravity CLI, Gemini Enterprise lub Gemini API, a Gemini będzie pracować na prawdziwych kliknięciach, wyświetleniach, pozycji i CTR.

Endpoint: https://mcp.gscwizard.com/mcp

Krótka odpowiedź

Dodaj serwer MCP GSC Wizard do tej wersji Gemini, z której korzystasz:

  1. Aplikacja Gemini: Settings → Connected Apps → Add a custom app, a potem wklej https://mcp.gscwizard.com/mcp. Google oferuje to dorosłym w USA na osobistych kontach Google.
  2. Antigravity CLI (następca Gemini CLI dla kont indywidualnych): jeden wpis serverUrl w mcp_config.json.
  3. Gemini Enterprise: dodaj własny serwer MCP z OAuth 2.0. Klucz API nie jest akceptowany.
  4. Gemini API: przekaż sesję klienta MCP do tools za pomocą Google Gen AI SDK albo wywołuj interfejs REST pod /v1 bezpośrednio.

Nie wiesz, z której możesz skorzystać? Tabela poniżej pokazuje, dla kogo jest każda droga.

Z której drogi do Gemini możesz skorzystać?

To Google decyduje, kto dostaje którą wersję, a nie GSC Wizard. Poniższe wymagania pochodzą z oficjalnych stron pomocy Google.

DrogaKto może z niej korzystaćLogowanieKonfiguracja
Aplikacja GeminiDorośli (18+) w USA, osobiste konto Google, język angielski, włączone Keep Activity. Nie konta służbowe ani szkolne.OAuth, automatycznie. Nie trzeba nic kopiować.Wklej jeden adres URL. Około minuty.
Antigravity CLI i IDEProgramiści, z dowolnego miejsca. Samo Gemini CLI obsługuje teraz tylko klientów enterprise i płatnych użytkowników kluczy API.Nagłówek z kluczem API lub OAuth.Jeden wpis JSON.
Gemini EnterpriseOrganizacje. Serwer dodaje administrator zespołu lub chmury.Tylko OAuth 2.0. Klucze API nie są akceptowane.Utwórz klienta OAuth, a potem wypełnij formularz konektora.
Gemini APIProgramiści budujący własnego agenta.Nagłówek z kluczem API.Kilka linijek z Gen AI SDK.
Wideo

Zobacz całą konfigurację od początku do końca

Przewodnik po tym samym serwerze MCP, z którym łączy się Gemini: dodanie go, uwierzytelnienie i prośba o prawdziwą analizę Search Console zwykłym językiem.

Opcja 1: najprostsza

Aplikacja Gemini

Gemini pozwala teraz dodać własny serwer MCP jako własną aplikację. GSC Wizard obsługuje dynamiczną rejestrację klienta, więc Gemini rejestruje się sam i nie ma klucza API ani client secret do kopiowania.

Sprawdź, czy Google oferuje Ci tę opcję

Według strony pomocy Google o własnych aplikacjach musisz mieć co najmniej 18 lat, przebywać w USA, być zalogowany na osobiste konto Google (konta służbowe i szkolne na razie nie są obsługiwane), używać Gemini w języku angielskim i mieć włączone Keep Activity. Aplikację dodajesz w wersji webowej na gemini.google.com, a potem działa też w aplikacji mobilnej. Jeśli nie widzisz opcji Add a custom app, któryś z tych warunków nie jest spełniony: użyj Antigravity CLI, Gemini Enterprise lub API opisanego niżej.

  1. 1

    Połącz swoje usługi w GSC Wizard

    Zaloguj się na tool.gscwizard.com kontem Google, które ma dostęp do Twoich usług Search Console. Gemini będzie czytać dokładnie te usługi, które tam połączysz.

  2. 2

    Dodaj własną aplikację w Gemini

    Wejdź na gemini.google.com na komputerze, kliknij Settings na dole, a potem Connected Apps. W sekcji Custom apps kliknij Add a custom app i wpisz https://mcp.gscwizard.com/mcp. Zostaw /mcp na końcu: sama domena nie odpowiada na żądania MCP.

  3. 3

    Zaloguj się i zatwierdź

    Kliknij Next i postępuj zgodnie z krokami. Gemini przekieruje Cię do ekranu logowania i zgody GSC Wizard. Dane uwierzytelniające w sekcji Advanced features możesz zostawić puste, bo są potrzebne tylko dla serwerów, które nie potrafią automatycznie zarejestrować klienta.

  4. 4

    Pytaj z użyciem @

    W nowym czacie wpisz @, wybierz aplikację GSC Wizard i zapytaj na przykład: „Które strony w example.com straciły najwięcej kliknięć w ostatnich 28 dniach?”. Gemini prosi o potwierdzenie, zanim wykona jakąkolwiek akcję zapisu.

Google zaznacza, że nie kontroluje, nie monitoruje i nie zabezpiecza serwerów MCP firm trzecich oraz że Gemini może udostępniać treść czatu połączonej aplikacji. GSC Wizard zwraca wyłącznie dane z Search Console, GA4 i Bing połączone z Twoim własnym kontem. Aplikację możesz wyłączyć, odłączyć lub usunąć w każdej chwili w Settings → Connected Apps.

Opcja 2: dla programistów

Antigravity CLI i IDE

Antigravity to środowisko agentowe Google i następca Gemini CLI dla kont indywidualnych. Czyta zdalne serwery MCP z pliku JSON i działa wszędzie tam, gdzie działa Antigravity, bez ograniczenia tylko do USA po stronie MCP.

  1. 1

    Utwórz klucz API w GSC Wizard

    Zaloguj się na tool.gscwizard.com, połącz swoje usługi Search Console, a potem utwórz klucz w Account → API keys. Wolisz OAuth zamiast przechowywanego klucza? Pomiń ten krok i zobacz uwagę pod konfiguracją.

  2. 2

    Dodaj serwer do mcp_config.json

    Edytuj ~/.gemini/config/mcp_config.json dla wszystkich projektów albo .agents/mcp_config.json w repozytorium, aby ograniczyć konfigurację do niego. Zdalne serwery używają klucza serverUrl: według dokumentacji Google starsze klucze url i httpUrl nie są tam obsługiwane.

  3. 3

    Sprawdź i pytaj

    Wpisz /mcp w panelu promptu, aby potwierdzić, że serwer jest połączony, i zobaczyć jego narzędzia, a potem zapytaj o swoją witrynę zwykłym językiem.

~/.gemini/config/mcp_config.json

{
  "mcpServers": {
    "gsc-wizard": {
      "serverUrl": "https://mcp.gscwizard.com/mcp",
      "headers": {
        "Authorization": "Bearer gscw_live_..."
      }
    }
  }
}

Aby się zalogować zamiast przechowywać klucz, pomiń blok headers. Ponieważ GSC Wizard obsługuje dynamiczną rejestrację klienta, Antigravity uruchamia przepływ OAuth, gdy klikniesz Authenticate obok serwera w Agent settings → Customizations.

Nadal używasz Gemini CLI?

Google przestał obsługiwać Gemini CLI na darmowych oraz indywidualnych kontach Google AI Pro i Ultra 18 czerwca 2026 i kieruje tych użytkowników do Antigravity CLI. Klienci enterprise i płatni użytkownicy kluczy API zachowują Gemini CLI, a dla nich endpoint wystarczy dodać z nagłówkiem bearer.

gemini mcp add --transport http \
  --header "Authorization: Bearer gscw_live_..." \
  gsc-wizard https://mcp.gscwizard.com/mcp

Możesz też dodać wpis do ~/.gemini/settings.json z "httpUrl": "https://mcp.gscwizard.com/mcp" i tym samym obiektem headers. Odwołaj się do zmiennej środowiskowej, takiej jak $GSCW_KEY, zamiast wklejać klucz, żeby nie trafił do kontroli wersji.

Opcja 3: organizacje

Gemini Enterprise

Gemini Enterprise obsługuje własne serwery MCP, więc administrator może udostępnić dane z Search Console agentom w całej organizacji. Google opisuje dla tych serwerów tylko dwie opcje logowania, No authentication i OAuth 2.0, więc statyczny nagłówek z kluczem API tu nie zadziała. GSC Wizard łączy się przez OAuth 2.0 z klientem, którego tworzysz samodzielnie.

  1. 1

    Utwórz klienta OAuth dla Gemini Enterprise

    Gemini Enterprise zawsze odsyła użytkowników na https://vertexaisearch.cloud.google.com/oauth-redirect, więc zarejestruj klienta dla tego adresu przekierowania. Odpowiedź zawiera client ID (zaczynające się od gscwc_) oraz client secret, który jest pokazywany tylko raz, więc zapisz go, zanim przejdziesz dalej.

  2. 2

    Otwórz formularz własnego serwera MCP

    W wersji Business zaloguj się na business.gemini.google, otwórz Settings & help, wybierz swój zespół, a potem Manage team → Connected apps → Add MCP Server. W konsoli Google Cloud otwórz Gemini Enterprise, przejdź do Data stores → Create data store, wyszukaj Custom MCP Server i kliknij Add MCP server.

  3. 3

    Wpisz wartości OAuth 2.0

    Wybierz OAuth 2.0, wypełnij poniższą tabelę i kliknij Verify Auth. Potem wybierz lokalizację, nazwij konektor i utwórz go.

  4. 4

    Włącz konektor i jego narzędzia

    Google domyślnie zostawia nowe własne połączenia MCP wyłączone. W wersji Business włącz połączenie na stronie Connectors. W konsoli Cloud otwórz data store, wybierz Actions → Reload custom actions, zaznacz potrzebne narzędzia i kliknij Enable actions.

Krok 1: zarejestruj klienta

curl -X POST https://tool.gscwizard.com/api/oauth/register \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "Gemini Enterprise",
    "redirect_uris": ["https://vertexaisearch.cloud.google.com/oauth-redirect"],
    "token_endpoint_auth_method": "client_secret_post",
    "grant_types": ["authorization_code", "refresh_token"]
  }'

Krok 3: wartości

Pole w Gemini EnterpriseWartość
MCP Server URLhttps://mcp.gscwizard.com/mcp
UwierzytelnianieOAuth 2.0
Authorization URLhttps://tool.gscwizard.com/oauth/authorize
Token URLhttps://tool.gscwizard.com/api/oauth/token
Client ID i secretZ odpowiedzi z kroku 1 (gscwc_ i secret)
Scopesmcp:read dla dostępu tylko do odczytu albo mcp:read mcp:write
PKCEWłącz go wszędzie, gdzie formularz oferuje tę opcję: serwer autoryzacji GSC Wizard wymaga PKCE

Authorization URL nie zawiera /api/, a Token URL zawiera; oba są poprawne. W wariancie z konsolą Cloud administrator potrzebuje też roli Discovery Engine Editor, musi nadpisać politykę organizacji, która domyślnie blokuje własne data store MCP, i musi zezwolić na domeny mcp.gscwizard.com i tool.gscwizard.com. Strony konfiguracyjne Google opisują obie drogi: przewodnik dla konsoli Cloud i przewodnik dla wersji Business.

Opcja 4: dla programistów

Gemini API i własne agenty

Budujesz agenta zamiast rozmawiać na czacie? Google Gen AI SDK może przekazać sesję klienta MCP prosto do listy tools, dzięki czemu Gemini wywołuje narzędzia GSC Wizard bezpośrednio.

Python: google-genai z sesją MCP

from google import genai
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

URL = "https://mcp.gscwizard.com/mcp"
HEADERS = {"Authorization": "Bearer gscw_live_..."}
MODEL = "gemini-3.1-pro"  # or whichever Gemini model you use

async with streamablehttp_client(URL, headers=HEADERS) as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        response = await genai.Client().aio.models.generate_content(
            model=MODEL,
            contents="Which pages on example.com lost the most clicks in the last 28 days?",
            config=genai.types.GenerateContentConfig(tools=[session]),
        )
        print(response.text)

Jeśli wolisz w ogóle nie używać MCP, te same klucze, zakresy i limity obsługują zwykły interfejs REST pod adresem https://mcp.gscwizard.com/v1, z wygenerowanym dokumentem OpenAPI 3,1 pod /v1/openapi.json, który możesz przekazać Gemini jako specyfikację function calling.

Poza USA albo na koncie służbowym?

Google oferuje obecnie własne aplikacje w aplikacji Gemini tylko dorosłym w USA na osobistych kontach Google, więc ta opcja może się u Ciebie nie pojawić. Antigravity CLI, Gemini Enterprise i Gemini API nie podlegają tej zasadzie. Jeśli chcesz tylko przekazać komuś z zespołu liczby, link do udostępnionego raportu lub eksport CSV z GSC Wizard zadziała w każdym czacie.

Platformy konektorów, takie jak Windsor.ai i Supermetrics

Jeśli zapytasz Gemini, jak połączyć Search Console, często wymieni platformy konektorów danych, takie jak Windsor.ai i Supermetrics. Rozwiązują one inny problem, więc wybór zależy od tego, czego potrzebujesz.

Platforma konektorów pasuje, gdy

  • Search Console to jedno z kilkunastu źródeł reklamowych i marketingowych, które już zbierasz w jednym miejscu.
  • Chcesz jednolitego raportowania z platform reklamowych, analityki i Search Console.
  • Twój zespół pracuje w arkuszach lub narzędziu BI, a Gemini jest tylko dodatkiem.

GSC Wizard pasuje, gdy

  • Chcesz analizy SEO, takiej jak spadki treści, kanibalizacja, krzywe CTR i ocena okazji, a nie tylko surowych wierszy.
  • Chcesz, aby analiza działała po stronie serwera na pełnym zbiorze danych Search Console, tak by Gemini czytał gotowy wynik.
  • Chcesz jednego adresu MCP, który działa też w ChatGPT, Claude, Grok i Copilot Studio.

Jeśli chcesz zestawić narzędzia raportowe i potokowe obok siebie, zobacz moje zestawienie najlepszych narzędzi do raportowania SEO oraz przewodnik po konektorach dla danych z Search Console.

Pytasz zwykłym językiem, dostajesz gotowe odpowiedzi

O co możesz zapytać po połączeniu

Każda analiza działa po stronie serwera na hurtowni danych, więc asystent czyta gotowy wynik, zamiast liczyć na surowych wierszach.

„Podsumuj skuteczność example.com” „Jakie są moje najczęstsze zapytania i strony w tym miesiącu?” „Które zapytania zyskały, a które straciły pozycje w porównaniu z poprzednim miesiącem?” „Znajdź strony, które tracą ruch” „Gdzie występuje u mnie kanibalizacja słów kluczowych?” „Pokaż moją krzywą CTR względem pozycji” „Wygeneruj pełny raport SEO” „Sprawdź https://example.com/pricing w Google” „Które strony są blisko pierwszej strony wyników?” „Wyślij te adresy URL do IndexNow”
Te same dane, inni asystenci

Łączysz inne narzędzie AI?

Jedno połączenie z Search Console, każdy asystent. Wybierz swojego klienta i postępuj zgodnie z poradnikiem krok po kroku.

Zobacz też przegląd Google Search Console MCP, GA4 MCP, Yandex Webmaster MCP, Merchant Center MCP, aplikację ChatGPT (zainstaluj ją w ChatGPT), konektory Meta Muse do Search Console i Google Analytics, nasze zestawienie najlepszych serwerów MCP do SEO oraz poradnik na 2026 rok o konektorach ChatGPT do danych z Search Console.

Najczęściej zadawane pytania

Czy aplikacja Gemini może połączyć się z Google Search Console?

Tak, jeśli spełniasz wymagania Google: masz co najmniej 18 lat, jesteś w USA, zalogowany na osobiste konto Google (nie służbowe ani szkolne), używasz angielskiego i masz włączone Keep Activity. Otwórz gemini.google.com, przejdź do Settings, potem Connected Apps, kliknij Add a custom app i wpisz https://mcp.gscwizard.com/mcp. Gemini rejestruje się na serwerze i przekierowuje Cię do logowania w GSC Wizard. Jeśli tych wymagań nie spełniasz, użyj Antigravity CLI, Gemini Enterprise lub Gemini API.

Dlaczego nie widzę opcji Add a custom app w mojej aplikacji Gemini?

Google oferuje obecnie własne aplikacje tylko dorosłym w USA, tylko na osobistych kontach Google, tylko po angielsku i tylko z włączonym Keep Activity, a dodaje się je w wersji webowej na gemini.google.com. Jeśli jesteś poza USA albo na koncie służbowym lub szkolnym, ta opcja się nie pojawia. Użyj zamiast tego Antigravity CLI, Gemini Enterprise lub Gemini API.

Czy Gemini Enterprise akceptuje klucz API?

Nie. Google opisuje dla własnego serwera MCP w Gemini Enterprise dwie opcje uwierzytelniania, No authentication i OAuth 2.0, a żadna nie przyjmuje statycznego nagłówka Authorization. Połącz GSC Wizard przez OAuth 2.0, używając client ID i secret utworzonych dla adresu przekierowania Gemini Enterprise.

Czy Antigravity CLI obsługuje zdalne serwery MCP z uwierzytelnianiem?

Tak. Dodaj wpis z serverUrl i obiektem headers do ~/.gemini/config/mcp_config.json (lub .agents/mcp_config.json w projekcie). Dla serwerów obsługujących dynamiczną rejestrację klienta, takich jak GSC Wizard, możesz pominąć headers i uwierzytelnić się przez OAuth w ustawieniach agenta.

Czy Gemini CLI nadal jest opcją?

Tylko dla niektórych kont. Google przestał obsługiwać Gemini CLI na darmowych oraz indywidualnych kontach Google AI Pro i Ultra 18 czerwca 2026 i kieruje tych użytkowników do Antigravity CLI. Gemini CLI pozostaje dostępne dla klientów enterprise i płatnych użytkowników kluczy API, a dla nich gemini mcp add z --transport http i --header nadal rejestruje GSC Wizard.

Czy dane są próbkowane lub ograniczone jak w eksporcie z Search Console?

Nie. Odczyty pochodzą z hurtowni ClickHouse przechowującej pełny zestaw wierszy, więc nie ma limitów wierszy eksportu ani stronicowania API GSC. Hurtownia jest opóźniona o około dwa dni, a każda odpowiedź podaje datę, do której dane są ustabilizowane.

Co Gemini może zrobić po połączeniu?

Wszystko, co udostępnia MCP: analitykę wyszukiwania, najczęstsze zapytania i strony, zmiany pozycji, spadki treści i kanibalizację, krzywe CTR, ocenę okazji, zbiorcze sprawdzanie adresów URL, śledzenie indeksowania, zgłoszenia do IndexNow, dane z Bing Webmaster, metryki GA4 i pełne raporty SEO.

Czy to coś kosztuje?

Klucze API są darmowe dla każdego konta GSC Wizard, a darmowy plan działa przez API GSC. Subskrybenci dostają szybkie zapytania oparte na hurtowni danych, dzięki którym analiza pełnego zbioru danych jest praktyczna. Szczegóły na stronie cennika.

Skieruj Gemini na swoje dane z Search Console

Utwórz darmowy klucz API, dodaj jeden wpis do konfiguracji Gemini i pytaj o swoją witrynę zwykłym językiem.

Porady o Search Console prosto do Twojej skrzynki

Praktyczne sposoby pracy z GSC i GA4, nowości w produkcie i eksperymenty SEO. Bez spamu, wypisać się możesz w każdej chwili.