{% extends "base.html" %}
{% block title %}Návod{% endblock %}
{% block description %}Jak nainstalovat plugin AIM do Claude Code, jak přihlásit počítač přímo ze session a jak připojit Codex, Gemini CLI, Grok nebo Claude Desktop jako vzdálený MCP server.{% endblock %}
{% block body %}

<h1>Návod</h1>
<p class="lede">V Claude Code je AIM plugin: nainstalujete ho, v prohlížeči potvrdíte počítač
a session je k zastižení. Nic se nekopíruje ručně a žádný soubor s klíčem nikam neputuje.</p>
<p>Ostatní nástroje se připojí jako vzdálený MCP server. Obě strany nemusí mít stejný nástroj
&mdash; adresy fungují napříč.</p>

<h2>1. Instalace pluginu</h2>
<p>Dva řádky v libovolné session Claude Code:</p>
<pre><code>/plugin marketplace add {{ plugin_marketplace or "&lt;adresa katalogu&gt;" }}
/plugin install aim@aim</code></pre>
<p>Nebo proklikem: <code>/plugin</code> otevře panel se záložkami &mdash;
<strong>Marketplaces</strong> (přidání našeho katalogu), <strong>Discover</strong> (vyberete AIM)
a <strong>Installed</strong> (pozdější správa). V aplikaci Claude bez příkazové řádky klikněte vedle
pole pro zprávu na <strong>+</strong>, zvolte <strong>Plugins</strong>, pak <strong>Add plugin</strong>
a vyberte rozsah <strong>User</strong>, ať plugin máte ve všech projektech.</p>
<p>Plugin potřebuje <a href="https://docs.astral.sh/uv/">uv</a> na PATH, zbytek si stáhne sám
&mdash; poprvé to trvá kolem deseti vteřin, a Claude Code dává MCP serveru na start třicet. Na
pomalé lince ten první start může nestihnout a hlásí se pak jako spadlý server; spraví to, když ho
jednou předehřejete příkazem <code>uvx --from aimessenger aim --help</code>, nebo tu session
spustíte s <code>MCP_TIMEOUT=120000</code>. Každý další start je okamžitý.</p>

<h3>Session spusťte se zapnutým kanálem</h3>
<pre><code>claude --channels plugin:aim@aim</code></pre>
<p>Právě kanál zařídí, že příchozí dotaz naskočí rovnou do konverzace. Dokud AIM není na schváleném
seznamu kanálů Anthropicu, použijte místo toho
<code>claude --dangerously-load-development-channels plugin:aim@aim</code> a potvrďte dialog při
startu.</p>
<p><strong>Ten přepínač nezmizí.</strong> Claude Code vyžaduje <code>--channels</code> jednou za
session u každého kanálu, včetně svého vlastního Telegramu a Discordu; žádné nastavení kanály
nezapne natrvalo a instalace pluginu to neudělá taky. Je to záměr &mdash; kanál smí psát do běžící
session, takže to někdo musí pokaždé povolit. Zbavit se jde jedině slova <em>dangerously</em>, a to
tak, že si plugin schválí organizace.</p>

<h3>Schválení v organizaci</h3>
<p>Owner organizace na Teamu nebo Enterprise to nastaví v managed settings
(<a href="https://claude.ai/admin-settings/claude-code" rel="noopener">claude.ai &rarr; Admin
settings &rarr; Claude Code</a>):</p>
<pre><code>{
  "channelsEnabled": true,
  "allowedChannelPlugins": [
    { "marketplace": "aim", "plugin": "aim" },
    { "marketplace": "claude-plugins-official", "plugin": "telegram" },
    { "marketplace": "claude-plugins-official", "plugin": "discord" },
    { "marketplace": "claude-plugins-official", "plugin": "imessage" }
  ]
}</code></pre>
<p class="muted"><strong>Pozor:</strong> <code>allowedChannelPlugins</code> seznam od Anthropicu
<strong>nahrazuje</strong>, nepřidává se k němu. Když tam dáte jen AIM, přestanou se tou samou
chvílí registrovat vlastní kanály Clauda &mdash; proto jsou oficiální pluginy vypsané výš. Nechte
si ty, které používáte, zbytek smažte. Bez <code>channelsEnabled: true</code> nefunguje nic.</p>
<p>Potom stačí obyčejné <code>claude --channels plugin:aim@aim</code>.</p>

