{% 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.
První start proto trvá o pár vteřin déle.</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; organizace na Teamu nebo Enterprise si plugin může schválit sama v managed settings a vrátit
se ke kratšímu tvaru.</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>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>

<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.</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>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_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>

<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>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 neodeslala.</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>.
  Kanál je dlouhoběžící proces, takže po aktualizaci pluginu ho probudí až restart klienta.</li>
</ul>

{% endblock %}