zaDojo

Serwer MCP zaDojo: Claude, Cursor, Codex

Podłącz serwer MCP zaDojo do SEO i widoczności w AI do Claude, ChatGPT, Cursor, Codex, VS Code, Windsurf lub Gemini CLI przez OAuth lub klucz API.

zaDojo udostępnia zdalny serwer MCP, z którym może się połączyć każdy klient obsługujący zdalne MCP. MCP (Model Context Protocol) to standardowy sposób, w jaki aplikacje AI wywołują zewnętrzne narzędzia. Dzięki niemu Twój agent może badać słowa kluczowe, czytać wyniki Google na żywo, sprawdzać pozycje i backlinki dowolnej domeny, robić audyty stron, śledzić pozycje i odpowiedzi AI oraz odczytywać Twoje dane z Search Console i Google Analytics.

Adres serwera:

https://app.zadojo.com/mcp

Przy pierwszym połączeniu klient otwiera logowanie do zaDojo w przeglądarce i prosi o zatwierdzenie dostępu. Potem może korzystać z narzędzi dla projektów, które widzisz. Dla zadań CI i serwerów bez przeglądarki użyj klucza API.

Użytkownicy Claude Code i Codex zyskują więcej dzięki wtyczce, która w jednej instalacji dodaje to połączenie i dwanaście skilli zaDojo. Kroków z tej strony używaj, gdy chcesz samo połączenie MCP albo gdy Twój klient nie ma wtyczki. Przewodnik konfiguracji agenta zawiera prompt, który wybierze właściwą drogę za Ciebie.

Czego potrzebujesz

  • Konta zaDojo. Zarejestruj się, aby dostać 0,10 € kredytów próbnych bez karty.
  • Klienta obsługującego zdalne serwery MCP przez HTTP: Claude Code, Claude Desktop, Cursor, Codex CLI, Codex w aplikacji desktopowej ChatGPT, ChatGPT z własnym połączeniem, VS Code z Copilot, Windsurf (Devin Desktop), Gemini CLI, Zed lub podobnego.
  • Przeglądarki do logowania albo klucza API do pracy bez przeglądarki.

Strona Agent setup w aplikacji pokazuje ten sam adres z przyciskiem kopiowania. Chcesz wypróbować dane zaDojo przed rejestracją? Darmowe narzędzia SEO nie wymagają konta.

Podłącz swojego klienta

Claude Code

Dla większości osób lepszym wyborem jest wtyczka Claude Code. Aby dodać samo połączenie, uruchom w terminalu:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp

--scope user udostępnia zaDojo we wszystkich projektach na Twoim komputerze. Użyj --scope local, aby ograniczyć je do bieżącego repozytorium. Claude Code poprosi Cię potem o zalogowanie do zaDojo. Jeśli prośba się nie pojawi, uruchom /mcp, wybierz zaDojo i dokończ logowanie tam.

Claude Desktop

W płatnym planie Claude wtyczka zaDojo dodaje połączenie i skille razem. W planie Free albo dla samego połączenia dodaj własny konektor:

  1. Otwórz Customize > Connectors.
  2. Kliknij Add lub + i wybierz Add custom connector.
  3. Wklej https://app.zadojo.com/mcp.
  4. Zaloguj się do zaDojo i zatwierdź dostęp.

Własne konektory działają w Claude Free, Pro, Max, Team i Enterprise. Plan Free pozwala na jeden własny konektor.

Cursor

  1. Otwórz Customize i przejdź do serwerów MCP albo edytuj bezpośrednio ~/.cursor/mcp.json.
  2. Dodaj wpis zaDojo:
{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}
  1. Zapisz plik i zatwierdź logowanie do zaDojo, gdy Cursor o to poprosi.

Przewodnik Cursor zawiera link do instalacji jednym kliknięciem i instalację skilli.

Codex CLI

Wtyczka Codex dodaje połączenie i skille razem. Dla samego połączenia:

codex mcp add zadojo --url https://app.zadojo.com/mcp

Zatwierdź logowanie do zaDojo, gdy się otworzy. Jeśli się nie otworzy, uruchom codex mcp login zadojo.