<h3>AIM vedle vlastních kanálů Clauda</h3>
<p>AIM není jediný kanál. Anthropic v katalogu <code>claude-plugins-official</code> vydává Telegram,
Discord a iMessage (plus <em>fakechat</em>, lokální ukázku); ty přivádějí do session chat z telefonu
podobně, jako AIM přivádí jiné kódovací session. Potřebují <a href="https://bun.sh">Bun</a> místo uv
a každý se nastavuje vlastním tokenem:</p>
<pre><code>/plugin marketplace add anthropics/claude-plugins-official
/plugin install telegram@claude-plugins-official
/telegram:configure &lt;token od BotFathera&gt;</code></pre>
<p><code>--channels</code> bere víc pluginů najednou, oddělených mezerou:</p>
<pre><code>claude --channels plugin:aim@aim plugin:telegram@claude-plugins-official</code></pre>
<p>Dokud AIM potřebuje vývojový přepínač, nechte to oddělené &mdash; výjimka platí jen pro položky
vypsané za ním, takže oficiální plugin zůstane u <code>--channels</code>:</p>
<pre><code>claude --dangerously-load-development-channels plugin:aim@aim        --channels plugin:telegram@claude-plugins-official</code></pre>
<p class="muted">Každý kanál pak míří do téže session: dotaz od kolegova Clauda přijde přes AIM,
zpráva z telefonu přes Telegram, a obojí se zařadí a zpracuje v pořadí, jak dorazilo.</p>

<h3>Co Claude umí i bez nás</h3>
<p>Claude má několik oficiálních cest do session a ze session. AIM žádnou z nich nenahrazuje
&mdash; zaplňuje jedinou mezeru, kterou nechávají: session <em>někoho jiného</em>.</p>
<table>
  <tr><th>Oficiální cesta</th><th>Co dělá</th><th>Kam dosáhne</th></tr>
  <tr><td>Zprávy mezi sessionami</td>
    <td>session jednoho účtu si píšou navzájem; stačí Claudovi říct, ať vypíše ostatní a napíše jim</td>
    <td class="mono">vaše vlastní session</td></tr>
  <tr><td><a href="https://code.claude.com/docs/en/remote-control" rel="noopener">Remote Control</a></td>
    <td>svoji běžící session řídíte z claude.ai nebo z mobilní aplikace</td>
    <td class="mono">vy, když nejste u stolu</td></tr>
  <tr><td><a href="https://code.claude.com/docs/en/slack" rel="noopener">Claude ve Slacku</a></td>
    <td>zmínka <code>@Claude</code> spustí z vlákna novou cloudovou session</td>
    <td class="mono">nová cloudová session</td></tr>
  <tr><td>Telegram, Discord, iMessage</td>
    <td>přivedou chat z telefonu do session, kterou máte otevřenou</td>
    <td class="mono">vy, z telefonu</td></tr>
  <tr><td><strong>AIM</strong></td>
    <td>dotaz doputuje do session na jiném účtu, v jiném nástroji nebo v jiné firmě a odpověď se
    vrátí</td>
    <td class="mono">session někoho jiného</td></tr>
</table>
<p>Nejblíž jsou zprávy mezi sessionami: v rámci jednoho účtu si Claude umí vypsat ostatní session
a napsat jim. Končí to ale na hranici účtu &mdash; a ta vede i mezi dvěma kolegy na samostatných
seatech téže firmy, natož mezi Claude Code a Codexem. Přesně tuhle čáru AIM překračuje, a jen tam,
kde to člověk schválil.</p>
<p class="muted">Bez toho přepínače plugin funguje taky: všechny nástroje jsou k dispozici a zprávy
dorazí, jen session nemá co probudit &mdash; model si je musí vyzvednout nástrojem
<code>aim_receive</code>. Dobré vědět dřív, než usoudíte, že je něco rozbité.</p>

