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 👍.
*️⃣ 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-scuka": {
"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-scuka ?
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.
➡️ Č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ů.
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á. 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 2026
- Collabim dokumentace MCP serveru — nastavení a OAuth flow
- mcp-remote changelog verzí a chování OAuth discovery