Codex w aplikacji desktopowej ChatGPT

Wtyczka Codex zawiera też skille. Dla samego połączenia:

  1. Otwórz Codex, a potem przejdź do Settings > MCP servers > Add server.
  2. Wpisz nazwę zadojo, wybierz Streamable HTTP i wklej https://app.zadojo.com/mcp.
  3. Zapisz, a potem kliknij Restart, gdy Codex o to poprosi.
  4. Kliknij Authenticate obok zaDojo i zatwierdź logowanie.
  5. Otwórz nowy czat Codex i wykonaj sprawdzenie połączenia.

To połączenie obejmuje tylko Codex. ChatGPT w przeglądarce potrzebuje własnego. Źródłem od OpenAI jest dokumentacja Codex MCP.

ChatGPT

Dodaj zaDojo jako własne połączenie MCP z OAuth. Działa w ChatGPT Free i w planach płatnych, choć administratorzy przestrzeni roboczej mogą blokować własne połączenia. Przewodnik ChatGPT przeprowadza przez każdy ekran.

VS Code, Windsurf i Gemini CLI

Każdy z nich ma własną stronę z dokładną konfiguracją, kluczem API i instalacją skilli:

Inne klienty MCP

Każdy klient, który łączy się ze zdalnym serwerem MCP przez streamable HTTP i obsługuje logowanie OAuth, może użyć powyższego adresu. Jeśli klient nie obsługuje OAuth, wyślij klucz API w nagłówku, jak opisano poniżej.

KlientGdzie go dodaćKonfiguracja
ZedSettings > AI > MCP Servers > Add Remote Server"context_servers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } }
ClineMCP Servers > Remote Servers lub cline mcp add zadojo https://app.zadojo.com/mcp --transport http"type": "streamableHttp", "url": "https://app.zadojo.com/mcp"
opencodeopencode.json"mcp": { "zadojo": { "type": "remote", "url": "https://app.zadojo.com/mcp" } }
Goosegoose configure > Add Extension > Remote Extension (Streamable HTTP)type: streamable_http, uri: https://app.zadojo.com/mcp
Kiro~/.kiro/settings/mcp.json"mcpServers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } }
WarpSettings > Agents > MCP servers > Add > Streamable HTTP or SSE Server (URL){ "zadojo": { "url": "https://app.zadojo.com/mcp" } }
JetBrains Junie~/.junie/mcp/mcp.json, potem /mcp > Authorize"zadojo": { "url": "https://app.zadojo.com/mcp" }

Wszystkie otwierają logowanie do zaDojo w przeglądarce przy pierwszym połączeniu.

Połączenie z kluczem API

Klucz API zastępuje logowanie w przeglądarce. Używaj go w pipeline'ach CI, na zdalnych serwerach, w agentach takich jak Hermes, gdzie logowanie nie działa, oraz w każdym kliencie bez obsługi OAuth.

Klucz należy osobiście do Ciebie. Wszystko, co agent z nim zrobi, dzieje się jako Twoje konto w Twojej przestrzeni roboczej, więc przechowuj go jako sekret i nigdy nie commituj do repozytorium.

Aby go utworzyć, otwórz Settings w aplikacji zaDojo, znajdź API keys i kliknij Create API key. Skopiuj klucz od razu, bo zaDojo pokazuje go tylko raz. Klucze zaczynają się od zadojo_.

Claude Code:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp --header "Authorization: Bearer zadojo_YOUR_KEY"

Cursor: dodaj blok headers do wpisu zaDojo w mcp.json:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp",
      "headers": {
        "Authorization": "Bearer zadojo_YOUR_KEY"
      }
    }
  }
}

Codex CLI: trzymaj klucz w zmiennej środowiskowej i wskaż ją Codex:

export ZADOJO_API_KEY=zadojo_YOUR_KEY
codex mcp add zadojo --url https://app.zadojo.com/mcp --bearer-token-env-var ZADOJO_API_KEY

Każdy inny klient: wysyłaj z każdym żądaniem Authorization: Bearer zadojo_YOUR_KEY albo x-api-key: zadojo_YOUR_KEY.