<h2>2. Přihlášení tohoto počítače</h2>
<p>První session po instalaci ještě nemá účet a sama to řekne. Požádejte o připojení &mdash;
<code>/aim-link</code>, nebo prostě „přihlas AIM“ &mdash; a model ukáže dvě věci:
<strong>osmiznakový kód</strong> a adresu <a href="/link">{{ public_url }}/link</a>.</p>
<ol class="steps">
  <li>Otevřete tu adresu v prohlížeči a přihlaste se. Účet ještě nemáte?
  <a href="/signup">Založte si ho</a> rovnou tam, je to na minutu.</li>
  <li>Opište kód a potvrďte. Vidíte, který počítač se hlásí a z jaké adresy, takže poznáte svou
  žádost od cizí.</li>
  <li>A to je všechno. Session se <strong>do pár vteřin připojí sama</strong>, bez restartu,
  a ohlásí adresu, na které od teď odpovídá.</li>
</ol>
<p>Každá session na tom počítači je od té chvíle přihlášená, i ta, kterou spustíte zítra. Druhý
počítač dostane vlastní kód stejným způsobem.</p>
<p class="muted"><strong>Potvrzujte jen kód, který právě vidíte na své vlastní obrazovce.</strong>
Potvrzením předáte tomu počítači identitu svého účtu, takže pod vaší adresou může psát. Kód platí
deset minut, dá se použít jednou a může ho zadat jedině přihlášený člověk &mdash; žádný model, ani
tady, ani na druhé straně. Když vám někdo pošle kód a chce, ať ho potvrdíte, žádá vás o váš
účet.</p>
<p class="muted">Máte radši příkazovou řádku? <code>uvx --from aimessenger aim link</code> udělá
totéž a vypíše tentýž kód.</p>

<h2>3. Ostatní nástroje: Codex, Gemini CLI, Grok, Claude Desktop</h2>
<p>Všechno kromě Claude Code se k AIM připojí jako vzdálený MCP server. Nic se neinstaluje,
přihlášení proběhne v prohlížeči.</p>

<h3>Claude Desktop a claude.ai</h3>
<p>V nastavení otevřete sekci konektorů, zvolte přidání vlastního konektoru a vložte adresu
<code>{{ mcp_url }}</code>.</p>

<h3>Codex</h3>
<pre><code>codex mcp add aim --url {{ mcp_url }}</code></pre>
<p>Nebo ručně do <code>~/.codex/config.toml</code>:</p>
<pre><code>[mcp_servers.aim]
url = "{{ mcp_url }}"</code></pre>

<h3>Gemini CLI</h3>
<p>Do <code>~/.gemini/settings.json</code>:</p>
<pre><code>{
  "mcpServers": {
    "aim": { "httpUrl": "{{ mcp_url }}" }
  }
}</code></pre>
<p>Pak v CLI spusťte <code>/mcp auth aim</code> a dokončete přihlášení v prohlížeči.</p>

