Nastavte MCP ve čtyřech krocích
Dejte Claude nebo Cursoru 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í.
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.
Opakované spuštění téhož příkazu provede aktualizaci na místě
Vytvoření API klíče
Otevřete Nastavení → API klíče a vytvořte nový. Pojmenujte ho podle zařízení, na kterém jste — podle tohoto jména ho později najdete při rušení. Tajný klíč se zobrazí jen jednou; hned si ho zkopírujte do konfigurace klienta.
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í.
Propojení s klientem
Claude Code, jednou na každém zařízení:
claude mcp add taskwich --env TASKWICH_API_KEY=tsk_... -- taskwich-mcp
Claude Desktop a Cursor používají stejný JSON na každé platformě. Claude Desktop ho má v Settings → Developer → Edit config, Cursor čte ~/.cursor/mcp.json. Claude Desktop zcela ukončete a znovu otevřete — zavření okna nestačí.
- macOS — Claude Desktop nečte profil vašeho shellu. Pokud samotný příkaz nenajde, uveďte do pole command absolutní cestu /Users/<jméno>/.local/bin/taskwich-mcp.
- Windows — pokud se příkaz hned po instalaci nenajde, restartujte aplikaci; zdědí PATH, se kterou byla spuštěna.
Ověření
Spusťte novou relaci a napište /mcp — měli byste vidět 71 nástrojů ve 12 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.