Aby unieważnić klucz, otwórz tę samą sekcję API keys i usuń go.

Sprawdź połączenie

Otwórz nowy czat lub sesję i wyślij:

Użyj zaDojo, aby sprawdzić moje połączenie i wyświetlić moje projekty.

Agent powinien wywołać whoami i list_projects. Dostaniesz swoje konto, pozostałe saldo kredytów i projekty albo pustą listę, jeśli jeszcze żadnych nie masz. Oba narzędzia są darmowe. Jeśli agent opisuje MCP zamiast wywołać narzędzie, serwer nie jest załadowany w tej sesji: przeładuj klienta lub rozpocznij nowy czat.

Dostępne narzędzia

Serwer ma ponad 80 narzędzi. Tabela grupuje je według zadań. Nazwy narzędzi to te, które widzi Twój agent.

ObszarGłówne narzędziaKredyty
Konto i projektywhoami, list_projects, create_project, get_project_context, update_project_contextDarmowe
Badanie słów kluczowychresearch_keywords (pomysły z 1 do 5 fraz bazowych), get_keyword_metrics (wolumen, trudność, intencja, CPC i trendy dla maksymalnie 700 słów kluczowych), search_serp_locationsPłatne, poza wyszukiwaniem lokalizacji
Wyniki Googleget_serp_results (organiczne wyniki na żywo dla 1 do 10 słów kluczowych), find_serp_competitorsPłatne
Badanie domenget_domain_overview, get_ranked_keywords, get_domain_keyword_suggestionsPłatne
Backlinkiget_backlinks_overview, get_backlinks_profilePłatne
Zapisane słowa kluczowelist_saved_keywords, save_keywords, remove_saved_keywordsDarmowe
Śledzenie pozycjicreate_rank_tracker, add_rank_tracking_keywords, estimate_rank_tracker_cost, run_rank_tracker, get_rank_tracker, pin_rank_tracking_keywords, remove_rank_tracking_keywordsSprawdzenia płatne, konfiguracja i odczyty darmowe
Audyt stronyrun_site_audit, get_audit_status, get_audit_issues, get_audit_pages, list_site_audits, delete_site_auditDarmowy bez Lighthouse i renderowania JavaScript
Lokalne SEOsearch_local_businesses, get_local_serp_results (Mapy lub Local Finder), get_local_rank_grid, get_business_profile, get_business_reviews, get_business_updates, get_google_business_questions, list_business_categoriesPłatne, poza wyszukiwaniem kategorii
Google Search Consoleget_search_console_performance, get_search_console_insights (strony z niskim CTR, kanibalizowane zapytania, wzrosty i spadki kliknięć), get_search_console_hourly (ostatnie 48 godzin), get_search_console_sitemaps, inspect_urls (do 10 adresów URL na wywołanie)Darmowe
Google Analyticsget_google_analytics_organic_overview, get_google_analytics_organic_landing_pages, get_google_analytics_page_performance, get_google_analytics_traffic_acquisition, get_google_analytics_key_events, get_google_analytics_ecommerce_performance, get_google_analytics_site_search, get_google_analytics_audience_breakdown, get_google_analytics_measurement_health, get_google_analytics_traffic_overview, get_google_analytics_breakdown, get_google_analytics_realtime_users, get_search_opportunitiesDarmowe
Widoczność w AIresearch_ai_visibility_prompts, explore_prompt, generate_ai_visibility_prompts, save_ai_visibility_tracker, estimate_ai_visibility_cost, set_ai_visibility_schedule, run_ai_visibility_checkPłatne
Wyniki widoczności w AIget_ai_visibility_tracker, get_ai_visibility_run, get_ai_visibility_results, get_ai_visibility_answer, get_ai_visibility_sources, get_ai_visibility_trend, export_ai_visibility_dataDarmowe
Raportysave_report, list_reports, get_report, delete_report, set_report_sharing, list_report_templates, save_report_template, delete_report_templateDarmowe