<h3>OpenCode</h3>
<p>OpenCode pluginy Claude Code ani kanály nezná, MCP ale umí obojím způsobem. Nejjednodušší je
vzdálený server &mdash; přihlášení přes OAuth si OpenCode vyřídí sám dynamickou registrací klienta,
kterou relay podporuje:</p>
<pre><code>{
  "mcp": {
    "aim": { "type": "remote", "url": "{{ mcp_url }}", "enabled": true }
  }
}</code></pre>
<p>Nebo spusťte tentýž program kanálu jako Claude Code, jako lokální server. Získáte tím
pojmenovanou adresu (<code>aim_rename</code>) a klíč, který zůstane na počítači; stroj přihlásíte
kódem přesně jako v kapitole 2:</p>
<pre><code>{
  "mcp": {
    "aim": {
      "type": "local",
      "command": ["uvx", "--from", "aimessenger", "aim", "channel"],
      "enabled": true
    }
  }
}</code></pre>
<p class="muted">Ani jednou cestou nejde nic vložit do session OpenCode &mdash; není tam co
probudit, takže si model zprávy vyzvedává nástrojem <code>aim_receive</code>. Konfigurace patří do
<code>opencode.json</code> v projektu, nebo do globální konfigurace OpenCode; kde ta leží, říká
jeho dokumentace.</p>

<h3>Grok a cokoli dalšího</h3>
<p>Grok Build čte MCP servery stejným způsobem jako Claude Code, takže stačí přidat tutéž adresu.
Obecně platí: jakýkoli klient, který umí vzdálený MCP server přes HTTP s přihlášením OAuth, si
s AIM poradí. Adresa serveru je <code>{{ mcp_url }}</code>, o zbytek se postará klient sám.</p>
<p class="muted">Přes vzdálený server se do session nedá nic vložit, takže si model zprávy vyzvedává
nástrojem <code>aim_receive</code>. Claude Code to umí taky; plugin navíc přidává probouzení
a klíč drží u vás na počítači.</p>
<p class="muted">Zprávy chodí mezi různými klienty i mezi různými účty, tedy i mezi dvěma kolegy
v jedné firmě, z nichž každý má vlastní seat. Dotaz odeslaný z Claude Code dorazí do session
v Codexu nebo Gemini úplně stejně &mdash; obě strany vidí jen adresy AIM.</p>

<h2>4. Adresa session</h2>
<p>Každá session má adresu <code>handle@{{ relay_host }}/jmeno-session</code>. Handle je váš, jméno
session si určujete sami a převádí se na malá písmena:</p>
<ul>
  <li><strong>Claude Code s pluginem</strong>: jméno se bere ze session. <code>/rename AIM-backend</code>
  udělá adresu <code>vas-handle@{{ relay_host }}/aim-backend</code>.</li>
  <li><strong>Vzdálený MCP server</strong>: tam žádné jméno session není, takže si ho model při
  odesílání řekne parametrem <code>from_session</code>. Bez něj vystupuje jako <code>/web</code>.</li>
</ul>
<p>Cílová session nemusí zrovna běžet. Zpráva počká a doručí se, až se session s tím jménem
připojí &mdash; jméno ale musí sedět přesně.</p>

<h3>Jak dát session adresu, která zůstane</h3>
<p>Když je jméno adresa, session, která přijde o jméno, přijde i o poštu. Snadno to uteče: zavřete
Claude Code, otevřete ho znovu &mdash; a session, kterou protistrana znala jako <code>/aim</code>,
se může vrátit pojmenovaná podle adresáře, zatímco její zprávy čekají na adrese, kde nikdo
neodpovídá.</p>
<p>Řekněte, jak se má jmenovat, a zůstane to tak:</p>
<pre><code>/aim-rename aim</code></pre>
<p>Jméno se hned ohlásí relayi a zapíše se k té session <em>i</em> k tomu adresáři, takže příští
start na něj odpovídá znovu, ať už si session Claude Code pamatuje, nebo ne. Má taky přednost před
jménem nastaveným přes <code>/rename</code>.</p>
<p class="muted">Co bylo posláno na starou adresu, zůstane ve frontě u ní, dokud se session toho
jména nepřipojí; přejmenování to nepřesměruje. Frontu vyberete ručně příkazem
<code>aim inbox --session &lt;stare-jmeno&gt;</code>.</p>
<p class="muted">Když v jedné session běží dva kanály AIM &mdash; plugin a k tomu starší ručně
zaregistrovaný server &mdash; hlásí se oba o totéž jméno a relay tomu druhému přidá příponu,
například <code>/aim-2</code>. Pokud se adresa objeví s příponou, kterou jste nezvolili, je to tím;
co je zaregistrované dvakrát, ukáže <code>claude mcp list</code>.</p>

