Server MCP zaDojo: Claude, Cursor, Codex

zaDojo rulează un server MCP la distanță, la care se poate conecta orice client care suportă MCP la distanță. MCP (Model Context Protocol) e modul standard prin care aplicațiile AI apelează unelte externe. Prin el, agentul tău poate cerceta cuvinte cheie, citi rezultate Google în timp real, verifica pozițiile și backlinkurile oricărui domeniu, rula audituri de site, urmări poziții și răspunsuri AI și citi datele tale din Search Console și Google Analytics.

Adresa serverului:

https://app.zadojo.com/mcp

Prima dată când se conectează, clientul deschide în browser autentificarea zaDojo și îți cere să aprobi accesul. După aceea, clientul poate folosi uneltele pentru proiectele pe care le vezi tu. Pentru joburi CI și servere fără browser, folosește o cheie API.

Utilizatorii Claude Code și Codex câștigă mai mult cu pluginul, care adaugă această conexiune și cele douăsprezece skill-uri zaDojo dintr-o singură instalare. Urmează pașii de pe această pagină când vrei doar conexiunea MCP sau când clientul tău nu are plugin. Ghidul de configurare a agentului are un prompt care alege calea potrivită pentru tine.

De ce ai nevoie

• Un cont zaDojo. Înregistrează-te și primești 0,10 € credite de probă, fără card.
• Un client care suportă servere MCP la distanță prin HTTP: Claude Code, Claude Desktop, Cursor, Codex CLI, Codex din aplicația desktop ChatGPT, ChatGPT cu o conexiune personalizată, VS Code cu Copilot, Windsurf (Devin Desktop), Gemini CLI, Zed sau similar.
• Un browser pentru autentificare sau o cheie API pentru utilizare fără interfață.

Pagina Agent setup din aplicație arată aceeași adresă, cu un buton de copiere. Vrei să încerci datele zaDojo înainte să te înregistrezi? Uneltele SEO gratuite nu cer cont.

Conectează-ți clientul

Claude Code

Pluginul Claude Code e alegerea mai bună pentru majoritatea oamenilor. Doar pentru conexiune, rulează asta într-un terminal:

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

--scope user face zaDojo disponibil în toate proiectele de pe calculatorul tău. Folosește --scope local ca să-l limitezi la repository-ul curent. Claude Code îți cere apoi să te autentifici în zaDojo. Dacă cererea nu apare, rulează /mcp, selectează zaDojo și finalizează autentificarea de acolo.

Claude Desktop

Pe un plan Claude plătit, pluginul zaDojo adaugă împreună conexiunea și skill-urile. Pe planul Free, sau doar pentru conexiune, adaugă un conector personalizat:

1. Deschide Customize > Connectors.
2. Apasă Add sau + și alege Add custom connector.
3. Lipește https://app.zadojo.com/mcp.
4. Autentifică-te în zaDojo și aprobă accesul.

Conectorii personalizați funcționează pe Claude Free, Pro, Max, Team și Enterprise. Planul Free permite un singur conector personalizat.

Cursor

1. Deschide Customize și mergi la serverele MCP, sau editează direct ~/.cursor/mcp.json.
2. Adaugă intrarea zaDojo:

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

3. Salvează fișierul și aprobă autentificarea zaDojo când îți cere Cursor.

Ghidul Cursor are un link de instalare cu un clic și instalarea skill-urilor.

Codex CLI

Pluginul Codex adaugă împreună conexiunea și skill-urile. Doar pentru conexiune:

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

Aprobă autentificarea zaDojo când se deschide. Dacă nu se deschide, rulează codex mcp login zadojo.

Codex în aplicația desktop ChatGPT

Pluginul Codex include și skill-urile. Doar pentru conexiune:

1. Deschide Codex, apoi mergi la Settings > MCP servers > Add server.
2. Introdu numele zadojo, alege Streamable HTTP și lipește https://app.zadojo.com/mcp.
3. Salvează, apoi apasă Restart când îți cere Codex.
4. Apasă Authenticate lângă zaDojo și aprobă autentificarea.
5. Deschide un chat Codex nou și rulează verificarea conexiunii.

Această conexiune acoperă doar Codex. ChatGPT pe web are nevoie de propria conexiune. Referința OpenAI este documentația MCP pentru Codex.

ChatGPT

Adaugă zaDojo ca o conexiune MCP personalizată cu OAuth. Funcționează pe ChatGPT Free și pe planurile plătite, deși administratorii de workspace pot bloca conexiunile personalizate. Ghidul ChatGPT parcurge fiecare ecran.

VS Code, Windsurf și Gemini CLI

Fiecare are pagina lui, cu configurarea exactă, setarea cheii API și instalarea skill-urilor:

• VS Code cu GitHub Copilot
• Windsurf (Devin Desktop)
• Gemini CLI și Antigravity CLI

Alți clienți MCP

Orice client care poate ajunge la un server MCP la distanță prin streamable HTTP și suportă autentificare OAuth poate folosi adresa de mai sus. Dacă clientul nu poate face OAuth, trimite o cheie API într-un header, cum e descris mai jos.

Toți acești clienți deschid autentificarea zaDojo în browser prima dată când se conectează.

Conectare cu o cheie API

O cheie API înlocuiește autentificarea din browser. Folosește una pentru pipeline-uri CI, servere la distanță, agenți precum Hermes, unde fluxul de autentificare nu merge, sau orice client fără suport OAuth.

O cheie îți aparține personal. Orice face un agent cu ea rulează ca fiind contul tău, în workspace-ul tău, așa că păstreaz-o ca secret și nu o pune niciodată într-un repository.

