MCP сървър на zaDojo: за Claude, Cursor и Codex

zaDojo има отдалечен MCP сървър, към който може да се свърже всеки клиент с поддръжка на отдалечен MCP. MCP (Model Context Protocol) е стандартният начин AI приложенията да викат външни инструменти. Чрез него агентът ти може да проучва ключови думи, да чете резултатите в Google на живо, да преглежда позициите и backlinks на всеки домейн, да пуска одити на сайтове, да следи позиции и AI отговори и да чете собствените ти данни от Search Console и Google Analytics.

Адресът на сървъра:

https://app.zadojo.com/mcp

Първия път, когато клиент се свърже, той отваря вход в zaDojo в браузъра ти и те моли да одобриш достъпа. След това клиентът може да ползва инструментите за проектите, които виждаш. За CI задачи и сървъри без браузър използвай API ключ.

Потребителите на Claude Code и Codex получават повече от плъгина, който добавя тази връзка и дванадесетте умения на zaDojo с една инсталация. Използвай стъпките на тази страница, когато искаш само MCP връзката или когато клиентът ти няма плъгин. Ръководството за настройка на агента има промпт, който избира правилния път вместо теб.

Какво ти трябва

• Акаунт в zaDojo. Регистрирай се и получаваш 0,10 € пробни кредити без карта.
• Клиент, който поддържа отдалечени MCP сървъри през HTTP: Claude Code, Claude Desktop, Cursor, Codex CLI, Codex в десктоп приложението ChatGPT, ChatGPT с custom връзка, VS Code с Copilot, Windsurf (Devin Desktop), Gemini CLI, Zed или подобен.
• Браузър за входа или API ключ за работа без браузър.

Страницата Agent setup в приложението показва същия адрес с бутон за копиране. Искаш да пробваш данните на zaDojo преди регистрация? Безплатните SEO инструменти не изискват акаунт.

Свържи клиента си

Claude Code

Плъгинът за Claude Code е по-добрият избор за повечето хора. Само за връзката пусни това в терминал:

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

--scope user прави zaDojo достъпен във всеки проект на машината ти. Използвай --scope local, за да го ограничиш до текущото хранилище. След това Claude Code те моли да влезеш в zaDojo. Ако запитването не се появи, пусни /mcp, избери zaDojo и завърши входа оттам.

Claude Desktop

С платен план на Claude плъгинът на zaDojo добавя връзката и уменията заедно. С план Free или само за връзката добави custom connector:

1. Отвори Customize > Connectors.
2. Натисни Add или + и избери Add custom connector.
3. Постави https://app.zadojo.com/mcp.
4. Влез в zaDojo и одобри достъпа.

Custom connectors работят в Claude Free, Pro, Max, Team и Enterprise. Планът Free позволява един custom connector.

Cursor

1. Отвори Customize и отиди в MCP servers или редактирай директно ~/.cursor/mcp.json.
2. Добави записа за zaDojo:

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

3. Запази файла и одобри входа в zaDojo, когато Cursor попита.

Ръководството за Cursor има линк за инсталиране с един клик и инсталацията на уменията.

Codex CLI

Плъгинът за Codex добавя връзката и уменията заедно. Само за връзката:

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

Одобри входа в zaDojo, когато се отвори. Ако не се отвори, пусни codex mcp login zadojo.

Codex в десктоп приложението ChatGPT

Плъгинът за Codex включва и уменията. Само за връзката:

1. Отвори Codex, после отиди в Settings > MCP servers > Add server.
2. Въведи името zadojo, избери Streamable HTTP и постави https://app.zadojo.com/mcp.
3. Запази, после натисни Restart, когато Codex попита.
4. Натисни Authenticate до zaDojo и одобри входа.
5. Отвори нов чат в Codex и направи проверката на връзката.

Тази връзка покрива само Codex. ChatGPT в уеб има нужда от своя. Справочникът на OpenAI е документацията за MCP в Codex.

ChatGPT

Добави zaDojo като custom MCP връзка с OAuth. Работи в ChatGPT Free и в платените планове, макар администраторите на работни пространства да могат да блокират custom връзките. Ръководството за ChatGPT минава през всеки екран.

VS Code, Windsurf и Gemini CLI

Всеки има своя страница с точната конфигурация, настройката с API ключ и инсталацията на уменията:

• VS Code с GitHub Copilot
• Windsurf (Devin Desktop)
• Gemini CLI и Antigravity CLI

Други MCP клиенти

Всеки клиент, който достига отдалечен MCP сървър през streamable HTTP и поддържа вход с OAuth, може да използва адреса по-горе. Ако клиентът не поддържа OAuth, изпращай API ключ в хедър, както е описано по-долу.

Всички те отварят входа в zaDojo в браузъра при първото свързване.

Свързване с API ключ

API ключът заменя входа през браузъра. Използвай го за CI процеси, отдалечени сървъри, агенти като Hermes, при които входът не работи, или всеки клиент без поддръжка на OAuth.

Ключът е лично твой. Всичко, което агент прави с него, се изпълнява от твоя акаунт в твоето работно пространство, затова го пази като тайна и никога не го къмитвай в хранилище.

