zaDojo MCP szerver: Claude, Cursor, Codex

A zaDojo távoli MCP szervert futtat, amelyhez bármely távoli MCP-t támogató kliens csatlakozhat. Az MCP (Model Context Protocol) az a szabvány, amellyel az AI-alkalmazások külső eszközöket hívnak. Ezen keresztül az ügynököd kulcsszavakat kutathat, élő Google-találatokat olvashat, bármely domain helyezéseit és backlinkjeit lekérheti, oldalauditokat futtathat, követheti a helyezéseket és az AI-válaszokat, és olvashatja a saját Search Console- és Google Analytics-adataidat.

A szerver címe:

https://app.zadojo.com/mcp

Amikor egy kliens először csatlakozik, megnyit egy zaDojo bejelentkezést a böngésződben, és hozzáférés jóváhagyását kéri. Ezután a kliens azokban a projektekben használhatja az eszközöket, amelyeket te is látsz. CI-feladatokhoz és böngésző nélküli szerverekhez használj API-kulcsot.

A Claude Code és a Codex felhasználói többet kapnak a pluginnal, amely ezt a kapcsolatot és a tizenkét zaDojo skillt egyetlen telepítéssel adja hozzá. Az ezen az oldalon lévő lépéseket akkor használd, ha csak az MCP-kapcsolatra van szükséged, vagy ha a kliensednek nincs pluginja. Az ügynökbeállítási útmutatóban van egy prompt, amely kiválasztja neked a megfelelő utat.

Mire van szükséged

• Egy zaDojo fiókra. Regisztrálj, és bankkártya nélkül kapsz 0,10 € próbakreditet.
• Egy kliensre, amely HTTP-n keresztül támogatja a távoli MCP szervereket: Claude Code, Claude Desktop, Cursor, Codex CLI, Codex a ChatGPT asztali alkalmazásban, ChatGPT egyéni kapcsolattal, VS Code Copilottal, Windsurf (Devin Desktop), Gemini CLI, Zed vagy hasonló.
• Egy böngészőre a bejelentkezéshez, vagy API-kulcsra fej nélküli (headless) használathoz.

Az alkalmazáson belüli Agent setup oldal ugyanezt a címet mutatja egy másolás gombbal. Regisztráció előtt kipróbálnád a zaDojo adatait? Az ingyenes SEO-eszközökhöz nem kell fiók.

A kliensed csatlakoztatása

Claude Code

A legtöbb embernek a Claude Code plugin a jobb választás. Csak a kapcsolathoz futtasd ezt egy terminálban:

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

A --scope user a géped minden projektjében elérhetővé teszi a zaDojót. A --scope local az aktuális repositoryra korlátozza. A Claude Code ezután zaDojo bejelentkezést kér. Ha a kérés nem jelenik meg, futtasd a /mcp parancsot, válaszd a zaDojót, és ott fejezd be a bejelentkezést.

Claude Desktop

Fizetős Claude-csomagon a zaDojo plugin együtt adja hozzá a kapcsolatot és a skilleket. A Free csomagon, vagy ha csak a kapcsolatot szeretnéd, adj hozzá egyéni connectort:

1. Nyisd meg a Customize > Connectors részt.
2. Kattints az Add vagy a + gombra, és válaszd az Add custom connector lehetőséget.
3. Illeszd be: https://app.zadojo.com/mcp.
4. Jelentkezz be a zaDojóba, és hagyd jóvá a hozzáférést.

Az egyéni connectorok a Claude Free, Pro, Max, Team és Enterprise csomagon működnek. A Free csomag egy egyéni connectort enged.

Cursor

1. Nyisd meg a Customize menüt, és menj az MCP szerverekhez, vagy szerkeszd közvetlenül a ~/.cursor/mcp.json fájlt.
2. Add hozzá a zaDojo bejegyzést:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}

3. Mentsd a fájlt, és hagyd jóvá a zaDojo bejelentkezést, amikor a Cursor kéri.

A Cursor útmutatóban egykattintásos telepítési link és a skillek telepítése is szerepel.

Codex CLI

A Codex plugin együtt adja hozzá a kapcsolatot és a skilleket. Csak a kapcsolathoz:

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

Hagyd jóvá a zaDojo bejelentkezést, amikor megnyílik. Ha nem nyílik meg, futtasd a codex mcp login zadojo parancsot.

Codex a ChatGPT asztali alkalmazásban

A Codex plugin a skilleket is tartalmazza. Csak a kapcsolathoz:

1. Nyisd meg a Codex részt, majd menj a Settings > MCP servers > Add server menüpontra.
2. Add meg a zadojo nevet, válaszd a Streamable HTTP opciót, és illeszd be: https://app.zadojo.com/mcp.
3. Mentsd, majd kattints a Restart gombra, amikor a Codex kéri.
4. Kattints az Authenticate gombra a zaDojo mellett, és hagyd jóvá a bejelentkezést.
5. Nyiss új Codex chatet, és futtasd a kapcsolat ellenőrzését.

Ez a kapcsolat csak a Codexre vonatkozik. A webes ChatGPT-nek külön kapcsolat kell. Az OpenAI referenciája a Codex MCP dokumentáció.

ChatGPT

Add hozzá a zaDojót egyéni MCP-kapcsolatként OAuth-tal. A ChatGPT Free és a fizetős csomagokon is működik, bár a munkaterület-adminisztrátorok letilthatják az egyéni kapcsolatokat. A ChatGPT útmutató minden képernyőn végigvezet.

VS Code, Windsurf és Gemini CLI

Mindegyiknek saját oldala van a pontos konfigurációval, API-kulcsos beállítással és a skillek telepítésével:

• VS Code GitHub Copilottal
• Windsurf (Devin Desktop)
• Gemini CLI és Antigravity CLI

Más MCP-kliensek

Bármely kliens, amely streamable HTTP-n eléri a távoli MCP szervert, és támogatja az OAuth-bejelentkezést, használhatja a fenti címet. Ha a kliens nem tud OAuth-ot, küldj API-kulcsot fejlécben, ahogy alább leírjuk.

Ezek mind megnyitják a zaDojo bejelentkezést a böngésződben az első csatlakozáskor.

Csatlakozás API-kulccsal

Az API-kulcs a böngészős bejelentkezést váltja ki. CI-folyamatokhoz, távoli szerverekhez, olyan ügynökökhöz, mint a Hermes, ahol a bejelentkezési folyamat nem működik, vagy bármely OAuth-támogatás nélküli klienshez használd.

A kulcs személyesen a tiéd. Bármit csinál vele egy ügynök, az a te fiókodként fut a munkaterületeden, ezért titokként tárold, és soha ne commitold repositoryba.

Létrehozásához nyisd meg a zaDojo alkalmazásban a Settings oldalt, keresd meg az API keys részt, és kattints a Create API key gombra. Rögtön másold ki a kulcsot, mert a zaDojo csak egyszer mutatja meg. A kulcsok zadojo_ előtaggal kezdődnek.

Claude Code:

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

Cursor: adj egy headers blokkot a zaDojo bejegyzéshez az mcp.json fájlban:

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

Codex CLI: tartsd a kulcsot környezeti változóban, és irányítsd rá a Codexet:

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

Bármely más kliens: minden kéréssel küldd el az Authorization: Bearer zadojo_YOUR_KEY vagy az x-api-key: zadojo_YOUR_KEY fejlécet.

Egy kulcs visszavonásához nyisd meg ugyanezt az API keys részt, és távolítsd el.

A kapcsolat ellenőrzése

Nyiss új chatet vagy munkamenetet, és küldd el:

Használd a zaDojót: ellenőrizd a kapcsolatot, és listázd a projektjeimet.

Az ügynöknek a whoami és a list_projects eszközt kell meghívnia. Visszakapod a fiókodat, a fennmaradó kreditegyenlegedet és a projektjeidet, vagy egy üres listát, ha még nincs projekted. Mindkét eszköz ingyenes. Ha az ügynök eszközhívás helyett az MCP-t magyarázza, a szerver nincs betöltve ebben a munkamenetben: töltsd újra a klienst, vagy indíts új chatet.

Elérhető eszközök

A szervernek több mint 80 eszköze van. A táblázat feladat szerint csoportosítja őket. Az eszközneveket látja az ügynököd.

Néhány működési részlet, amit érdemes tudni:

• A projektkontextus egy projekt közös memóriája: üzleti áttekintés, aktuális cél, pozicionálás, írási preferenciák, versenytársak, kulcsoldalak és kutatási napló. Az ügynökök kezdés előtt elolvassák, és az alkalmazás meg a többi ügynök ugyanazokat a bejegyzéseket látja.
• Az ügynök által mentett riportok megjelennek a projektben, így az egész csapatod olvashatja, nyomtathatja vagy exportálhatja őket. Az új riportok privátak. Nyilvános link csak akkor jön létre, ha megkéred az ügynököt, hogy hívja meg a set_report_sharing eszközt public: true értékkel, a public: false pedig visszavonja. A get_report a report.shareUrl mezőt adja vissza, ha van nyilvános link, ha nincs, akkor null értéket.
• A Search Console és Google Analytics eszközök a projekthez már csatlakoztatott tulajdont olvassák. A hozzáférés csak olvasási.
• Ismétlődő feladatoknál először becslés készül. A rangsorkövetéshez és az AI-követéshez is van becslő eszköz, így az ügynök megmutathatja a költséget, mielőtt ütemezné az ellenőrzéseket.

Mi használ kreditet

A kreditek a zaDojo egyenlegedből jönnek. 1000 kredit 1 €, és a havi 10 €-s csomag 10 € felhasználást tartalmaz. Jellemző árak:

Ingyenes: a fiókellenőrzés, a projektkontextus, a mentett kulcsszavak, a riportok, a Search Console, a Google Analytics, az egyszerű oldalauditok, valamint a már összegyűjtött rangsorkövetési, audit- vagy AI-láthatósági eredmények olvasása. A zaDojóhoz csatlakoztatott ügynökök azt az utasítást kapják, hogy kérdezzenek meg, mielőtt 2000 kredit (kb. 2 €) feletti tervezett köteget futtatnának. Ha az egyenleg nullára csökken, a fizetős eszközök leállnak, amíg fel nem töltöd. A becslőt az árak oldalon találod.

Csatlakozás után

A kapcsolat adatot ad az ügynöködnek. A skillek mondják meg neki, mit kezdjen az adatokkal, lépésről lépésre. Ha plugin nélkül használtad az MCP-t, következő lépésként telepítsd a skilleket.

Adj az ügynöknek egy konkrét feladatot ahelyett, hogy azt kérnéd, „csináljon SEO-t”:

• SEO Project Setup: mentsd el a célodat, pozicionálásodat, versenytársaidat és kulcsoldalaidat, hogy minden későbbi feladat ezekből induljon.
• SEO Coach: kapj egy javasolt következő lépést, ha új vagy az SEO-ban.
• SEO Audit: találd meg azt a néhány változtatást, amely a legvalószínűbben növeli a forgalmat.
• Keyword Research és Keyword Clustering: keress célzásra érdemes keresőkifejezéseket, és csoportosítsd őket oldalakba.
• Competitive Landscape és Competitor Analysis: térképezz fel egy piacot, vagy vizsgálj meg alaposan egy riválist.
• Link Prospecting: keress oldalakat, amelyek linkelhetnének egy oldaladra, és fogalmazz megkereső leveleket.
• AI Prompt Research és AI Visibility Audit: nézd meg, mit mondanak az AI-eszközök a piacodról, és miért a versenytársakat említik.

Az AI-láthatósági útmutató az AI-válaszok követésének motorjait, lefedettségét és költségeit tárgyalja.

Hibaelhárítás

A kliens nem tud csatlakozni. Ellenőrizd, hogy a cím pontosan https://app.zadojo.com/mcp, https:// előtaggal és záró szóközök nélkül.

A Codex ezt jelzi: Authorization server response missing required issuer: expected https://app.zadojo.com. A Codex 0.143-tól 0.146-ig terjedő kiadásai OAuth közben elhagyják az issuert. Frissítsd a Codex CLI-t vagy a Codex asztali alkalmazást 0.147.0-s vagy újabb verzióra, vagy használj API-kulcsot.

A bejelentkezés sikertelen, vagy folyton lejár. Távolítsd el a zaDojo szervert a kliensedből, add hozzá újra, és ismételd meg a bejelentkezést.

Az ügynök nem talál projektet. Kérd meg, hogy először hívja meg a list_projects eszközt, és a későbbi hívásokban használja újra a kapott projektazonosítót. Ha nincs projekted, kérd meg, hogy hozzon létre egyet a domainedhez a create_project eszközzel, ami ingyenes.

Egy fizetős eszköz szerint elfogyott a kredited. Fizetős csomagon vásárolj feltöltést az alkalmazás számlázási részében, vagy várd meg, amíg a havi kreditjeid megújulnak. Próbaidőszakban fizess elő, hogy tovább használhasd a fizetős eszközöket.

Még mindig elakadtál? Írj a hello@zadojo.com címre a kliensed nevével és verziójával, valamint a pontos hibaüzenettel. Soha ne küldj API-kulcsot.