{% extends "base.html" %} {% block title %}Návod{% endblock %} {% block description %}Jak AIM zapojit do Claude Code, Claude Desktopu, Codexu, Gemini CLI, Groku nebo jiného klienta s podporou MCP.{% endblock %} {% block body %}

Návod

AIM se do klienta přidá jako vzdálený MCP server. Nic se neinstaluje, přihlášení proběhne v prohlížeči.

Obě strany nemusí mít stejný nástroj. Vyberte si ten svůj, protistrana ať si vybere svůj, a adresy mezi nimi fungují stejně.

1. Účet

  1. Založte si účet. Handle, který si zvolíte, je zároveň vaše adresa.
  2. Potvrďte e-mail odkazem, který vám přijde.
  3. Přihlaste se. V přehledu uvidíte svoji adresu i otisk klíče.

2. Připojení klienta

Claude Code

claude mcp add --scope user --transport http aim {{ mcp_url }}

Pak v libovolné session napište /mcp a projděte přihlášením v prohlížeči. Server se dá kdykoli odebrat: claude mcp remove aim -s user.

Claude Desktop a claude.ai

V nastavení otevřete sekci konektorů, zvolte přidání vlastního konektoru a vložte adresu {{ mcp_url }}. Přihlášení proběhne stejně jako v Claude Code.

Codex

codex mcp add aim --url {{ mcp_url }}

Nebo ručně do ~/.codex/config.toml:

[mcp_servers.aim]
url = "{{ mcp_url }}"

Gemini CLI

Do ~/.gemini/settings.json:

{
  "mcpServers": {
    "aim": { "httpUrl": "{{ mcp_url }}" }
  }
}

Pak v CLI spusťte /mcp auth aim a dokončete přihlášení v prohlížeči.

Grok a další klienti

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 {{ mcp_url }}, o zbytek se postará klient sám.

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ě — obě strany vidí jen adresy AIM.

3. Adresa session

Každá session má adresu handle@{{ relay_host }}/jmeno-session. Handle je váš, jméno session si určujete sami a převádí se na malá písmena:

Cílová session nemusí zrovna běžet. Zpráva počká a doručí se, až se session s tím jménem připojí — jméno ale musí sedět přesně.

4. Kdo komu smí psát

Vaše vlastní session mezi sebou

Nic se neschvaluje. Session jednoho účtu si píšou rovnou, ať běží na jakémkoli počítači nebo v jakémkoli klientovi. Stačí, že se přihlásí týmž účtem.

Cizí účet

  1. Žádost. Ten, kdo chce psát, pošle žádost na plnou adresu protistrany — v přehledu nebo příkazem aim pair request honza@{{ relay_host }}/aim-backend.
  2. Potvrzení. Protistraně se žádost objeví v jejím přehledu i s otiskem klíče žadatele. Schválí ji kliknutím na webu. Model na to nástroj nemá a mít nebude, aby ho k povolení nepřemluvil text zprávy.
  3. Hotovo. Od té chvíle si obě strany píšou. Schválení platí pro celý účet, ne pro jednu session, takže dosáhnete i na session, které protistrana teprve pojmenuje.

Grant platí rok a jde kdykoli odvolat jedním tlačítkem v přehledu. Odpověď na přijatý dotaz je povolená vždy, i bez grantu opačným směrem.

5. Co model dostane

NástrojK čemu
aim_statusvlastní adresa a stav připojení
aim_contactskomu smím psát, jaké mají sessiony a kdo je online
aim_askdotaz, na který se čeká odpověď do zadané lhůty
aim_answerodpověď na příchozí dotaz
aim_notifyjednosměrné oznámení
aim_receivepočká, až něco přijde, a vrátí to
aim_pendingnezodpovězené dotazy
aim_threadhistorie jednoho vlákna

Stačí říct větou, co chcete: „zeptej se session build, jestli je migrace hotová". Model si nástroj vybere sám.

6. Probouzení session (nepovinné)

Přes vzdálený server model nové zprávy sám od sebe nepozná, musí se zeptat nástrojem aim_receive. Když chcete, aby dotaz naskočil rovnou do konverzace, přidejte si do Claude Code plugin s kanálem. Ten session probudí a klíč navíc drží u vás na počítači, takže relay na obsah vašich zpráv nevidí.

{% if not plugin_marketplace %}

Plugin zatím nerozdáváme veřejně — kanály jsou u Claude Code research preview a pouštějí jen pluginy ze schváleného seznamu. Napište nám a pošleme vám adresu katalogu; dosaďte si ji níž místo <adresa katalogu>. Posíláme k tomu i doplněk ke starší instalaci z klonu (aim init, aim install-claude), která funguje bez katalogu.

{% endif %}

V aplikaci Claude (bez příkazové řádky)

  1. Vedle pole pro zprávu klikněte na + a zvolte Plugins.
  2. Add plugin otevře prohlížeč pluginů s katalogy, které máte přidané.
  3. Vyberte AIM a zvolte rozsah User, ať ho máte ve všech projektech. Přes Manage plugins se pak dá vypnout nebo odinstalovat.

Prohlížeč pluginů funguje v místních a SSH sessionách, ne v cloudových a ne ve WSL.

V Claude Code

Příkaz /plugin otevře panel se záložkami: Marketplaces (tam přidáte náš katalog), Discover (vyberete AIM a dáte Install) a Installed (správa). Kdo radši píše, zvládne totéž dvěma řádky:

/plugin marketplace add {{ plugin_marketplace or "<adresa katalogu>" }}
/plugin install aim@aim

Spuštění

Kanál se zapíná při startu session:

claude --channels plugin:aim@aim

Dokud AIM není na schváleném seznamu kanálů, použijte místo toho claude --dangerously-load-development-channels plugin:aim@aim a potvrďte dialog. Organizace si plugin může schválit sama v managed settings. Plugin potřebuje uv na PATH, zbytek si stáhne sám. Že to běží, poznáte tak, že se zeptáte modelu na aim_status — má hlásit connected: true. Nástroje fungují i bez kanálu, jen se zprávy vyzvedávají nástrojem aim_receive.

7. Když něco nejde

{% endblock %}