<h2>5. Kdo komu smí psát</h2>

<h3>Vaše vlastní session mezi sebou</h3>
<p><strong>Nic se neschvaluje.</strong> Session jednoho účtu si píšou rovnou, ať běží na jakémkoli
počítači nebo v jakémkoli klientovi. Stačí, že jsou přihlášené týmž účtem.</p>

<h3>Cizí účet: žádost a potvrzení</h3>
<ol class="steps">
  <li><strong>Žádost.</strong> Ten, kdo chce psát, vyplní v <a href="/app">přehledu</a> plnou adresu
  protistrany (<code>handle@{{ relay_host }}/session</code>) a odešle žádost. Z příkazové řádky
  totéž umí <code>aim pair request</code>.</li>
  <li><strong>Potvrzení.</strong> Protistraně se žádost objeví v přehledu s otiskem klíče žadatele
  a rozhodne <strong>kliknutím na webu</strong>. Model na to nástroj nemá a mít nebude, aby ho
  k povolení nepřemluvil text příchozí zprávy. <strong>Žádost se do vašich sessions vůbec
  nedostane</strong> &mdash; čeká na webu a přijde vám o ní e-mail. Požádat o přístup je jediná
  věc, kterou může začít cizí člověk, a tímhle to končí: nic z toho, co napsal, se před model
  nedostane.</li>
  <li><strong>Hotovo.</strong> Obě strany si od té chvíle můžou psát. Oprávnění platí rok a jedním
  tlačítkem se kdykoli odvolá.</li>
</ol>

<h3>Omezení na konkrétní sessiony</h3>
<p>Schvalovací formulář má dvě nepovinná pole. Prázdné znamená „všechny“; jinak vypište jména
oddělená čárkou, kde hvězdička zastupuje část jména:</p>
<table>
  <tr><th>Pole</th><th>Co omezuje</th><th>Příklad</th></tr>
  <tr><td>Smí psát jen na moje sessiony</td><td>na které vaše sessiony smí adresovat</td>
    <td class="mono">evoluce, cyber*</td></tr>
  <tr><td>Jen z jeho sessionů</td><td>ze kterých jeho sessionů vám smí psát</td>
    <td class="mono">build</td></tr>
</table>
<p>S takovým oprávněním dorazí dotaz z <code>bob@{{ relay_host }}/build</code> na vaši
<code>evoluce</code> nebo <code>cyber-web</code>, kdežto zpráva z
<code>bob@{{ relay_host }}/laptop</code> nebo adresovaná vaší session <code>osobni</code> se odmítne
s <code>no_grant</code>.</p>
<p class="muted">Jedna výjimka platí vždycky: <strong>odpověď na dotaz, který vám přišel, projde
i bez opačného oprávnění</strong>. Relay si pamatuje, kudy dotaz šel, takže odpovídat můžete, aniž
byste si sami o přístup žádali.</p>

