Prevádzka na vlastnom počítači

Táto časť nastavuje CDESK MCP server na vašom vlastnom počítači, pre vaše vlastné konto v CDESK. Vaša AI aplikácia si ho spustí, keď ho potrebuje, a komunikuje so systémom CDESK priamo z vášho stroja – na server sa neinštaluje nič a z vášho počítača neodchádza nič okrem bežných volaní do CDESK. Trvá to približne 15 minút, väčšinu z toho čakanie na sťahovanie.

Predpoklady inštalácie

Pre inštaláciu potrebujete všetko z kapitoly Predpoklady nasadenia a k tomu jedno obmedzenie, ktoré platí len tu: toto konto musí mať vypnuté 2FA. Táto inštalácia sa prihlasuje menom a heslom a samotné heslo cez výzvu 2FA neprejde. Prihlásenie cez Microsoft so zapnutým 2FA funguje, ale na vlastnom počítači k dispozícii nie je – len v cloude CDESK MCP alebo na firemnom serveri. Ak teda 2FA musí zostať zapnuté, použite prosím cloud CDESK MCP alebo si od správcu vypýtajte samostatné konto bez neho.

Softvér na inštaláciu

1. Git – použije sa raz, na stiahnutie súborov CDESK MCP. Windows: https://git-scm.com/download/win · macOS: xcode-select –install

Git môžete vynechať a súbory si stiahnuť ako ZIP (Stiahnutie CDESK MCP), ale Git sa oplatí: neskoršie aktualizácie sú potom jediný príkaz, kým inštalácie zo ZIP-u treba vymieňať ručne.

2. Python 3.11 alebo novší – https://www.python.org/downloads/ Vo Windowse v inštalátore zaškrtnite „Add python.exe to PATH“.

3. uv – nástroj, ktorý nainštaluje, čo CDESK MCP potrebuje, a spustí ho. Otvorte terminál (Windows: PowerShell; macOS: Terminal) a spustite:

python -m pip install uv

Ten istý príkaz funguje vo Windowse, macOS aj Linuxe – na macOS a Linuxe použite python3, ak sa python nenájde. Potom zavrite a znova otvorte terminál, aby nový príkaz zaregistroval.

Overte si, že sú všetky tri pripravené. Každý riadok by mal vypísať verziu:

git --version
python --version
uv --version

Ak si zvolíte inštaláciu zo ZIP-u, git –version môže zlyhať a to je v poriadku – zvyšné dva musia fungovať. Ak sa uv po opätovnom otvorení terminálu stále nenájde, reštartujte počítač a skúste znova.

Ďalšie spôsoby inštalácie uv (ak ho radšej nechcete inštalovať do svojho Pythonu). Ktorýkoľvek z nich vám dá ten istý nástroj – použite ho namiesto kroku 3, nie popri ňom:

Windows, cez správcu balíkov od Microsoftu:

winget install --id astral-sh.uv -e

macOS, cez Homebrew:

brew install uv

macOS / Linux, cez skript výrobcu:

curl -LsSf https://astral.sh/uv/install.sh | sh

Ak nefunguje ani jeden z nich, oficiálny postup nájdete na https://docs.astral.sh/uv/getting-started/installation/.

Ktoré AI aplikácie túto možnosť podporujú

Podstatné je, či vaša AI aplikácia dokáže spustiť program na vašom vlastnom počítači.

Tieto to dokážu – vyberte si jednu:

Aplikácia	Kde beží	Nastavenie v
Desktopová aplikácia Claude	Windows / macOS	Pripojenie AI aplikácie, možnosť A – najjednoduchšie
Claude Code	terminál	Pripojenie AI aplikácie, možnosť B
Gemini CLI	terminál	Pripojenie AI aplikácie, možnosť C
Codex CLI (súčasť platených programov ChatGPT)	terminál	Pripojenie AI aplikácie, možnosť D

Tieto to nedokážu:

Aplikácia	Prečo
ChatGPT (web alebo aplikácia)	Pripája sa len na konektor zverejnený na internetovej adrese, nie na taký, ktorý beží na vašom počítači. Codex CLI od OpenAI to dokáže – pozri tabuľku vyššie
Gemini webová aplikácia	To isté. Lokálne funguje Gemini CLI z tabuľky vyššie
Microsoft Copilot	To isté
Claude v prehliadači	To isté – na konektor vo vašom počítači použite desktopovú aplikáciu Claude

Ak je vaša aplikácia v druhej tabuľke, použite prosím cloud CDESK MCP – kroky nižšie pre ňu fungovať nebudú.

AI aplikácie sa rýchlo menia. Ak tú vašu v zozname nevidíte, hľadajte v jej nastaveniach MCP, connectors, tools alebo extensions. Ak dokáže spustiť konektor na vašom počítači, dokáže spustiť aj tento: zadajte jej ten istý príkaz a nastavenia ako v možnostiach v kapitole Pripojenie AI aplikácie, ktoré sú pre všetky aplikácie rovnaké.

Stiahnutie CDESK MCP

Dva spôsoby, ako získať tie isté súbory – vyberte si jeden. CDESK MCP sa v oboch prípadoch správa rovnako; rozdiel je len v tom, ako budete získavať aktualizácie.

Možnosť A - cez Git (odporúčané)

Vyberte si priečinok, v ktorom ho chcete mať – príklad používa váš používateľský priečinok – a spustite:

cd $HOME
git clone https://github.com/Inovalogic-s-r-o/CDESK-MCP cdesk-mcp
cd cdesk-mcp

Na macOS a Linuxe použite cd ~ namiesto cd $HOME. Neskoršie aktualizácie sú dva príkazy a vaše nastavenia zostávajú presne tam, kde sú.

Možnosť B - stiahnutie ZIP (bez Gitu)

1. Otvorte v prehliadači https://github.com/Inovalogic-s-r-o/CDESK-MCP.

2. Nad zoznamom súborov vpravo je zelené tlačidlo < > Code. Kliknite naň a na karte Local kliknite dole na Download ZIP.

3. Prehliadač uloží súbor s názvom ako cdesk-mcp-main.zip, zvyčajne do priečinka Stiahnuté súbory.

Nevidíte zelené tlačidlo? Pravdepodobne nie ste na úvodnej stránke repozitára – odkaz vás mohol zaviesť na jeden súbor alebo na inú kartu. Kliknite na názov repozitára vľavo hore a uistite sa, že ste na karte Code.

4. ZIP rozbaľte – nepracujte v ňom. Windows: pravým tlačidlom na súbor → Extrahovať všetko… → vyberte kam → Extrahovať. Dvojklik na ZIP vo Windowse ho len zobrazí a príkazy spustené nad takýmto zobrazením zlyhajú. Na macOS dvakrát kliknite a rozbalí sa vedľa seba.

5. Rozbalený priečinok presuňte tam, kde ho chcete mať, napríklad C:\Users\vasemeno\cdesk-mcp.

6. Nájdite ten správny priečinok. GitHub ho pomenuje podľa vetvy, napríklad cdesk-mcp-main, a Windows ho často zabalí do druhého priečinka s tým istým názvom. Ten, ktorý potrebujete, priamo obsahuje pyproject.toml, popri ňom README.md, .env.example a priečinok src. Otvárajte priečinky, kým ich neuvidíte, a odvtedy pracujte v tom priečinku – pokojne ho premenujte na cdesk-mcp.

7. Otvorte v tom priečinku terminál. Vo Windowse je najjednoduchšie kliknúť naň pravým tlačidlom → Otvoriť v termináli. Inak doň prejdite cez cd a príkazom ls si overte, že je v ňom pyproject.toml.

ZIP nemá spätné prepojenie na miesto, odkiaľ pochádza, takže aktualizácia znamená ďalšie kolo sťahovania, rozbaľovania a prenášania nastavení. Prejsť inam nie je neskoro – nainštalujte Git, naklonujte si projekt nanovo a súbor s nastaveniami skopírujte do klonu.

