Integračný návod

Nastavte MCP v štyroch krokoch

Dajte Claude, Codexu, Cursoru alebo inému MCP klientovi prístup na čítanie aj zápis do vašich projektov v Taskwichi. Zaberie to približne šesť minút.

01

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.

zsh
$ 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.

Otvorí prehliadač na schválenie; žiadny kľúč na kopírovanie. Inštalátor potom otvorí prehliadač na schválenie a zaregistruje Taskwich v AI nástrojoch, ktoré nájde. Ak skončí úspešne, môžete preskočiť na Overenie.

Opakované spustenie toho istého príkazu vykoná aktualizáciu na mieste

02

Ručný postup: vytvorte API kľúč

Potrebné, len ak inštalátor nedosiahne váš nástroj. Otvorte Nastavenia → API kľúče a vytvorte kľúč. Pomenujte ho podľa zariadenia, na ktorom ste — podľa názvu ho neskôr nájdete pri zrušení. Tajný kľúč sa zobrazí raz; hneď ho skopírujte do konfigurácie nástroja.

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.

03

Ručný postup: prepojenie s klientom

Vyberte svoj AI nástroj a nahraďte tsk_... svojím kľúčom. Keď kľúč vytvoríte v Nastavenia → API kľúče, uvidíte tieto isté príkazy s už vyplneným kľúčom.

1Pridajte ho do Claude Code
zsh
$ claude mcp add --scope user --env TASKWICH_API_KEY=tsk_... --transport stdio taskwich -- taskwich-mcp
  • Kľúč zostane v histórii shellu. Na zdieľanom počítači ju potom vymažte.
04

Overenie

Spustite novú reláciu a napíšte /mcp — mali by ste vidieť 108 nástrojov v 13 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

PoleOčakávaná hodnotaPovinnéParameter
TASKWICH_API_KEYOsobný kľúč — začína na tsk_Povinné--api-key=
TASKWICH_API_URLURL — predvolene https://taskwich.appVoliteľ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.