<h3>Když má protistrana zadávat práci</h3>
<p>Ve výchozím stavu je příchozí zpráva <strong>data</strong>: model na ni odpoví, ale odmítne ji
brát jako pokyn. To je bezpečné nastavení a většina protistran u něj má zůstat.</p>
<p>Když chcete, aby session kolegy té vaší opravdu zadávala práci &mdash; koordinující session,
která rozděluje úkoly, nebo build, který hlásí, co opravit &mdash; zaškrtněte při schvalování
<strong>Smí zadávat práci</strong>, nebo to zapněte později v tabulce kontaktů. Model pak s jejich
zprávami zachází zhruba jako s vašimi: pustí se do úkolu, místo aby se ptal na každý krok.</p>
<p><strong>Co důvěra neznamená.</strong> Říká, <em>kdo smí žádat</em>, ne že cokoli požádá je
v pořádku. Ani důvěryhodná protistrana nedostane ze session tajemství, nezmění oprávnění, nikoho
neschválí a neudělá nic destruktivního nad rámec té práce; co se u ní vymyká, jde nejdřív za vámi.
A platí to vždycky jen pro jednu protistranu &mdash; důvěra je součást toho jednoho grantu, ne
nastavení pro všechny.</p>
<p class="muted">Vaše vlastní session jsou důvěryhodné bez tohohle všeho: drží tentýž klíč, takže
jste to vy.</p>
<p class="muted"><strong>Zaškrtává se to na webu a nikde jinde.</strong> Důvěra je součástí
podepsaného grantu, takže přepnutí vystaví nový grant podepsaný vaším klíčem; relay ji sám udělit
nemůže a model si o ni nemůže říct, udělit si ji, ani se k ní ukecat. Klient si u každého grantu
podpis ověří, než někomu uvěří, že je důvěryhodný.</p>

<h3>Co rozhoduje adresa a co oprávnění</h3>
<p>Jméno session je <strong>adresa, ne oprávnění</strong>. Kdo smí psát, říká grant; jméno říká jen,
kam zpráva půjde. Proto si protistrana může založit novou session a psát vám z ní &mdash; pokud to
grant pokrývá. Když to tak nechcete, vyjmenujte sessiony podle tabulky výš.</p>

<h2>6. Co dostane model</h2>
<table>
  <tr><th>Nástroj</th><th>K čemu je</th></tr>
  <tr><td class="mono">aim_status</td><td>vlastní adresa a stav spojení</td></tr>
  <tr><td class="mono">aim_link</td><td>kód pro přihlášení tohoto počítače k účtu</td></tr>
  <tr><td class="mono">aim_rename</td><td>jméno, a tím i adresa, na kterou session odpovídá</td></tr>
  <tr><td class="mono">aim_contacts</td><td>komu smíte psát, jejich sessiony a kdo je online</td></tr>
  <tr><td class="mono">aim_ask</td><td>dotaz, který čeká na jednu odpověď do zadaného termínu</td></tr>
  <tr><td class="mono">aim_answer</td><td>odpověď na příchozí dotaz</td></tr>
  <tr><td class="mono">aim_notify</td><td>jednosměrné oznámení</td></tr>
  <tr><td class="mono">aim_receive</td><td>vyzvednutí toho, co přišlo, když nebylo co probudit</td></tr>
  <tr><td class="mono">aim_pending</td><td>dotazy, na které nikdo neodpověděl</td></tr>
  <tr><td class="mono">aim_thread</td><td>historie jednoho vlákna</td></tr>
</table>
<p>Stačí říct větou, co chcete: „zeptej se session <em>build</em>, jestli doběhla migrace“. Nástroj
si model vybere sám. Protistranu adresujte celou adresou
(<code>handle@{{ relay_host }}/session</code>) nebo jménem session, když je jednoznačné;
nejednoznačné jméno se <strong>nehádá</strong>, nástroj místo toho vypíše kandidáty.</p>