Kilka zachowań, które warto znać:

  • Kontekst projektu to wspólna pamięć projektu: opis firmy, bieżący cel, pozycjonowanie, preferencje dotyczące pisania, konkurenci, kluczowe podstrony i dziennik badań. Agenci czytają go przed rozpoczęciem pracy, a aplikacja i inni agenci widzą te same wpisy.
  • Raporty zapisane przez agenta pojawiają się w projekcie, gdzie cały zespół może je czytać, drukować lub eksportować. Nowe raporty są prywatne. Publiczny link powstaje tylko wtedy, gdy poprosisz agenta o wywołanie set_report_sharing z public: true, a public: false go unieważnia. get_report zwraca report.shareUrl, gdy publiczny link istnieje, albo null, gdy go nie ma.
  • Narzędzia Search Console i Google Analytics czytają usługę już podłączoną do projektu. Dostęp jest tylko do odczytu.
  • Najpierw szacunki dla wszystkiego, co cykliczne. Śledzenie pozycji i śledzenie AI mają narzędzia do szacowania, więc agent pokaże Ci koszt, zanim zaplanuje sprawdzenia.

Co zużywa kredyty

Kredyty pochodzą z salda zaDojo. 1000 kredytów to 1 €, a plan za 10 € miesięcznie zawiera 10 € na korzystanie. Typowe ceny:

DziałanieTypowy koszt
Wyszukiwanie słów kluczowychokoło 0,07 €
Przegląd domeny lub backlinków z 12 miesiącami historiiokoło 0,10 €
Lokalne sprawdzenie w Mapach lub Local Finderokoło 0,006 €
Jedno sprawdzenie promptu AI w jednym silnikuokoło 0,002 €
Prompt Research dla jednego słowa kluczowegookoło 0,25 €
Cotygodniowe śledzenie 100 słów kluczowych na jednym urządzeniuokoło 1 do 2 € miesięcznie

Darmowe: sprawdzenia konta, kontekst projektu, zapisane słowa kluczowe, raporty, Search Console, Google Analytics, zwykłe audyty strony oraz odczyt zebranych już wyników śledzenia pozycji, audytów i widoczności w AI. Agenci podłączeni do zaDojo mają polecenie, aby zapytać Cię przed zaplanowaną serią powyżej 2000 kredytów (około 2 €). Gdy saldo spadnie do zera, płatne narzędzia zatrzymują się do czasu doładowania. Kalkulator znajdziesz w cenniku.

Po podłączeniu

Połączenie daje agentowi dane. Skille mówią mu, co z nimi zrobić krok po kroku. Jeśli używasz MCP bez wtyczki, zainstaluj teraz skille.

Daj agentowi jedno konkretne zadanie, zamiast prosić go, by "zrobił SEO":

Przewodnik po widoczności w AI opisuje silniki, zakres i koszty śledzenia odpowiedzi AI.

Rozwiązywanie problemów

Klient nie może się połączyć. Sprawdź, czy adres to dokładnie https://app.zadojo.com/mcp, z https:// i bez spacji na końcu.

Codex zgłasza Authorization server response missing required issuer: expected https://app.zadojo.com. Wydania Codex od 0.143 do 0.146 gubią issuer podczas OAuth. Zaktualizuj Codex CLI lub aplikację desktopową Codex do 0.147.0 lub nowszej albo użyj klucza API.

Logowanie się nie udaje lub ciągle wygasa. Usuń serwer zaDojo z klienta, dodaj go ponownie i powtórz logowanie.

Agent nie może znaleźć projektu. Poproś go, aby najpierw wywołał list_projects i używał zwróconego ID projektu w kolejnych wywołaniach. Jeśli nie masz projektów, poproś go o utworzenie projektu dla Twojej domeny przez create_project, co jest darmowe.

Płatne narzędzie zgłasza brak kredytów. W płatnym planie kup doładowanie w sekcji rozliczeń w aplikacji albo poczekaj na odnowienie miesięcznych kredytów. W okresie próbnym wykup subskrypcję, aby dalej korzystać z płatnych narzędzi.

Nadal masz problem? Napisz na hello@zadojo.com, podając nazwę i wersję klienta oraz dokładny błąd. Nigdy nie dołączaj kluczy API.