JÁ2 Akademie/ docs

Časté problémy

„Bearer token invalid" / 401

Příčiny:

  • Token byl revoknutý v /konektory → ikona koš
  • Tok ses pokoušel zkopírovat víc než 1× (token se zobrazí jen jednou při vygenerování — vytvoř nový)
  • Špatně paste — chybí prefix ak2_ nebo nějaké znaky se ztratily

Řešení:

  1. Jdi do /konektory
  2. Vygeneruj nový klíč
  3. Aktualizuj config v Claude Desktop / Claude Code
  4. Restart Claude

„Connection timeout" / Claude ne připojí

Příčiny:

  • Akademie není dostupná (zkus curl https://akademie.davidkirs.cz/api/health)
  • mcp-remote adapter není nainstalovaný (npx by ho měl stáhnout sám při prvním spuštění)
  • Firewall blokuje výchozí port

Řešení:

  1. Ověř, že /api/health vrátí { "status": "ok" }
  2. V Claude Desktop logu (Help → View Logs) hledej ja2-akademie zmínky
  3. V Claude Code claude mcp list musí ukázat ja2-akademie jako available

„Tool returns empty"

Pokud Claude zavolá ja2_get_personal_context a dostane prázdné pole:

  • Tvůj strukturovaný kontext zatím není vyplněný. Jdi do /profil → tab Strukturovaný → uvidíš všechny sloty + tlačítko „Doplnit s Angelem"
  • Pohovoř si chvíli s Angelem (na /angel) — on si poznámkuje insighty
  • V /checkpoint schválíš, co se má zapsat
  • Příští volání tool už vrátí data

„Forbidden" u Studio tools

ja2_workspace_* tooly vyžadují permission akademie.workspace. Default ji nemá nikdo krom adminů (* wildcard).

Řešení:

  • Pokud chceš Studio, kontaktuj admina akademie (David), ať ti permission přidá
  • Pro běžnou práci stačí strukturované sloty (osobní/expertní/značky/projekty) — Studio je pro tech-savvy power usery

„Token vypršel" v GitHub sync

GitHub Personal Access Token má expiration (default 30/60/90 dní podle nastavení).

Řešení:

  1. Jdi na github.com/settings/tokens
  2. Vytvoř nový token se scope repo
  3. V /profil/nastaveni → odpojit + znovu připojit s novým tokenem

Auto-sync neproběhl

Pokud máš v /profil/nastaveni zapnutý Auto-sync, ale GitHub repo nedostává commits:

  • Auto-sync má debounce 10 minut per user — pokud editují víc souborů za sebou, sync proběhne jen 1× za 10 min (úspora GitHub rate limitu)
  • Zkontroluj last_synced čas — pokud je starší než 10 min, něco selhalo
  • Manual „Sync teď" tlačítko obejde debounce

„Hidden from Angel" — Studio file privacy

Pokud máš v Studiu soubor s toggle „Skryté" (oranžová EyeOff ikona):

  • Angel ho v system promptu nevidí
  • Sync přesto ho do GitHub repu pushne (záloha)
  • Pokud chceš úplně vyloučit z všeho, smaž ho ze Studio (mazání je hard delete v platformě, ale GitHub kopie zůstane — to je úmysl pro data safety)

Něco jiného?

Pokud máš problém, který tady není:

  • Pro registrované uživatele: napiš mail na david@davidkirs.cz nebo otevři ticket v /podpora
  • Pro vývojáře: GitHub repo akademie má issues — github.com/herter72/ja2-academy-platform/issues

Když popíšeš situaci, přidej:

  • Co jsi udělal (poslední kroky)
  • Co Claude udělal (logs / response text)
  • Status v /konektory audit logu