JÁ² AkademieJÁ² 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 — klíč je dlouhý JWT (začíná eyJ…); když se část ztratí, podpis nesedí
  • Klíč vypršel (má expiraci — v /konektory vidíš dokdy platí)

Ř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://app.ja2.academy/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_me a dostane prázdný kontext:

  • Tvoje Paměť zatím není vyplněná. Jdi na stránku Paměť — uvidíš karty (Já, Byznys, Zákazník, Záměr…); každou můžeš rozkliknout a napsat rovnou, nebo ji nech naplnit rozhovorem
  • Pohovoř si chvíli s Aijou (na /angel) — poznámkuje si, co je důležité
  • Postřehy s nižší jistotou čekají na Paměti v sekci „Ke schválení" — schval, co se má zapsat
  • Příští volání tool už vrátí data

„Forbidden" u Studio tools

ja2_workspace vyžaduje permission akademie.workspace. Default ji nemá nikdo krom adminů (* wildcard).

Řešení:

  • Pokud chceš Studio, kontaktuj admina akademie, ať ti permission přidá
  • Pro běžnou práci stačí Paměť a 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 /settings/github → odpojit + znovu připojit s novým tokenem

Auto-sync neproběhl

Pokud máš v /settings/github 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

„Skryté před Aijou" — Studio file privacy

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

  • Aija 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 ja2@davidkirs.cz nebo se ozvi přes /podpora
  • Pro vývojáře: GitHub repo akademie má issues — github.com/herter72/ja2-akademie/issues (post-split standalone repo)

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

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