Ca să creezi una, deschide Settings în aplicația zaDojo, găsește API keys și apasă Create API key. Copiază cheia imediat, pentru că zaDojo o afișează o singură dată. Cheile încep cu zadojo_.

Claude Code:

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

Cursor: adaugă un bloc headers la intrarea zaDojo din mcp.json:

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

Codex CLI: păstrează cheia într-o variabilă de mediu și indic-o lui 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

Orice alt client: trimite fie Authorization: Bearer zadojo_YOUR_KEY, fie x-api-key: zadojo_YOUR_KEY cu fiecare cerere.

Ca să revoci o cheie, deschide aceeași secțiune API keys și șterge-o.

Verifică conexiunea

Deschide un chat sau o sesiune nouă și trimite:

Folosește zaDojo ca să-mi verifici conexiunea și să-mi listezi proiectele.

Agentul ar trebui să apeleze whoami și list_projects. Primești contul tău, soldul de credite rămas și proiectele, sau o listă goală dacă nu ai încă niciunul. Ambele unelte sunt gratuite. Dacă agentul descrie MCP în loc să apeleze o unealtă, serverul nu e încărcat în această sesiune: reîncarcă clientul sau pornește un chat nou.

Unelte disponibile

Serverul are peste 80 de unelte. Tabelul le grupează după sarcină. Numele uneltelor sunt cele pe care le vede agentul tău.

Câteva comportamente bune de știut:

• Contextul proiectului e memoria comună a unui proiect: prezentarea afacerii, obiectivul curent, poziționarea, preferințele de scriere, concurenții, paginile cheie și un jurnal de cercetare. Agenții îl citesc înainte să înceapă, iar aplicația și ceilalți agenți văd aceleași informații.
• Rapoartele salvate de un agent apar în proiect, iar toată echipa le poate citi, tipări sau exporta. Rapoartele noi sunt private. Un link public se creează doar când îi ceri agentului să apeleze set_report_sharing cu public: true, iar public: false îl revocă. get_report returnează report.shareUrl când există un link public, sau null când nu există.
• Uneltele Search Console și Google Analytics citesc proprietatea deja conectată la proiect. Accesul e doar de citire.
• Estimările vin primele pentru orice e recurent. Urmărirea pozițiilor și urmărirea AI au unelte de estimare, așa că agentul îți poate arăta costul înainte să programeze verificări.

Ce consumă credite

Creditele vin din soldul tău zaDojo. 1.000 de credite înseamnă 1 €, iar planul de 10 € pe lună include 10 € de utilizare. Prețuri obișnuite:

Gratuite: verificările de cont, contextul proiectului, cuvintele cheie salvate, rapoartele, Search Console, Google Analytics, auditurile simple de site și citirea rezultatelor de urmărire a pozițiilor, de audit sau de vizibilitate în AI pe care le-ai colectat deja. Agenții conectați la zaDojo au instrucțiuni să te întrebe înainte de un lot planificat de peste 2.000 de credite (cam 2 €). Când soldul ajunge la zero, uneltele plătite se opresc până reîncarci. Vezi prețurile pentru calculator.

După ce te conectezi

Conexiunea îi dă agentului date. Skill-urile îi spun ce să facă cu ele, pas cu pas. Dacă ai folosit MCP fără plugin, instalează skill-urile în continuare.

Dă-i agentului o sarcină concretă în loc să-i ceri să „facă SEO":

• SEO Project Setup: salvează obiectivul, poziționarea, concurenții și paginile cheie, ca fiecare sarcină ulterioară să pornească de la ele.
• SEO Coach: primești un singur pas următor recomandat dacă ești nou în SEO.
• SEO Audit: găsește puținele schimbări care pot crește cel mai mult traficul.
• Keyword Research și Keyword Clustering: găsește termenii de căutare care merită țintiți și grupează-i în pagini.
• Competitive Landscape și Competitor Analysis: cartografiază o piață sau studiază în detaliu un rival.
• Link Prospecting: găsește site-uri care ar putea da link către o pagină și scrie mesaje de outreach.
• AI Prompt Research și AI Visibility Audit: vezi ce spun uneltele AI despre piața ta și de ce sunt menționați concurenții.

Ghidul de vizibilitate în AI acoperă motoarele, acoperirea și costurile urmăririi răspunsurilor AI.

Depanare

Clientul nu se poate conecta. Verifică dacă adresa este exact https://app.zadojo.com/mcp, cu https:// și fără spații la final.

Codex raportează Authorization server response missing required issuer: expected https://app.zadojo.com. Versiunile Codex 0.143-0.146 pierd issuer-ul în timpul OAuth. Actualizează Codex CLI sau aplicația desktop Codex la 0.147.0 sau mai nou, ori folosește o cheie API.

Autentificarea eșuează sau expiră mereu. Șterge serverul zaDojo din client, adaugă-l din nou și repetă autentificarea.

Agentul nu găsește un proiect. Cere-i să apeleze întâi list_projects și să refolosească ID-ul de proiect primit în apelurile următoare. Dacă nu ai proiecte, cere-i să creeze unul pentru domeniul tău cu create_project, care e gratuit.

O unealtă plătită spune că ai rămas fără credite. Pe planul plătit, cumpără o reîncărcare din secțiunea de facturare a aplicației sau așteaptă resetarea creditelor lunare. În perioada de probă, abonează-te ca să folosești în continuare uneltele plătite.

Tot nu merge? Scrie la hello@zadojo.com cu numele și versiunea clientului și eroarea exactă. Nu include niciodată chei API.