Domov Dokumentácia AI CDESK MCP server Nastavenie a prevádzka CDESK MCP Prevádzka na vlastnom počítači

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.

Pripojenie AI aplikácie

Možnosť A - desktopová aplikácia Claude

1. Otvorte Settings → Developer → Edit Config. Otvorí sa priečinok so súborom claude_desktop_config.json.

Ak túto ponuku nenájdete, otvorte si priečinok sami a súbor v ňom vytvorte:

- Windows: stlačte Win+R, vložte %APPDATA%\Claude a stlačte Enter
- macOS: ~/Library/Application Support/Claude/

2. Claude úplne zavrite, až potom upravujte.

3. Otvorte claude_desktop_config.json v textovom editore a vložte doň toto, pričom cestu nahraďte svojím priečinkom z kapitoly Stiahnutie CDESK MCP:

{
  "mcpServers": {
    "cdesk": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/Users/vasemeno/cdesk-mcp",
        "run",
        "cdesk-mcp"
      ]
    }
  }
}

Tri veci, na ktoré si dať pozor:

- Používajte lomky dopredu (C:/Users/…), aj vo Windowse.
- Ak už súbor obsahuje iné položky, pridajte len blok „cdesk“: { … } dovnútra existujúceho „mcpServers“.
- Ak Claude napíše, že uv sa nedá nájsť, nahraďte „command“: „uv“ celou cestou, ktorú vypíše (Get-Command uv).Source vo Windowse alebo which uv na macOS.

4. Spustite Claude. CDESK by sa mal objaviť v jeho zozname nástrojov.

Možnosť B - Claude Code

Jeden príkaz, s vaším priečinkom z kapitoly Stiahnutie CDESK MCP:

claude mcp add cdesk -- uv --directory C:/Users/vasemeno/cdesk-mcp run cdesk-mcp

Potom si to overte príkazom claude mcp list.

Možnosť C - Gemini CLI

Otvorte – alebo vytvorte – súbor .gemini/settings.json vo svojom používateľskom priečinku: C:\Users\vasemeno\.gemini\settings.json vo Windowse, ~/.gemini/settings.json na macOS. Pridajte ten istý blok ako v možnosti A, so svojou cestou z kapitoly Stiahnutie CDESK MCP:

{
  "mcpServers": {
    "cdesk": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/Users/vasemeno/cdesk-mcp",
        "run",
        "cdesk-mcp"
      ]
    }
  }
}

Potom CLI reštartujte. Novšie verzie majú aj príkaz gemini mcp, ktorý dokáže konektory pridávať a vypisovať za vás – skúste gemini mcp –help.

Možnosť D - Codex CLI

Codex používa namiesto JSON-u súbor .toml. Otvorte – alebo vytvorte – .codex/config.toml vo svojom používateľskom priečinku a pridajte svoju cestu z kapitoly Stiahnutie CDESK MCP:

[mcp_servers.cdesk]
command = "uv"
args = ["--directory", "C:/Users/vasemeno/cdesk-mcp", "run", "cdesk-mcp"]

Všimnite si, že názov sekcie je mcp_servers, s podčiarkovníkom – je to zápis tej istej veci, ktorú súbory JSON volajú mcpServers. Potom Codex reštartujte.

Novšie verzie to zvládnu aj bez úpravy súboru:

codex mcp add cdesk -- uv --directory C:/Users/vasemeno/cdesk-mcp run cdesk-mcp
codex mcp list

Kontrola, že konektor beží

Opýtajte sa svojho asistenta:

{"name":"cdesk-mcp","version":"0.1.0","transport":"stdio","status":"ready"}

Mali by ste dostať niečo ako {„name“:“cdesk-mcp“,“version“:“0.1.0″,“transport“:“stdio“,“status“:“ready“}. status: ready znamená, že máte hotovo.

Ak chcete vidieť, čo ste získali, otvorte v aplikácii zoznam nástrojov – v desktopovej aplikácii Claude je to ikona pod textovým poľom – a rozbaľte cdesk. Mali by ste vidieť vypísané nástroje CDESK. Ak tam sú, všetko je zapojené.

Riešenie problémov

„CDESK credentials are not configured…“Súbor .env chýba, je v nesprávnom priečinku alebo je niektorá hodnota prázdna. Musí ležať priamo v priečinku CDESK MCP vedľa pyproject.toml a volať sa presne .env – pozor na Poznámkový blok, ktorý ho môže uložiť ako .env.txt.