За да създадеш ключ, отвори Settings в приложението zaDojo, намери API keys и натисни Create API key. Копирай ключа веднага, защото zaDojo го показва само веднъж. Ключовете започват с zadojo_.

Claude Code:

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

Cursor: добави блок headers към записа за zaDojo в mcp.json:

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

Codex CLI: пази ключа в променлива на средата и насочи 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

Всеки друг клиент: изпращай Authorization: Bearer zadojo_YOUR_KEY или x-api-key: zadojo_YOUR_KEY с всяка заявка.

За да отмениш ключ, отвори същата секция API keys и го премахни.

Провери връзката

Отвори нов чат или сесия и изпрати:

Използвай zaDojo, за да провериш връзката ми и да изброиш проектите ми.

Агентът трябва да извика whoami и list_projects. Получаваш акаунта си, оставащия баланс от кредити и проектите си или празен списък, ако още нямаш. И двата инструмента са безплатни. Ако агентът описва MCP, вместо да извика инструмент, сървърът не е зареден в тази сесия: презареди клиента или започни нов чат.

Налични инструменти

Сървърът има над 80 инструмента. Таблицата ги групира по задача. Имената на инструментите са това, което вижда агентът ти.

Няколко неща, които е добре да знаеш:

• Контекстът на проекта е обща памет за проекта: описание на бизнеса, текуща цел, позициониране, предпочитания за писане, конкуренти, ключови страници и дневник на проучванията. Агентите го четат, преди да започнат, а приложението и другите агенти виждат същите записи.
• Отчетите, запазени от агент, се появяват в проекта, за да ги чете, печата или експортира целият ти екип. Новите отчети са лични. Публичен линк се създава само когато помолиш агента да извика set_report_sharing с public: true, а public: false го отменя. get_report връща report.shareUrl, когато има публичен линк, или null, когато няма.
• Инструментите за Search Console и Google Analytics четат свойството, което вече е свързано с проекта. Достъпът е само за четене.
• Първо идва прогнозата за всичко, което се повтаря. Следенето на позиции и следенето в AI имат инструменти за прогноза, така че агентът може да ти покаже цената, преди да насрочи проверки.

Какво харчи кредити

Кредитите идват от баланса ти в zaDojo. 1000 кредита са равни на 1 €, а планът за 10 € на месец включва 10 € за използване. Обичайни цени:

Безплатно: проверките на акаунта, контекстът на проекта, запазените ключови думи, отчетите, Search Console, Google Analytics, обикновените одити на сайта и четенето на вече събрани резултати от следене на позиции, одити или видимост в AI. Агентите, свързани със zaDojo, са инструктирани да те питат преди планирана поредица над 2000 кредита (около 2 €). Когато балансът стигне нула, платените инструменти спират, докато не заредиш. Виж цените за калкулатора.

След като се свържеш

Връзката дава данни на агента ти. Уменията му казват какво да прави с тях, стъпка по стъпка. Ако си използвал MCP без плъгин, следващата стъпка е да инсталираш уменията.

Дай на агента една конкретна задача, вместо да го молиш да „прави SEO“:

• SEO Project Setup: запази целта, позиционирането, конкурентите и ключовите си страници, така че всяка следваща задача да започва от тях.
• SEO Coach: получи една препоръчана следваща стъпка, ако си нов в SEO.
• SEO Audit: намери малкото промени, които най-вероятно ще увеличат трафика.
• Keyword Research и Keyword Clustering: намери думи за търсене, които си струва да таргетираш, и ги групирай в страници.
• Competitive Landscape и Competitor Analysis: картографирай пазар или проучи в дълбочина един съперник.
• Link Prospecting: намери сайтове, които може да дадат линк към страница, и напиши чернови на писма.
• AI Prompt Research и AI Visibility Audit: виж какво казват AI инструментите за пазара ти и защо се споменават конкурентите.

Ръководството за видимост в AI покрива машините, обхвата и цените на следенето на AI отговори.

Отстраняване на проблеми

Клиентът не може да се свърже. Провери дали адресът е точно https://app.zadojo.com/mcp, с https:// и без интервали накрая.

Codex съобщава Authorization server response missing required issuer: expected https://app.zadojo.com. Версиите на Codex от 0.143 до 0.146 губят issuer по време на OAuth. Обнови Codex CLI или десктоп приложението Codex до 0.147.0 или по-нова версия или използвай API ключ.

Входът се проваля или постоянно изтича. Премахни сървъра zaDojo от клиента, добави го отново и повтори входа.

Агентът не може да намери проект. Помоли го първо да извика list_projects и да използва върнатия ID на проекта в следващите извиквания. Ако нямаш проекти, помоли го да създаде такъв за домейна ти с create_project, което е безплатно.

Платен инструмент казва, че нямаш кредити. С платения план купи допълнителни кредити от billing в приложението или изчакай месечните кредити да се подновят. В пробния период се абонирай, за да продължиш да ползваш платените инструменти.

Още не става? Пиши на hello@zadojo.com с името и версията на клиента си и точната грешка. Никога не включвай API ключове.