Proč vůbec instalovat Collabim MCP do Claude Code a co to pro vás znamená.
Instalace Collabim MCP server
MCP (Model Context Protocol) je standard, který umožňuje AI asistentům jako Claude přímo volat externí nástroje – bez copy-paste, bez přepínání oken, bez ztráty kontextu. Collabim jako přední český SEO nástroj tento protokol implementoval, a to je docela velká věc. A pokud se odborně zabýváte SEO, pak to oceníte obzvláště. Co tím získáte v praxi? Prostě se v Claude zeptáte: „Jak si vedou klíčová slova na mém projektu scuka.cz za poslední měsíc?“ – a on to Claude rovnou vytáhne z Collabimu. Žádný export, žádný upload CSV souboru. Data z Collabim tečou přímo do SEO analýzy. Kterou samozřejmě již máte připravenou a nastavenou v Promptu Claude 👍.
Dodatek srpen 2026:
Ten postup, který zmiňuji dále fungoval. Přesně jednu hodinu. Pak bylo nutné restartovat Claude. Problém byl v tom, že když jsem to neudělal, Collabim MCP vypadal živě, hlásí se jako připojený a přitom neodpoví na jediný dotaz. Trvalo mi několik dalších streamů, než jsem pochopil, že problém není v instalaci, ale v tom, že OAuth token má životnost 60 minut a mcp-remote ho neumí obnovit. Dodatek popisuje, co se přesně dělo a čím jsem wrapper nakonec nahradil.
⚠️ Platnost: srpen 2026 · Claude Desktop (Store verze) 1.34493.1 · Windows · mcp-remote@0.1.37 · Collabim access token TTL 60 minut. Dodatek popisuje stav v době testu. Pokud Claude Desktop mezitím doplnil nativní podporu OAuth client_credentials, je část tohoto dodatku už jen historie a vystačíte si s postupem přímo z dokumentace Collabimu.
*️⃣ Jak to Collabim popisuje (a kde začíná legrace) *️⃣
Výše uvedená definice „co to dělá“ je super. Stačí maličkost – propojit se na ten MCP server, autorizovat se do datového streamu MCP serveru Collabim.
Dle návodu na https://mcp.oncollabim.com/ to znamená:
- Nainstalujte si Node.JS. [provedeno]
- Přidejte MCP server v Claude: Settings → Developer → Edit Config → claude_desktop_config.json [provedeno]
- Zkopírujte OAuth údaje z Collabimu – najdete je v nastavení účtu u API klíče jako MCP client ID a MCP client secret. MCP klient je použije pro OAuth client_credentials flow. [trochu slabší, vysvětlím]
- Pokud váš MCP klient zatím neumí OAuth client_credentials automaticky, vyžádejte access token přes POST https://mcp.oncollabim.com/oauth/token a vložte ho do konfigurace:
{
"mcpServers": {
"collabim-api": {
"url": "https://mcp.oncollabim.com",
"headers": {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
}
}
}
Uložte a restartujte Claude.
Toliko oficiální postup.
Jak s tím postupem naložit?
Collabim tedy v návodu říká: přidejte MCP server s API klíčem jako Bearer token. Jednoduché. Funkční v Cursoru. V Claude ale… ne tak docela. Přidal jsem do claude_desktop_config.json toto:
"collabim-jmeno": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.oncollabim.com",
"--header",
"Authorization:VÁŠ_API_KLÍČ"
]
}
Server se nespojil. Log hlásil: Connection error: Incompatible auth server: does not support dynamic client registration
„Claude Vám v sekci Developer nabízí otevřít si soubor nastavení. To je OK, ale moc Vám to v tomto okamžiku nepomůže. Jděte do LOGu. Tam totiž uvidíte, co se dělo..."
Novější verze knihovny mcp-remote (asi 0.1.35+) jsou chytřejší než dřív. Když narazí na server, zkusí zjistit, jestli podporuje OAuth. Collabim protokol OAuth má – ale nepodporuje dynamic client registration. A to je mechanismus, kdy si klient sám zaregistruje přihlašovací údaje na serveru za běhu. Tohle spojení pak má (neočekávaný) výsledek:
- mcp-remote detekuje OAuth,
- pokusí se zaregistrovat,
- server odpoví „ne“,
- a celé to padne.
API klíč jako Bearer token nestačí, protože server ho při přímém volání odmítne jako neověřený – a tím spustí ten OAuth kolotoč. V květnu 2026 to fungovalo. Starší verze mcp-remote tohle chování neměla. Pak přišel update a je konec, šlus, nepřipojím tě a hotovo.
Poznámka 1 – to Claude zjistil čtením logu. Claude Desktop ukládá logy MCP serverů do %APPDATA%\Claude\logs\. Soubor mcp-server-[název].log je váš nejlepší přítel při ladění.
*️⃣ Řešení krok za krokem: OAuth token wrapper *️⃣
Správné řešení obejde celý problém. Místo API klíče použijeme platný OAuth Bearer token, který si vyžádáme sami přes client_credentials flow. Server pak rovnou ověří token a mcp-remote nemá důvod spouštět OAuth discovery.
Co budete potřebovat
- Node.js nainstalovaný na počítači
- Claude Desktop (ne webová verze)
- MCP client ID a MCP client secret z vašeho Collabim účtu (Osobní údaje → API klíč)
Krok 1: Najděte config soubor Claude
- Otevřete Claude Desktop → Settings → Developer → Edit Config.
- Nebo přímo: %APPDATA%\Claude\claude_desktop_config.json.
Krok 2: Vytvořte wrapper skript
- Uložte tento soubor jako C:\Users\[UŽIVATEL]\.claude\collabim-mcp.cmd:
@echo off
for /f "tokens=*" %%i in ('powershell -NoProfile -Command "(Invoke-RestMethod -Method Post -Uri 'https://mcp.oncollabim.com/oauth/token' -ContentType 'application/x-www-form-urlencoded' -Body 'grant_type=client_credentials&client_id=VÁŠ_CLIENT_ID&client_secret=VÁŠ_CLIENT_SECRET').access_token"') do set TOKEN=%%i
"C:\Program Files\nodejs\npx.cmd" -y mcp-remote@0.1.37 https://mcp.oncollabim.com --header "Authorization:Bearer %TOKEN%"
- Nahraďte VÁŠ_CLIENT_ID a VÁŠ_CLIENT_SECRET hodnotami z Collabimu
Krok 3: Přidejte záznam do config souboru
{
"mcpServers": {
"collabim": {
"command": "cmd",
"args": [
"/C",
"C:\\Users\\[VÁŠ_UŽIVATEL]\\.claude\\collabim-mcp.cmd"
]
}
}
}
Úplně zavřete aplikaci (i z tray) a znovu otevřete. MCP server se při startu připojí a načte nástroje.
Ověřte si, že MCP Server Collabim funguje, třeba tak, že se Claude Code zeptáte:
jak se změnilo pořadí TOP20 klíčových slov z pozice před 14 dny na doméně scuka.cz v collabim-jmeno ?
A nyní fungují i Collabim jednorázové AI analýzy. Chcete důkaz? Tady je:
Otázka, která vás napadne: co s tím hodinovým tokenem?
Tedy – ona Vás napadne, když se v tom vyznáte. A pokud se v tom vyznáte, možná nepotřebujete číst tenhle návod. Takže – ANO, tenhle postup Vás ke Collabim připojí přes Oauth token a ten vyprší za 60 minut. Wrapper skript ho totiž získává čerstvý jen při každém startu Claude – takže v praxi to vlastně nemusí nutně a úplně vadit. Pokud pracujete na dlouhé Session a máte spojení do MCP Collabim stále aktivní, nemělo by dojít k přerušení spojení. Ale pokud zpracováváte třeba SEO analýzu pro lokální firmu a potřebujete získávat informace z mnoha okolních zdrojů – pak se k údajům z Collabim potřebujete vrátit jen dvakrát za den. A pak to asi vadit může/bude [ověřeno]. Tento bod jsem já vyřešil kopírování získaných a relevantních dat do lokální databáze DuckDB v rámci zadání promptu přes vlastní připravený SKILL.md – /anthropic-skills:is-cache-collabim. To už je zase jiný proces, který používám i pro snížení počtu utracených tokenů → to jsme ale v jiném příběhu. A třeba proces přihlášení do MCP serveru společnost Collabim ještě upraví a prodlouží platnost Oauth tokenu. Uvidíme.
🔄Dodatek srpen 2026 - On ten hodinový token vadí víc, než jsem psal.
Původní návod výš je z června 2026. Odseděl jsem na něm pár měsíců ostrého provozu a zakončil jsem ho slovem „Uvidíme.“ Tak jsme se díval. V jedné konkrétní věci jsem se mýlil. Že mě jeden symptom mátl mnohem dýl, než bylo nutné. A hlavně, že na Collabim čekat nemusím. Wrapper z Kroku 2 jsem zahodil a nahradil něčím, co ten hodinový strop řeší celý. Až Claude Desktop doplní nativní podporu OAuth client_credentials a nebo Collabim dynamic client registration, pak třídíme obsah tohohle dodatku do kategorie „historie“ a vystačíte si s postupem přímo z dokumentace.
❗Oprava: Aktivní session Vás neochrání.
Výš tvrdím: „Pokud pracujete na dlouhé Session a máte spojení do MCP Collabim stále aktivní, nemělo by dojít k přerušení spojení.“
To neplatí. Aktivita spojení nemá s platností tokenu nic společného. Token je časové razítko vydané při startu, ne něco, co by se používáním prodlužovalo. Po šedesáti minutách začne každý požadavek končit 401, ať se dělo cokoliv. Ono je to vlastně přesně naopak. Dlouhá souvislá session je ten nejzranitelnější scénář, protože v něm strávíte nejvíc času za hranicí platnosti tokenu.
Proč to vypadalo, že server běží?
Tohle mě mátlo nejdéle: v Settings → Developer server svítil jako Running, a přesto neodpovídal. Ten indikátor totiž hlídá jen to, jestli žije proces, tedy jestli běží cmd nebo node a drží spojení. O tom, co se děje na druhé straně HTTPS spojení, neví nic. Proces si tedy vesele běžel, ale každý request končil 401 a Claude ho po 60 sekundách odstřelil na timeout. I tady platí moje Poznámka 1 výše – jděte do %APPDATA%\Claude\logs\. Jen tentokrát nehledáte chybu při startu, ale opakované 401 hodinu po něm.
Jak jsem to tedy vyřešil?
Wrapper z Kroku 2 i mcp-remote jsem zahodil. Nahradila je vlastní stdio proxy – jeden soubor v Node bez závislostí, který si drží Collabim client_id a Collabim client_secret:
Claude → stdio → collabim-proxy.js — HTTPS → mcp.oncollabim.com
├─ token starší než 80 % životnosti? → obnoví
└─ přišla 401? → obnoví a request zopakuje
Rozdíl je v tom slově obnoví. mcp-remote je obecné spojení mezi stdio a HTTP. Dostane textovou hlavičku a kopíruje ji do každého requestu. Když token umře, nemá co dělat. Wrapper si ho aspoň tahal automaticky, ale jen jednou, při startu.
Ověřil jsem si to: dva kontrolní dotazy na Collabim účet – 80 minut a pak 2,5 hodiny po startu Claude, tedy po nejméně jedné a podruhé po třech automatických obnovách, vrátily data okamžitě. 👏 Přesně tady dřív přišel ten 60sekundový timeout.
Dvě věci jsem tím vyřešil. is-cache-collabim popisuji výše jako řešení hodinového tokenu; byla to dobrá berlička, ale berlička. Teď se vrací do původní role, tedy čistá úspora tokenů. A jestli Collabim platnost tokenu prodlouží: možná prodlouží, ale nemusím na to čekat. Šedesát minut je úplně běžná životnost client_credentials tokenu. Chybí jen ta vrstva, která si ho umí vyžádat znovu. A tu si můžete napsat sami.
A nakonec – Funguje nastavení z claude_desktop_config.json i v Claude Code?
Ne. Claude Code má vlastní registr MCP serverů a tenhle soubor vůbec nečte. Takže přestože se článek jmenuje „v Claude Code“, návod výš je pro Claude Desktop. Do Code se server registruje zvlášť přes claude mcp add, kontrola pak claude mcp list. Stejný skript, dvě nezávislé registrace.
➡️ Časté otázky k Collabim MCP v Claude
Funguje to i v Claude webové verzi (claude.ai)?
Ne. MCP servery jsou dostupné pouze v Claude Desktop aplikaci a IDE rozšířeních (VS Code, JetBrains). Webová verze MCP nepodporuje.
Mohu mít připojených víc Collabim účtů najednou?
Ano. Stačí vytvořit samostatný .cmd skript pro každý účet s jeho vlastním client ID a secret, a přidat více záznamů do mcpServers v configu. Testoval jsem dva účty současně – funguje bez problémů. Aktualizace srpen 2026: s proxy z dodatku už duplicitní .cmd skripty nepotřebujete – jeden soubor obsluhuje oba účty, liší se jen env v konfiguraci. Počítejte ale s tím, že každý připojený účet přidá zhruba 70 nástrojů do kontextu; ten méně používaný se vyplatí držet vypnutý.
Proč mcp-remote@0.1.37 a ne aktuální verze?
V době testování byla aktuálnější verze (0.1.38+) a ta měla agresivnější OAuth discovery, která s výše uvedeným postupem na Collabimu nefunguje. Vynucená verze 0.1.37 je prověřená. [původní setup] Až Collabim přidá podporu dynamic client registration, bude fungovat i aktuální verze.
Co když log hlásí ‚C:\Program‘ is not recognized as an internal or external command?
Node.js je nainstalovaný v cestě s mezerou (C:\Program Files\nodejs). Wrapper skript to řeší použitím přímé cesty k npx.cmd – ujistěte se, že v .cmd souboru máte „C:\Program Files\nodejs\npx.cmd“ v uvozovkách.
Kde najdu MCP client ID a secret v Collabimu?
Collabim účet → Osobní údaje → sekce API klíč.
Vedle samotného API klíče najdete tlačítko pro zobrazení MCP přihlašovacích údajů.
Užitečné zdroje:
- Vlastní testování a ladění na Windows 11, za nemalé podpory Claude Desktop / Code, červen – srpen 2026
- Collabim dokumentace MCP serveru — nastavení a OAuth flow
- mcp-remote changelog verzí a chování OAuth discovery