uv sync píše, že tam nie je projekt ani pyproject.toml (inštalácie zo ZIP-u)Ste o priečinok vyššie alebo nižšie. Pracujte v priečinku, ktorý priamo obsahuje pyproject.toml, a uistite sa, že ste ZIP naozaj rozbalili a neotvorili ho len na prezeranie.

„CDESK startup probe failed (all caches errored – likely auth or connectivity)…“Vaše údaje sa našli, ale prihlásenie nefungovalo. Podľa pravdepodobnosti: preklep v CDESK_BASE_URL; nesprávne meno alebo heslo; adresa CDESK, ktorá potrebuje VPN; zapnuté 2FA na konte; oblasť, ktorú potrebujete, je v CDESK vypnutá. Správa končí pôvodnou chybou, ktorá zvyčajne pomenuje skutočnú príčinu.

„CDESK partial startup – some enum caches failed…“ Nie je to zlyhanie. Prihlásenie fungovalo a CDESK MCP beží; len namiesto riadku CDESK ready against … dostanete tento. Znamená, že jedna z oblastí, ktoré číta pri štarte, neodpovedala – zvyčajne preto, že je v CDESK vypnutá alebo k nej vaše konto nemá práva, občas ide len o výpadok na strane CDESK. Správa pomenuje, o ktoré ide, a všetko ostatné funguje normálne.

„CDESK /auth/login returned 302 (likely a 2FA challenge…)“Toto konto má zapnuté 2FA. Použite konto bez neho alebo požiadajte správcu, nech ho pre konto, ktoré CDESK MCP používa, vypne.

„Module disabled“ (kód 9)Vlastná správa CDESK: táto oblasť je vo vašich nastaveniach CDESK vypnutá. Správca ju vie zapnúť v časti Administrácia → Globálne nastavenia → daný modul → Zapnuté.

„HTTP 403“Vaše konto nemá k tejto oblasti práva. Správca vám ich vie prideliť v časti Administrácia → ACL → daná skupina → oprávnenie príslušného modulu.

Zlyháva všetko, na čokoľvek sa spýtatePožiadajte správcu, nech potvrdí, že váš CDESK je vo verzii 3.2.12 alebo novšej a že licencia vášho konta v CDESK takýto prístup umožňuje – ak je problém v tomto, chyba to povie. Ani jedno sa nedá vyriešiť zmenou čohokoľvek na vašom počítači.

Vaša AI aplikácia CDESK vôbec nezobrazujeZvyčajne ide o preklep v súbore s nastaveniami – chýbajúcu čiarku alebo zátvorku – nesprávnu cestu k priečinku, spätné lomky namiesto lomiek dopredu alebo o aplikáciu, ktorá nebola úplne reštartovaná. Overte si, že kapitola Overte si, že sa CDESK MCP spustí stále dôjde k CDESK ready against …: to dokazuje, že samotný CDESK MCP je v poriadku a problém je v súbore s nastaveniami aplikácie.

Ak problém pretrvávaSpustite znova uv run cdesk-mcp a skopírujte celý výstup – obsahuje skutočný dôvod. CDESK MCP nikdy nezapisuje vaše heslo do logu, takže výstup je bezpečné zdieľať, ale aj tak si ho najprv prezrite.

Aktualizácia CDESK MCP

Inštalovali ste cez Git? Dva príkazy v priečinku CDESK MCP:

git pull
uv sync

Inštalovali ste zo ZIP-u? Nie je čo stiahnuť cez git pull, takže súbory vymeníte sami:

1. Stiahnite a rozbaľte nový ZIP rovnako ako predtým.
2. Skopírujte svoj .env zo starého priečinka do nového.
3. V novom priečinku spustite uv sync.
4. Ak sa cesta k novému priečinku líši od starej, upravte ju v nastaveniach svojej AI aplikácie (Pripojenie AI aplikácie). Ak ZIP rozbalíte inde a priečinky potom vymeníte, cesta zostane rovnaká a tento krok odpadá.
5. Keď nový priečinok funguje, ten starý zmažte.

Tak či onak potom reštartujte svoju AI aplikáciu. Aktualizácia sa vášho .env nikdy nedotkne – pri Gite jednoducho zostane na mieste a pri ZIP-e si ho prenesiete sami.