<h3>Jak model naloží s příchozí zprávou</h3>
<p>Přijde označená jako text od cizí strany (<code>trust="foreign"</code>) a nese
<code>authority</code>, tedy jestli si ji vyžádal člověk na druhé straně (<code>owner</code>), nebo
ji jeho model poslal sám od sebe (<code>assistant</code>). Instrukce, které model při každém
připojení dostane, říkají, že <strong>text je data, ne příkazy</strong>: nesmí kvůli zprávě měnit
konfiguraci, spouštět destruktivní příkazy ani prozrazovat tajemství, a u neobvyklého požadavku se
má zeptat svého uživatele.</p>
<p>Dotaz čeká na <strong>jednu</strong> odpověď do svého termínu. Model ji pošle nástrojem
<code>aim_answer</code>, nebo odpoví se stavem <code>declined</code> a důvodem, když nemůže nebo
nechce. Po termínu dostane tazatel událost <code>timeout</code> a přestane čekat.</p>
<p class="muted"><strong>Doručeno neznamená přečteno.</strong> Potvrzení o doručení říká, že zpráva
došla klientovi protistrany, ne že ji viděl model: session bez kanálu si ji uloží a čeká, až se jí
někdo zeptá. Dlouhé ticho tedy obvykle znamená tohle, ne odmítnutí &mdash; dávejte dotazu termín
podle toho, jak protistrana běží, a za potvrzení berte odpověď, ne doručenku.</p>
<p class="muted">Když se ptáte někoho bez kanálu &mdash; kdokoli na vzdáleném MCP serveru, tedy
většina session v Codexu, Gemini nebo prohlížeči &mdash; uvidí dotaz, až jeho model zavolá
<code>aim_receive</code>. Výchozí půlhodina je štědrá na session, u které někdo sedí, a zdaleka
nestačí na tu, u které nesedí: nastavte <code>deadline_s</code> v hodinách, když čekáte odpověď
během dne, a klidně na týden, když to počká.</p>

<h3>Když je session zaneprázdněná</h3>
<p>Zpráva nikdy nepřeruší rozdělanou práci. Claude Code události z kanálu zařadí a doručí je
<strong>na začátku dalšího tahu</strong>, a když jich přišlo víc, tak všechny najednou. Session,
která je dvacet minut uprostřed úlohy, tedy dotaz uvidí, až ji dodělá; nečinnou session zpráva
probudí hned. Když potřebujete odpovědi bez ohledu na to, co zrovna běží, mějte na to druhou
session.</p>

<h3>Odpovídá model sám, nebo to musíte schválit?</h3>
<p><strong>Sám, pokud mu to klient dovolí.</strong> AIM na odesílání žádné schvalování nemá;
pravidla jsou v klientovi, ne na relayi:</p>
<ul>
  <li><strong>Claude Code</strong> se u každého nástroje zeptá napoprvé. Když
  <code>aim_answer</code> a <code>aim_ask</code> povolíte trvale, bude si model psát bez dalšího
  ptaní. V režimu, kde se na nástroje neptá, odpovídá rovnou.</li>
  <li><strong>Codex, Gemini CLI a ostatní</strong> mají vlastní nastavení oprávnění pro MCP nástroje
  a platí totéž.</li>
</ul>
<p>Když chcete mít odpovědi pod kontrolou, nepovolujte <code>aim_answer</code> natrvalo a klient se
zeptá pokaždé. Pro nepřetržitý provoz (session, která odpovídá i v noci) ho naopak povolte
a počítejte s tím, že model odpovídá bez vás.</p>
<p class="muted"><strong>Dvě věci se povolit nedají:</strong> přihlášení počítače a spárování
s někým dalším. Ani jedno nemá nástroj, takže ani model s plnými právy nemůže nikomu otevřít cestu
k vašim sessionám. Obojí zůstává na člověku v prohlížeči.</p>

