Integrační návod

Nastavte MCP ve čtyřech krocích

Dejte Claude, Codexu, Cursoru nebo jinému MCP klientovi přístup pro čtení i zápis do vašich projektů v Taskwichi. Zabere to zhruba šest minut.

Instalace konektoru

Jeden příkaz umístí do vaší cesty jediný spustitelný soubor taskwich-mcp a nic víc. Konektor vyžaduje Node.js 20 nebo novější — skript to zkontroluje a upozorní vás, pokud chybí.

zsh

$ curl -fsSL https://taskwich.app/install/mcp.sh | sh

Nainstaluje se do ~/.local/bin. Pokud tato složka není ve vaší PATH — na macOS je to běžné — skript vypíše přesný řádek, který přidáte do profilu shellu.

Otevře prohlížeč ke schválení; žádný klíč ke kopírování. Instalátor poté otevře prohlížeč ke schválení a zaregistruje Taskwich v AI nástrojích, které najde. Pokud skončí úspěšně, můžete přeskočit na Ověření.

Opakované spuštění téhož příkazu provede aktualizaci na místě

Ruční postup: vytvořte API klíč

Potřebné, jen pokud instalátor váš nástroj nenajde. Otevřete Nastavení → API klíče a vytvořte klíč. Pojmenujte ho podle zařízení, na kterém jste — podle názvu ho později najdete při zrušení. Tajný klíč se zobrazí jednou; hned ho zkopírujte do konfigurace nástroje.

S klíčem zacházejte jako s heslem. Kdokoli s klíčem jedná ve vašem pracovním prostoru jako vy. Nedávejte ho do chatů, snímků obrazovky ani do verzování.

Ruční postup: propojení s klientem

Vyberte svůj AI nástroj a nahraďte tsk_... svým klíčem. Když klíč vytvoříte v Nastavení → API klíče, uvidíte tytéž příkazy s už vyplněným klíčem.

1Přidejte ho do Claude Code

zsh

$ claude mcp add --scope user --env TASKWICH_API_KEY=tsk_... --transport stdio taskwich -- taskwich-mcp

Klíč zůstane v historii shellu. Na sdíleném počítači ji poté smažte.

Ověření

Spusťte novou relaci a napište /mcp — měli byste vidět 108 nástrojů ve 13 doménách. Oprávnění kopírují váš účet: agent se nikdy nedostane dál než vy. Úplný seznam najdete v článku Reference nástrojů MCP.

Nastavení

Pole	Očekávaná hodnota	Povinné	Parametr
TASKWICH_API_KEY	Osobní klíč — začíná na tsk_	Povinné	--api-key=
TASKWICH_API_URL	URL — výchozí https://taskwich.app	Volitelné	--api-url=

Upřednostněte proměnné prostředí — parametry jsou vidět ve výpisu procesů. Konektor odmítne nešifrované HTTP pro vše kromě localhostu, požadavky vyprší po 30 sekundách a klíč se nikdy neobjeví v chybové hlášce.

Zrušení přístupu

Smažte klíč v Nastavení → API klíče. Klient ztratí přístup při nejbližším požadavku — žádná cache, žádná relace.