Zapíšte si celú cestu k tomuto priečinku – budete ju potrebovať v kapitole Pripojenie AI aplikácie. Vypíšete ju takto:

pwd

Napríklad C:\Users\vasemeno\cdesk-mcp. Vo Windowse si ju poznačte s lomkami dopredu – C:/Users/vasemeno/cdesk-mcp – pretože v takom tvare ju očakávajú súbory s nastaveniami nižšie.

Odtiaľto je všetko pre obe možnosti rovnaké.

Inštalácia a konfigurácia prihlásenia

Inštalácia potrebných súčastí

Z vnútra toho priečinka:

uv sync

Vytvorí sa tým súkromné prostredie Pythonu a stiahne sa, čo CDESK MCP potrebuje. Trvá to minútu či dve a vypíše sa zoznam balíkov. Robíte to len raz – a znova po každej aktualizácii.

Zadanie prihlasovacích údajov do CDESK

CDESK MCP ich číta zo súboru .env, ktorý zostáva vo vašom počítači a nikam sa nenahráva. Máte šablónu .env.example, ale vlastný .env nie, pretože ten obsahuje vaše heslo – vytvoríte si ho preto tu, raz.

1. Skopírujte šablónu:

Windows (PowerShell):

Copy-Item .env.example .env

macOS / Linux:

cp .env.example .env

2. Otvorte .env v ľubovoľnom textovom editore – Poznámkový blok stačí. Podstatné sú tri hodnoty. CDESK_BASE_URL je zástupná adresa, ktorú musíte nahradiť; ďalšie dve sú prázdne a vypĺňate ich vy:

CDESK_BASE_URL=https://your-cdesk-server.domain
CDESK_LOGIN=your.login
CDESK_PASSWORD=your-password

CDESK_BASE_URL – adresa vášho CDESK, tá, cez ktorú CDESK otvárate v prehliadači, bez /api na konci. Nie je to adresa CDESK MCP.
CDESK_LOGIN – vaše používateľské meno alebo e-mail, presne tak, ako sa prihlasujete.
CDESK_PASSWORD – heslo k tomuto kontu.

3. Súbor uložte.

Všetko ostatné v šablóne je nepovinné a už zakomentované; predvolené hodnoty sú v poriadku. Jediná, ktorá vás môže zaujímať, je CDESK_TIMEZONE s predvolenou hodnotou Europe/Bratislava, ktorá určuje, čo znamená čas bez časovej zóny – napríklad „zajtra o 8:00“.

Súbor .env si prosím chráňte. Obsahuje vaše heslo v čitateľnej podobe. Nekopírujte ho do chatu, do tiketu ani na zdieľaný disk a nikam ho nekomitujte – z Gitu je zámerne vylúčený.

Overte si, že sa CDESK MCP spustí

Stále v priečinku CDESK MCP spustite:

uv run cdesk-mcp

Úspech vyzerá ako niekoľko riadkov a potom niečo, čo pripomína zaseknutie. Každý skutočný riadok sa začína aj časovou pečiatkou, tu orezanou:

INFO cdesk_mcp.__main__: cdesk-mcp starting (transport=stdio)
INFO cdesk_mcp.enums: EnumCache[v3/task/enums] loaded: {...}
INFO cdesk_mcp.__main__: CDESK ready against https://your-cdesk-server.domain; task buckets: [...]

Podstatný je riadok CDESK ready against … – znamená, že sa CDESK MCP prihlásil a úspešne načítal nastavenia vášho CDESK.

Zdanlivé zaseknutie je správne: CDESK MCP čaká, kým sa mu ozve AI aplikácia. Stlačte Ctrl+C, čím ho zastavíte, a pokračujte ďalej. Ak namiesto toho vidíte varovanie, pravdepodobné príčiny nájdete v kapitole Keď niečo nefunguje.