Nastavte MCP v štyroch krokoch
Dajte Claude alebo Cursoru prístup na čítanie aj zápis do vašich projektov v Taskwichi. Zaberie to približne šesť minút.
Inštalácia konektora
Jeden príkaz umiestni do vašej cesty jediný spustiteľný súbor taskwich-mcp a nič viac. Konektor vyžaduje Node.js 20 alebo novší — skript to skontroluje a upozorní vás, ak chýba.
curl -fsSL https://taskwich.app/install/mcp.sh | sh
Nainštaluje sa do ~/.local/bin. Ak tento priečinok nie je vo vašej PATH — na macOS je to bežné — skript vypíše presný riadok, ktorý treba pridať do profilu shellu.
Opakované spustenie toho istého príkazu vykoná aktualizáciu na mieste
Vytvorenie API kľúča
Otvorte Nastavenia → API kľúče a vytvorte nový. Pomenujte ho podľa zariadenia, na ktorom ste — podľa tohto mena ho neskôr nájdete pri rušení. Tajný kľúč sa zobrazí iba raz; hneď si ho skopírujte do konfigurácie klienta.
S kľúčom zaobchádzajte ako s heslom. Ktokoľvek s kľúčom koná vo vašom pracovisku ako vy. Nedávajte ho do chatov, snímok obrazovky ani do verzovania.
Prepojenie s klientom
Claude Code, raz na každom zariadení:
claude mcp add taskwich --env TASKWICH_API_KEY=tsk_... -- taskwich-mcp
Claude Desktop a Cursor používajú rovnaký JSON na každej platforme. Claude Desktop ho má v Settings → Developer → Edit config, Cursor číta ~/.cursor/mcp.json. Claude Desktop úplne ukončite a znova otvorte — zatvorenie okna nestačí.
- macOS — Claude Desktop nečíta profil vášho shellu. Ak samotný príkaz nenájde, uveďte do poľa command absolútnu cestu /Users/<meno>/.local/bin/taskwich-mcp.
- Windows — ak sa príkaz hneď po inštalácii nenájde, reštartujte aplikáciu; zdedí PATH, s ktorou bola spustená.
Overenie
Spustite novú reláciu a napíšte /mcp — mali by ste vidieť 71 nástrojov v 12 doménach. Oprávnenia kopírujú váš účet: agent sa nikdy nedostane ďalej než vy. Úplný zoznam nájdete v článku Referencia nástrojov MCP.
Nastavenia
| Pole | Očakávaná hodnota | Povinné | Parameter |
|---|---|---|---|
| TASKWICH_API_KEY | Osobný kľúč — začína na tsk_ | Povinné | --api-key= |
| TASKWICH_API_URL | URL — predvolene https://taskwich.app | Voliteľné | --api-url= |
Uprednostnite premenné prostredia — parametre vidno vo výpise procesov. Konektor odmietne nešifrované HTTP pre všetko okrem localhostu, požiadavky vypršia po 30 sekundách a kľúč sa nikdy neobjaví v chybovej hláške.
Zrušenie prístupu
Zmažte kľúč v Nastavenia → API kľúče. Klient stratí prístup pri najbližšej požiadavke — žiadna cache, žiadna relácia.