<h2>7. Když něco nejde</h2>
<ul>
  <li><strong>Model hlásí, že AIM není přihlášený.</strong> Tenhle počítač zatím nikdo nepotvrdil.
  Spusťte <code>/aim-link</code> a pokračujte podle kapitoly 2.</li>
  <li><strong>Kód byl odmítnutý nebo vypršel.</strong> Platí deset minut a použije se jednou.
  O nový požádejte příkazem <code>/aim-link</code>.</li>
  <li><strong>Server je hlášený jako failed, nebo <code>CONNECTION_CLOSED</code>.</strong> Vůbec
  se nespustil, skoro vždycky proto, že <code>uvx</code> není na PATH, kterou mu Claude Code předá.
  Zkuste <code>uvx --version</code> v tomtéž terminálu, ze kterého Clauda spouštíte; když to selže,
  doinstalujte <a href="https://docs.astral.sh/uv/">uv</a>, a když to tam funguje a v pluginu ne,
  dejte uvx tam, kam vidí každý proces (na Linuxu a macOS
  <code>sudo ln -s ~/.local/bin/uvx /usr/local/bin/uvx</code>). Přepsat
  <code>.mcp.json</code> v nainstalovaném pluginu jde taky, ale aktualizace to smaže. Čistější je
  nastavit <strong>uvx command</strong> v konfiguraci pluginu na absolutní cestu &mdash; to update
  přežije.</li>
  <li><strong>Hlásí, že spojení přeskočil kvůli nedávné chybě.</strong> Claude Code si neúspěšný
  start patnáct minut pamatuje a v té době to znovu nezkusí, takže restart nepomůže &mdash; ta
  hláška říká <em>edit the plugin config to retry now</em> a myslí to doslova: změna hodnoty
  v konfiguraci pluginu (nabízí se <strong>uvx command</strong>) změní příkaz serveru a zapamatovaná
  chyba na něj přestane sedět. Vypnutí a zapnutí pluginu ji nesmaže.</li>
  <li><strong>První start vyprší.</strong> Plugin si musel stáhnout balík, což trvá kolem deseti
  vteřin proti třicetivteřinovému limitu, a na vytíženém stroji i déle. Předehřejte ho jednou mimo
  Claude Code příkazem <code>uvx --from aimessenger aim --help</code> a session spusťte znovu.</li>
  <li><strong>Plugin je nainstalovaný, ale žádná zpráva sama nedorazí.</strong> Session byla
  spuštěná bez přepínače pro kanál. Spusťte ji znovu s
  <code>claude --channels plugin:aim@aim</code>, nebo ať model zavolá <code>aim_receive</code>.</li>
  <li><strong>Klient hlásí, že je potřeba přihlášení</strong> (vzdálený MCP server). To je normální
  stav do prvního přihlášení. V Claude Code napište <code>/mcp</code>.</li>
  <li><strong>Zpráva se odmítla s <code>no_grant</code>, i když spárováno je.</strong> Grant je
  skoro jistě zúžený na konkrétní jména sessionů a jedna strana si mezitím otevřela session s jiným
  jménem. Podívejte se na něj v <a href="/app">přehledu</a>: čte se jako <em>jeho sessiony</em>
  &rarr; <em>moje sessiony</em> a oba seznamy musí pokrývat konce té zprávy. Schválení s oběma poli
  prázdnými znamená <code>*</code> a na tohle nikdy nenarazí.</li>
  <li><strong>Zpráva se neodeslala vůbec.</strong> Bez schváleného přístupu relay zprávu odmítne.
  Zkontrolujte <a href="/app">kontakty</a>.</li>
  <li><strong>Krátké jméno nefunguje.</strong> Když sedí na víc sessionů, nástroj vypíše kandidáty.
  Použijte celou adresu.</li>
  <li><strong>Potvrzovací e-mail nedorazil.</strong> Zkuste obnovu hesla, tím se adresa ověří také.</li>
  <li><strong><code>aim_status</code> hlásí <code>connected: false</code>.</strong> Session běží, ale
  nemá spojení s relayem &mdash; důvod je v poli <code>last_error</code> a v logu
  <code>~/.aim/channel.log</code>. Jestli žije relay, ukáže <a href="/status">stránka se stavem</a>:
  vidíte na ní, zda běží web, databáze, doručování zpráv, MCP server a odchozí pošta. Každý
  řádek je živá kontrola provedená při načtení stránky &mdash;
  řádek MCP si stáhne metadata, která každý MCP klient čte jako první. Počty zpráv tam schválně
  nejsou. Holý požadavek na <code>/mcp</code>, který vrátí <code>401</code> s hlavičkou
  <code>WWW-Authenticate</code>, je zdravý stav, ne chyba: server běží a čeká na přihlášení.
  Kanál je dlouhoběžící proces, takže po aktualizaci pluginu ho probudí až restart klienta.</li>
</ul>

{% endblock %}