MCP konektor pro klienty
Klienti si přidají codebros care jako custom konektor do Claude nebo ChatGPT. OAuth 2.1 přihlášení portálovým účtem, tools nad vlastními weby, editace sledovaných otázek.
Klient si může přidat care jako MCP konektor do svého AI asistenta (Claude, ChatGPT, případně další klienti podporující remote MCP). Pak se asistenta ptá přímo: "jak je na tom můj web tenhle měsíc", "kdy proběhla poslední záloha", "uprav mi sledované otázky". Návod pro klienty je v portálu v Nastavení, sekce AI asistent.
Technicky
- Endpoint:
POST https://api.care.codebros.cz/mcp(Streamable HTTP, JSON-RPC 2.0, stateless, bez SSE;GETvrací 405). - Autentizace: OAuth 2.1 přes better-auth mcp plugin. Discovery na
/.well-known/oauth-authorization-servera/.well-known/oauth-protected-resource(root originu i pod/api/auth/.well-known/), dynamická registrace klientů, PKCE. Přihlášení probíhá portálovým účtem (authorize přesměruje naportal.care.codebros.cz/prihlasenia po loginu zpět). Access token platí hodinu, refresh týden. - Stejný endpoint obsluhuje i interní kanál: bearer klíč s prefixem
orb_(Orbit API klíč) dostane interní profil s dokumentem "Co care umí". OAuth token dostane klientský profil s tools níže. - Viditelnost dat řídí granty (
user_grants) stejně jako portál: klient vidí jen svoje weby. Cizí nebo neexistující web vrací jednotně "web nenalezen". - Pozor na cookies: OAuth flow spoléhá na same-site subdomény
*.care.codebros.cz(cookieoidc_login_promptje SameSite=Lax na api originu). ZapnutíCOOKIE_CROSS_SITE=trueby flow rozbilo.
Tools
| Tool | Co dělá |
|---|---|
list_my_websites | Seznam webů s tarifem a stavem (výpadek, nefunkční formulář). |
website_status | Uptime, odezva, denní přehled a incidenty (1 až 90 dní). |
website_backups | Posledních 30 záloh (druh, stav, velikost, retence). |
website_search_performance | Kliky, zobrazení a pozice z GSC/Bing, top dotazy. |
website_ai_visibility | Zmínky a citace v odpovědích AI, týdenní podíl zmínek (jen s nárokem na care-ai). |
website_worklog | Posledních 50 záznamů provedené práce. |
list_reports / get_report | Odeslané měsíční reporty, obsah v markdownu. |
get_tracked_questions | Sledované AI otázky a SEO dotazy webu. |
update_tracked_questions | Nahradí AI otázky (max 15) nebo SEO dotazy (max 10). Jediný zápis, který konektor umí. |
Zápisy jsou schválně omezené na totéž, co klient může editovat v portálu (viz Viditelnost v AI a Vyhledávání). GSC, Bing, IndexNow, konkurence ani brand terms přes konektor nejdou.
Omezení klientů
- Claude: custom konektory (Settings, Connectors) fungují na placených plánech; ikona a popis se berou z metadat konektoru.
- ChatGPT: custom MCP konektory vyžadují developer mode a placený plán. Deep research režim navíc očekává tools
searchafetch, které v1 nemá. - Gemini: aplikace custom konektory zatím neumí, Gemini CLI ano (omezený OAuth).
Rate limit a revokace
Endpoint má limit 100 požadavků za minutu na token. Revokace přístupu = smazání řádků v oauth_access_token pro daného uživatele (UI tlačítko zatím není, kandidát na v1.1).