Připojení Claude, ChatGPT a dalších

Postup

1. 1

   Ověřte, že je přihlašování zapnuté

   Přihlašování přes AI konektor je ve výchozím stavu vypnuté a zapíná ho technická podpora Visualbooku. V panelu otevřete Váš účet a podívejte se do sekce MCP konektory (čtení i zápis). Pokud tam vidíte hlášku „Přihlašování přes MCP je vypnuté“, napište podpoře a pokračujte, až přihlašování zapne.

2. 2

   Zkopírujte adresu konektoru

   Je to adresa manuálu s koncovkou /mcp, například https://vaseznacka.visualbook.pro/mcp. Návod s předvyplněnou adresou pro každý nástroj najdete v panelu ve Vašem účtu v sekci MCP konektory pod Jak připojit aplikaci.

3. 3

   Přidejte konektor do AI nástroje

   Postup se liší podle nástroje – najdete ho níže v části s názvem vašeho nástroje. Většina nástrojů potřebuje jen název konektoru a adresu.

4. 4

   Požádejte agenta o připojení

   Napište agentovi „Připoj se k Visualbooku“. Přihlašovací okno se neotvírá samo při každém spuštění nástroje – objeví se, až o připojení požádáte. Výjimkou je ChatGPT, který přihlášení otevře hned po vytvoření konektoru.

5. 5

   Přihlaste se účtem z panelu

   V prohlížeči zadejte e-mail svého účtu ve Visualbooku a klikněte na Poslat přihlašovací kód. Kód z e-mailu vložte do pole Přihlašovací kód. Pokud máte heslo, můžete zvolit Přihlásit se heslem.

6. 6

   Povolte přístup

   Na obrazovce Povolit přístup? je Čtení obsahu vždy aktivní. Volba Úpravy obsahu (zápis přes MCP) je předem zapnutá – nechte ji tak, pokud má agent v manuálu i pracovat, jinak ji vypněte. Potvrďte tlačítkem Povolit a vraťte se do AI nástroje.

Claude (claude.ai a Claude Desktop)

Otevřete Nastavení → Connectors → Add custom connector a vložte adresu …/mcp. Konektor pak funguje i v mobilní aplikaci Claude.

ChatGPT

1. Otevřete Settings → Plugins (dříve Apps & Connectors).
2. Zapněte Developer mode.
3. Klikněte na + nebo Create.
4. Vložte adresu …/mcp a jako ověření zvolte OAuth.

Claude Code

V terminálu spusťte:

claude mcp add --transport http visualbook https://vaseznacka.visualbook.pro/mcp

Stav připojení ověříte v Claude Code příkazem /mcp.

Cursor

Konektor zapište do souboru ~/.cursor/mcp.json (platí pro všechny projekty), nebo .cursor/mcp.json (jen pro jeden projekt):

{"mcpServers": {"visualbook": {"url": "https://vaseznacka.visualbook.pro/mcp"}}}

VS Code

Konektor zapište do souboru .vscode/mcp.json v kořeni projektu:

{"servers": {"visualbook": {"type": "http", "url": "https://vaseznacka.visualbook.pro/mcp"}}}

Nástroje Visualbooku se pak objeví v Copilot Chatu v režimu Agent.

Codex

V terminálu přidejte konektor:

codex mcp add visualbook --url https://vaseznacka.visualbook.pro/mcp

Pak se přihlaste příkazem codex mcp login visualbook. Místo příkazu můžete konektor zapsat i do souboru ~/.codex/config.toml.

Gemini CLI

V terminálu spusťte:

gemini mcp add --transport http -s user visualbook https://vaseznacka.visualbook.pro/mcp

Místo příkazu můžete konektor zapsat i do souboru ~/.gemini/settings.json.

Jiný nástroj s podporou MCP

Přidejte adresu …/mcp podle návodu daného nástroje. Nástroj, který umí pracovat jen s lokálním serverem, připojíte příkazem:

npx -y mcp-remote https://vaseznacka.visualbook.pro/mcp

Příkaz vyžaduje Node.js.

Veřejný konektor jen pro čtení

Když se mají na pravidla značky ptát kolegové, agentury nebo dodavatelé bez účtu v panelu, zapněte veřejný konektor:

1. V panelu otevřete Nastavení a záložku MCP.
2. Přepínač Aktivovat veřejný MCP server? nastavte na Ano a uložte.
3. Na stejné záložce zkopírujte adresu https://vaseznacka.visualbook.pro/mcp/public a konfiguraci pro jednotlivé nástroje.

Veřejný konektor nevyžaduje přihlášení – v claude.ai nechte pole pro OAuth prázdná, v ChatGPT zvolte No authentication.

Na úvodní stránce manuálu se objeví karta s návodem k připojení. Pokud ji tam nechcete, zapněte Skrýt kartu MCP připojení na homepage – konektor poběží dál.

U manuálu s více značkami vyberte v poli Rozsah konektoru buď Všechny značky, nebo jednu podznačku. Konektor jedné značky má adresu …/mcp/public/nazev-znacky a čte jen ji.

Více Visualbooků v jednom nástroji

Spravujete víc samostatných Visualbooků? Přidejte každý jako samostatný konektor pod vlastním názvem, například acme a nordhook. U existujícího konektoru nikdy nepřepisujte adresu na jiný manuál.

V zadání pak manuál jmenujte adresou: „Ve Visualbooku acme.visualbook.pro uprav stránku Barvy…“ Agent musí u každého zápisu uvést adresu manuálu. Když nesedí, Visualbook zápis odmítne.

Co když připojení nefunguje

Přihlašovací okno hlásí „Přihlašování přes MCP je na tomto Visualbooku vypnuté“. Přihlašování zapíná technická podpora. Napište podpoře.

ChatGPT po udělení souhlasu ukáže „Missing OAuth callback data“. Souhlas musí proběhnout ve stejném prohlížeči, ve kterém jste připojení začali. Zkuste to znovu v něm.

Klikli jste na „Zamítnout“ nebo „Teď ne – přestat žádat“. Okno se samo znovu neukáže. Až budete chtít, požádejte agenta o připojení znovu.

Agent říká, že nemůže zapisovat. Při přihlášení nebyly povolené Úpravy obsahu, nebo k nim váš účet nemá oprávnění. V sekci MCP konektory u aplikace klikněte na Odvolat a připojte se znovu se zapnutými úpravami.

Cursor nebo VS Code se nezeptá na přihlášení. Požádejte agenta o připojení k Visualbooku. V Cursoru můžete přihlášení spustit i v Settings → MCP přes Needs login.

Máte starší konfiguraci s hlavičkou `Authorization: Bearer vbmcp_…`. Osobní tokeny už neplatí. Hlavičku smažte a připojte se přihlášením.