Kasutaja tarvikud

Lehe tööriistad



et:ask_directo

Erinevused

Siin näed erinevusi valitud versiooni ja hetkel kehtiva lehekülje vahel.

Lõlita võrdlemise vaatele

Both sides previous revisionPrevious revision
Next revision
Previous revision
et:ask_directo [2026/10/01 12:17] – [Directo MCP serveri seadistamine - Claude Desktop ja Gemini CLI] andruset:ask_directo [2026/11/12 15:56] (Hetkel kehtiv) – toomas
Rida 1: Rida 1:
 ====== AI-lahendus Ask Directo: küsi ja tehisaru annab Sulle Directo andmete põhjal vastused ====== ====== AI-lahendus Ask Directo: küsi ja tehisaru annab Sulle Directo andmete põhjal vastused ======
 +
 +Ask Directo lahendus põhineb MCP (Model Context Protocol) serveril, mis lihtsalt öeldes on väike tehniline lokaalne abiprogramm Sinu arvutis. Lisades MCP oma arvutisse, lubab see AI-assistendil (Claude, Gemini) turvaliselt lugeda andmeid otse Sinu Directost. Sinul tuleb vaid lihtsas keeles küsimusi esitada.
 +
 +Loe Ask Directo võimaluste kohta lähemalt: [[https://directo.ee/ask-directo]].
  
 ===== Directo MCP serveri seadistamine - Claude Desktop ja Gemini CLI ===== ===== Directo MCP serveri seadistamine - Claude Desktop ja Gemini CLI =====
  
-See juhend selgitab kuidas ühendada Directo ERP süsteem AI assistendiga (Claude või Gemini) läbi MCP (Model Context Protocol) lokaalse serveri. Juhend on mõeldud nii Claude Desktop kui Gemini CLI kasutajatele - ühised sammud pead tegema üks kord ja seejärel vali oma AI kliendile vastav sektsioon.+See juhend selgitab, kuidas ühendada Directo ERP süsteem AI assistendiga (Claude või Gemini) läbi MCP (Model Context Protocol) lokaalse serveri. Juhend on mõeldud nii Claude Desktop kui Gemini CLI kasutajatele - ühised sammud pead tegema üks kord ja seejärel vali oma AI kliendile vastav sektsioon.
  
 ===== 1. Sissejuhatus - miks MCP? ===== ===== 1. Sissejuhatus - miks MCP? =====
Rida 42: Rida 46:
 </code> </code>
  
-MCP server jookseb **sinu arvutis** - Directo andmed ei liigu läbi AI pilveteenuse serveri.+MCP server jookseb **sinu arvutis** ja Directo API võti ei lahku sinu arvutist. Directost päritud andmed liiguvad aga edasi AI teenusepakkuja pilve, et mudel saaks need lugeda ja vastuse koostada - täpselt nagu iga muu vestluse sisu.
  
 <note important> <note important>
-**Lokaalne paigaldus - oluline mõista:**\+**Lokaalne paigaldus - oluline mõista:**
   * MCP server paigaldatakse **ainult sinu isiklikku arvutisse**   * MCP server paigaldatakse **ainult sinu isiklikku arvutisse**
   * See **ei ole jagatud** - teised kolleegid ei pääse sinu MCP serverile ligi   * See **ei ole jagatud** - teised kolleegid ei pääse sinu MCP serverile ligi
Rida 51: Rida 55:
   * MCP server töötab ainult siis, kui **sinu arvuti on sisse lülitatud** ja AI klient on käivitatud   * MCP server töötab ainult siis, kui **sinu arvuti on sisse lülitatud** ja AI klient on käivitatud
   * Kui soovid MCP serverit jagada mitme kasutajaga, on vaja eraldi avaliku serveri lahendust (ei kuulu selle juhendi skoopi)   * Kui soovid MCP serverit jagada mitme kasutajaga, on vaja eraldi avaliku serveri lahendust (ei kuulu selle juhendi skoopi)
 +  * Üks API võti kuulub **ühele Directo andmebaasile**. See MCP server on seotud täpselt selle andmebaasiga, kuhu võti on loodud, ega saa pärida mõne teise andmebaasi andmeid (nt toodangu- ja testbaasi vahel). AI ise ei tea, millise andmebaasiga server on ühendatud: kui ta väidab, et pärib teise baasi andmeid, ei vasta see tõele. Directo aadressireal on andmebaasi nimi (''login.directo.ee/BAAS/...''): veendu, et API võti on loodud õiges andmebaasis.
 </note> </note>
  
Rida 80: Rida 85:
  
 <note important> <note important>
-⚠️ **Gemini CLI tasuta tier on endiselt olemas, aga muutunud.** Autentimisviisist sõltuvalt:\ +⚠️ **Gemini CLI ei teeni enam tasuta Google'i kontoga kasutajaid.** 18. juunil 2026 lõpetas Gemini CLI Google AI Pro ja Ultra tellijate ning tasuta (Gemini Code Assist üksikkasutaja) kasutajate teenindamise, ja need kasutajad on viidud Antigravity CLI-sse. Gemini CLI jääb kasutatavaks: 
-  * **Google kontoga (Gemini Code Assist üksikkasutajale):** ~60 päringut/min ja ~1000 päringut/päevas\ +  * **tasulise Gemini API võtmega** 
-  * **Tasuta Gemini API võtmega (unpaid):** kitsam — ~10 päringut/min, ~250 päringut/päevas, ainult Flash-mudelid\ +  * **Gemini Code Assist Standard / Enterprise litsentsiga** 
-\ + 
-18. juunil 2026 asendatakse unpaid tieri ja Google One kasutajate jaoks Gemini CLI **Antigravity CLI-ga** — see puudutab konkreetset autentimisteed, mitte tasuta juurdepääsu tervikuna. Suurema mahu või Pro-mudelite jaoks on vaja Google AI Pro/Ultra tellimust või Gemini Code Assist litsentsi. Kontrolli oma projekti tegelikke limiite AI Studios, sest need muutuvad sageli ja sõltuvad regioonist ja konto seisust.+Tasuta (unpaid) Gemini API võtme piir on Google'i kvoodilehe järgi 250 päringut päevas ja ainult Flash-mudelid. Google'i enda teated on selle tee kohta aga vastuolulised (kvoodileht loetleb selle, kuid bänner ütleb, et "unpaid tier" kasutajad on viidud Antigravity CLI-sse), seega kontrolli enne kasutuselevõttu, et sinu võti Gemini CLI-ga töötab. Antigravity CLI MCP seadistust see juhend ei kata.
 </note> </note>
  
Rida 174: Rida 179:
 <note> <note>
 Failid on wikisse lisatud **ZIP-arhiivina**, mitte eraldi linkidena — DokuWiki blokeerib vaikimisi ''.js'' ja ''.ps1'' failide üleslaadimise (turvakaalutlusel, vt ''conf/mime.conf''), aga ''.zip'' on vaikimisi lubatud. Ära nimeta faile ümber teiseks laiendiks (nt ''.txt'') "lahenduseks" — vale laiend põhjustab hiljem ''MODULE_NOT_FOUND'' tüüpi vigu. Failid on wikisse lisatud **ZIP-arhiivina**, mitte eraldi linkidena — DokuWiki blokeerib vaikimisi ''.js'' ja ''.ps1'' failide üleslaadimise (turvakaalutlusel, vt ''conf/mime.conf''), aga ''.zip'' on vaikimisi lubatud. Ära nimeta faile ümber teiseks laiendiks (nt ''.txt'') "lahenduseks" — vale laiend põhjustab hiljem ''MODULE_NOT_FOUND'' tüüpi vigu.
 +</note>
 +
 +<note>
 +Skriptid kuvavad kõik teated **inglise keeles**: ''[OK]'' = õnnestus, ''[!]'' = vajab sinu tähelepanu, ''[ERROR]'' = viga.
 +</note>
 +
 +<note important>
 +Skriptid täienevad aeg-ajalt. Kui su arvutis on ZIP juba varem alla laaditud (nt kaustas Downloads seisab vanem koopia), **laadi alati värske versioon uuesti alla**. Skripti käivitamisel näitab esimene rida versiooninumbrit (nt ''v1.5''). Kui versiooninumbrit ei näe, on tegu vana koopiaga.
 </note> </note>
  
Rida 209: Rida 222:
 **Samm A2 — käivitamine** **Samm A2 — käivitamine**
  
-Samas PowerShelli aknas (mitte administraatorina), juba lahtipakitud kaustas: +Samas PowerShelli aknas (mitte administraatorina), juba lahtipakitud kaustas: \\ 
-A2.1  API võti (ühine mõlemale, tee see esimesena)+A2.1 API võti (ühine mõlemale, tee see esimesena) 
 <code powershell> <code powershell>
 .\set-directo-apikey.ps1 .\set-directo-apikey.ps1
Rida 217: Rida 231:
 A2.2 Vali oma AI klient (või mõlemad): \\ A2.2 Vali oma AI klient (või mõlemad): \\
 Claude Claude
 +
 <code powershell> <code powershell>
 .\install-claude-mcp.ps1 .\install-claude-mcp.ps1
Rida 222: Rida 237:
  
 Gemini Gemini
 +
 <code powershell> <code powershell>
 .\install-gemini-mcp.ps1 .\install-gemini-mcp.ps1
 </code> </code>
  
-Iga skript näitab lõpus kokkuvõtte — mis on tehtud (✅) ja mis vajab veel käsitsi tegevust (❗).+Iga skript näitab lõpus kokkuvõtte: ''[OK]'' = tehtud, ''[!]'' = vajab veel sinu tegevust (nt taaskäivita Claude Desktop täielikult), ''[ERROR]'' = viga, mille tekst ütleb, mida teha.
  
 <note important> <note important>
Rida 297: Rida 313:
  
 <note important> <note important>
-See fail sisaldab kõiki 32 Directo API tööriista ja on **täielikult skeemipõhiselt kontrollitud** — iga parameeter on üle vaadatud vastu Directo API tegelikke ws_*.json skeeme. Ära kopeeri seda faili käsitsi Notepadist ega mõnest muust allikast — kasuta alati värsket, ametlikku versiooni, et vältida vananenud/valede parameetritega koopiaid.+See fail sisaldab kõiki 41 tööriista (40 Directo API liidest ja liideste ülevaate tööriist get_api_access) ja iga tööriista parameetrid on kontrollitud vastu Directo API tegelikke spetsifikatsioone. Ära kopeeri seda faili käsitsi Notepadist ega mõnest muust allikast — kasuta alati värsket, ametlikku versiooni, et vältida vananenud/valede parameetritega koopiaid.
 </note> </note>
  
Rida 395: Rida 411:
 Tee A skript (''set-directo-apikey.ps1'') teeb sama asja turvalisemalt (küsib võtme varjatult, ei kuva ekraanil) ja sobib ka rotatsiooniks — kasuta seda, kui saad. Tee A skript (''set-directo-apikey.ps1'') teeb sama asja turvalisemalt (küsib võtme varjatult, ei kuva ekraanil) ja sobib ka rotatsiooniks — kasuta seda, kui saad.
 </note> </note>
 +
 ===== 4. Claude Desktop seadistamine ===== ===== 4. Claude Desktop seadistamine =====
  
Rida 411: Rida 428:
 ==== Samm 4.1 — Konfiguratsioonifaili asukoht ==== ==== Samm 4.1 — Konfiguratsioonifaili asukoht ====
  
-Claude Desktopil on Windowsis **kaks võimalikku** konfiguratsiooni asukohta, sõltuvalt installimisviisist:+Claude Desktopi konfiguratsioonifail ''claude_desktop_config.json'' asub Windowsis **sõltuvalt versioonist ja installimisviisist** ühes neljast kohast. Tee A skript leiab õige faili ise. Käsitsi (Tee B) leia see allolevate sammudega.
  
-^ Installimisviis ^ Asukoht ^ +^ Variant ^ Asukoht ^ 
-| Otsene ''.exe'' installer (tavaline) | ''%APPDATA%\Claude\'' | +| MSIX (claude.ai/download), andmed kolitud (Claude Desktop 3.1623 ja uuem) | ''%LOCALAPPDATA%\Claude-Data\claude_pzs8sxrjxfjjc\'' | 
-| Microsoft Store / MSIX | ''%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\'' |+| Sama MSIX enne andmete kolimist | ''%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\'' | 
 +| Microsoft Store build (kinnitamata) | ''%LOCALAPPDATA%\Claude-Data\anthropicpbc.claude_fnn82j28hfe8t\'' | 
 +| Vana ''.exe'' installer | ''%APPDATA%\Claude\'' |
  
 <note important> <note important>
-See on dokumenteeritud, aktiivne Claude Desktopi tõrge: MSIX-installi puhul Windows **virtualiseerib** ''%APPDATA%\Claude\'' asukoha läbipaistmatult teisele teele. Kui muudad vale (standard) faili, ei jõua muudatus kunagi rakenduseni ja MCP server jääb vaikselt laadimata, ilma selgitava veata.+Uuemas Claude Desktopis on andmed kolitud vanast paketikaustast kausta ''Claude-Data''. Vanasse kausta jääb ainult marker ''.user-data-left...'' (mõnel masinal ka mahajäänud ''claude_desktop_config.json''). **Faili, mida Claude enam ei loe, saab muuta ilma veateateta, aga muudatus ei jõua rakenduseni** ja MCP server jääb vaikselt laadimata. Kasuta alati uut kausta, kui see on olemas.
 </note> </note>
  
-Kontrolli, kumb sinu masinas kehtib — ava File Explorer ja proovi mõlemat aadressiribale:+Näita, millised neist failidest sinu masinas olemas on (tavaline PowerShell):
  
-<code> +<code powershell> 
-%APPDATA%\Claude+"$env:LOCALAPPDATA\Claude-Data\claude_pzs8sxrjxfjjc\claude_desktop_config.json", 
 +"$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json", 
 +"$env:LOCALAPPDATA\Claude-Data\anthropicpbc.claude_fnn82j28hfe8t\claude_desktop_config.json", 
 +"$env:APPDATA\Claude\claude_desktop_config.json" | Where-Object { Test-Path $_ }
 </code> </code>
  
-Kui seal on olemas ''claude_desktop_config.json'' fail (või Claude Desktop on seal midagi juba loonud), kasuta seda teed. Kui mitte, proovi:+Kasuta nimekirja **esimest** faili (järjekord on sama mis tabelis: uuem enne vanemat). Erandid:
  
-<code> +  * Kui nimekirjas on ''Packages\...'' fail ja samas kaustas on ka fail ''.user-data-left...'', on see fail aegunud — ära kasuta seda. 
-%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude +  * Kui kaust ''%LOCALAPPDATA%\Claude-Data\claude_pzs8sxrjxfjjc'' on olemas, aga seal ei ole ''claude_desktop_config.json'' faili: ava Claude Desktop → Settings → Developer → Edit Config (see loob faili) ja korda käsku. 
-</code> +  * Kui nimekiri on tühi: käivita Claude Desktop vähemalt korra ja korda käsku.
- +
-<note> +
-Kui kumbki kaust ei eksisteeri, käivita Claude Desktop vähemalt korra — see loob vajalikud kaustad automaatselt (tavaliselt standardteele). +
-</note>+
  
 ==== Samm 4.2 — Konfiguratsioonifail ==== ==== Samm 4.2 — Konfiguratsioonifail ====
Rida 471: Rida 489:
  
 <note> <note>
-Kui fail juba sisaldab muud sisu (Claude Desktopi enda seaded, nt ''preferences'' plokk) — **ära kirjuta seda üle**. ''mcpServers'' peab olema faili **juuretasemel**, samal tasemel nagu ''preferences'', mitte selle sees. Kui pole kindel sulgude õigest asukohast, kasuta pigem Sammu 3.0 skripti, mis muudab faili struktuurina (''ConvertFrom-Json''/''ConvertTo-Json''), mitte käsitsi tekstina — see välistab sulgude-vea täielikult.+Kui fail juba sisaldab muud sisu (Claude Desktopi enda seaded, nt ''preferences'' plokk) — **ära kirjuta seda üle**. ''mcpServers'' peab olema faili **juuretasemel**, samal tasemel nagu ''preferences'', mitte selle sees. Kui pole kindel sulgude õigest asukohast, kasuta pigem Tee A skripti (Peatükk 3), mis muudab faili struktuurina (''ConvertFrom-Json''/''ConvertTo-Json''), mitte käsitsi tekstina — see välistab sulgude-vea täielikult.
 </note> </note>
  
Rida 487: Rida 505:
 ==== Samm 4.4 — Testimine ==== ==== Samm 4.4 — Testimine ====
  
-Kirjuta Claude Desktop vestluses:+Kirjuta Claude Desktop vestluses esmalt:
  
-> Anna mulle kõik laoseisud+> Millised Directo liidesed on minu API võtmel lubatud?
  
-Claude peaks automaatselt kasutama ''get_stocklevels'' tööriista ja tagastama Directo andmed.+Claude kasutab tööriista ''get_api_access'' ja kuvab liideste nimekirja. See päring ei anna Directo ärandmeid, seega on see kõige turvalisem esimene test. Seejärel proovi andmepäringut, näiteks: 
 + 
 +> Millised laod mul Directos on? 
 + 
 +Claude kasutab sobivat tööriista (siin ''get_stocks'') ja tagastab Directo andmed. Vastuse kohal näed halli silti "Used directo integration". Kui liides ei ole sinu võtmel lubatud, ütleb Claude, millise liidese tuleb Directos aktiveerida. 
 + 
 +<note important> 
 +**Esimesel kasutamisel küsib Claude Desktop luba.** Iga uue tööriista esmakordsel kasutamisel ilmub Claude Desktopi aknasse kinnitusküsimus (nt Allow once / Allow always). Vali ''Allow always'', kui usaldad tööriista. Kui vastust ei tule ja mitme minuti pärast ilmub teade "No result received", vaata, kas kinnitusaken on kuskil avatud. 
 +</note> 
 + 
 +Veendu, et vastus on **sinu andmebaasi** andmed: küsi midagi, mida sa oma Directo-st tead (nt tuntud klient või ladu), ja võrdle.
  
 **Logide kontroll kui midagi ei tööta:** **Logide kontroll kui midagi ei tööta:**
  
-Logi asukoht järgib sama kahte võimalust, mis Sammus 4.1:+Praegustes Claude Desktopi versioonides on logid kaustas ''%LOCALAPPDATA%\Claude\logs'':
  
 <code powershell> <code powershell>
-# Otsene .exe installer: +# Praegused Claude Desktopi versioonid: 
-Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" -Tail 30+Get-Content "$env:LOCALAPPDATA\Claude\logs\mcp-server-directo.log" -Tail 30
  
-# Microsoft Store / MSIX: +# Vana .exe installer: 
-Get-Content "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\logs\mcp-server-directo.log" -Tail 30+Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" -Tail 30
 </code> </code>
  
-Ametlik Claude Desktop MCP dokumentatsioon: [[https://modelcontextprotocol.io/docs/develop/connect-local-servers|modelcontextprotocol.io — Connect to local MCP servers]]+Ametlik Claude Desktop MCP dokumentatsioon: [[https://modelcontextprotocol.io/docs/develop/connect-local-servers|modelcontextprotocol.io - Connect to local MCP servers]] 
 + 
 +<note> 
 +Ametlik MCP dokumentatsioon annab Windowsi puhul veel vanad teed (''%APPDATA%\Claude\...''). Selle juhendi Samm 4.1 kirjeldab Claude Desktopi praegust asukohta. 
 +</note>
  
 ===== 5. Gemini CLI seadistamine ===== ===== 5. Gemini CLI seadistamine =====
Rida 518: Rida 550:
  
 <note important> <note important>
-⚠️ Enne jätkamist veendu, et sul on kehtiv autentimine — kas Google konto (Gemini Code Assist), tasuta Gemini API võti (Flash-mudelid) või tasuline tellimus. Limiidid ja mudelivalik sõltuvad autentimisviisist (vt Samm 2.3).+⚠️ Enne jätkamist veendu, et sul on kehtiv autentimine: tasuline Gemini API võti, Gemini Code Assist Standard / Enterprise litsents või tasuta API võti, mis Gemini CLI-ga töötab. Tasuta Google'i kontoga Gemini CLI enam ei tööta (vt Samm 2.3).
 </note> </note>
  
Rida 672: Rida 704:
 Peaks kuvama: Peaks kuvama:
 <code> <code>
-🟢 directo - Ready (32 tools)+🟢 directo - Ready (41 tools)
 </code> </code>
  
 Testi päring: Testi päring:
  
-> Anna mulle kõik laoseisud+> Millised Directo liidesed on minu API võtmel lubatud?
  
 Ametlik Gemini CLI MCP dokumentatsioon: [[https://geminicli.com/docs/tools/mcp-server/|geminicli.com/docs/tools/mcp-server]] Ametlik Gemini CLI MCP dokumentatsioon: [[https://geminicli.com/docs/tools/mcp-server/|geminicli.com/docs/tools/mcp-server]]
Rida 686: Rida 718:
  
 ^ Veateade ^ Põhjus ^ Lahendus ^ ^ Veateade ^ Põhjus ^ Lahendus ^
-| ''DIRECTO_API_KEY puudub'' | Credential Manager salvestus ebaõnnestus | Korda Samm B7 (või Tee A: ''.\set-directo-apikey.ps1'') |+| ''DIRECTO_API_KEY is missing'' | Credential Manager salvestus ebaõnnestus või server töötab teise Windowsi kontoga | Korda Samm B7 (või Tee A: ''.\set-directo-apikey.ps1'') samas kontos, mille all Claude töötab | 
 +| ''Unable to convert Credential object...'' / ''null-valued expression'' | Võti salvestati ''cmdkey''-ga, mis pole alati ühilduv CredentialManager mooduli lugemisega | Kustuta ''Remove-StoredCredential -Target DIRECTO_API_KEY'' ja salvesta uuesti ''New-StoredCredential''-iga (Samm B7) või Tee A skriptiga |
 | ''Cannot find module'' | npm install ebaõnnestus VÕI directo-mcp.js on vales kaustas/nimega | Korda Samm B6; kontrolli ''Test-Path "$env:USERPROFILE\directo-mcp\directo-mcp.js"'' | | ''Cannot find module'' | npm install ebaõnnestus VÕI directo-mcp.js on vales kaustas/nimega | Korda Samm B6; kontrolli ''Test-Path "$env:USERPROFILE\directo-mcp\directo-mcp.js"'' |
 | ''SyntaxError'' | directo-mcp.js fail on vigane või poolik | Lae fail uuesti alla, vt Samm B4 (või Tee A: A1) | | ''SyntaxError'' | directo-mcp.js fail on vigane või poolik | Lae fail uuesti alla, vt Samm B4 (või Tee A: A1) |
-| ''Incorrect filter id'' | Vale API filtrinimi | Teadaolev piirang — kasuta ilma filtrita | +| ''The "..." interface is not enabled for this API key'' | See liides pole sinu API võtmel aktiveeritud | Lase Directo administraatoril liides võtmel aktiveerida (API Direct). Võtmel lubatud liideseid näed küsimusega "Millised Directo liidesed on minu API võtmel lubatud?" | 
-| ''401 / 403'' | Directo API võti on vale või aegunud | Kontrolli võtit Directo adminis |+| ''Filter "..." cannot be used ... not selected for output'' | See väli ei ole võtmel väljundiks valitud | Kasuta teist filtrit või lase väli võtmel väljundiks lisada | 
 +| ''Unknown filter name'' | Vale filtri nimi (nimed on tõstutundlikud) | Küsi lubatud filtrid: "Millised filtrid on liidesel ... lubatud?" | 
 +| ''Filter "..." has an invalid value syntax'' | Filtri väärtuse kuju on vale (kuupäev peab olema ISO 8601, nt 2026-01-01T00:00:00) | Claude parandab tavaliselt ise; vajadusel palu tal kasutada õiget kuju | 
 +| ''The API key is missing or invalid (401)'' | Directo API võti on vale, aegunud või kustutatud | Kontrolli võtit Directo adminis ja salvesta see uuesti (''.\set-directo-apikey.ps1'') | 
 +| ''Access denied: the IP address of this computer is not allowed'' | Võtmel on IP piirang ja sinu arvuti aadress pole lubatud | Lase Directo administraatoril IP lubada | 
 +| ''Rate limit exceeded (429)'' | Liiga palju päringuid | Oota hetk ja proovi uuesti (soovituslik piir kuni 60 päringut minutis) | 
 +| ''Directo reported a server error (5xx)'' | Directo poolne ajutine viga | Proovi hiljem uuesti; kui kordub, pöördu Directo klienditoe poole |
 | ''running scripts is disabled'' | PowerShell execution policy | ''Set-ExecutionPolicy RemoteSigned -Scope CurrentUser'' (Samm A1 või B1) | | ''running scripts is disabled'' | PowerShell execution policy | ''Set-ExecutionPolicy RemoteSigned -Scope CurrentUser'' (Samm A1 või B1) |
-| ''is not digitally signed'' / ''UnauthorizedAccess'' | Windowsi Mark-of-the-Web (fail alla laaditud brauseriga) | ''Get-ChildItem <kaust> -Recurse \| Unblock-File'' (vt Samm A1) |+| ''is not digitally signed'' / ''UnauthorizedAccess'' | Windowsi Mark-of-the-Web (fail alla laaditud brauseriga) | ''Get-ChildItem <kaust> -Recurse %%|%% Unblock-File'' (vt Samm A1) |
 | ''npm not recognized'' | Node.js pole PATH-is | Sulge ja ava PowerShell uuesti | | ''npm not recognized'' | Node.js pole PATH-is | Sulge ja ava PowerShell uuesti |
  
-==== Claude Desktop spetsiifilised vead ====+<note> 
 +Serveri veateated on inglise keeles. Claude selgitab need sulle sinu keeles. 
 +</note> 
 + 
  
 ^ Probleem ^ Lahendus ^ ^ Probleem ^ Lahendus ^
Rida 701: Rida 744:
 | MCP server ei käivitu | Kontrolli et config faili nimi pole ''.txt'' laiendiga | | MCP server ei käivitu | Kontrolli et config faili nimi pole ''.txt'' laiendiga |
 | Config kaust puudub | Käivita Claude Desktop korra — kaustad luuakse automaatselt | | Config kaust puudub | Käivita Claude Desktop korra — kaustad luuakse automaatselt |
-| Config muudetud, aga midagi ei muutu | Kontrolli, et muudad ÕIGET faili — vt Samm 4.1 (kaks võimalikku asukohta, MSIX vs otsene install) |+| Config muudetud, aga midagi ei muutu | Kontrolli, et muudad ÕIGET faili — vt Samm 4.1 (neli võimalikku asukohta; uues Claude Desktopis on fail kaustas ''Claude-Data'', vana paketikaust on tühi või aegunud) | 
 +| Päring ei anna vastust (mitme minuti pärast "No result received") | Claude Desktop ootab tööriista kasutamise kinnitust: vaata, kas Claude Desktopis on avatud kinnitusaken, ja vali Allow once / Allow always | 
 +| MCP kadus pärast Claude Desktopi uuendust | Claude kolis andmed uude kausta (Samm 4.1). Kontrolli, et uue kausta ''claude_desktop_config.json'' sisaldab ''directo-mcp.js'' rida (''Select-String -Path "<fail>" -Pattern "directo-mcp.js"''). Kui ei, käivita Tee A skript uuesti. |
  
-Logifail (proovi mõlemat, vt Samm 4.1):+Logifail (praegused Claude Desktopi versioonid, vana .exe installeri jaoks teine rida):
  
 <code powershell> <code powershell>
 +Get-Content "$env:LOCALAPPDATA\Claude\logs\mcp-server-directo.log" -Tail 30
 Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" -Tail 30 Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" -Tail 30
-Get-Content "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\logs\mcp-server-directo.log" -Tail 30 
 </code> </code>
  
Rida 715: Rida 760:
 | ''/mcp list'' näitab Disconnected | Lisa ''"trust": true'' serveri konfiguratsiooni (Samm 5.4) või usalda kaust dialoogis / käsuga ''/permissions'' | | ''/mcp list'' näitab Disconnected | Lisa ''"trust": true'' serveri konfiguratsiooni (Samm 5.4) või usalda kaust dialoogis / käsuga ''/permissions'' |
 | ''GEMINI_API_KEY'' viga | Korda Samm 5.2, ava uus PowerShell aken | | ''GEMINI_API_KEY'' viga | Korda Samm 5.2, ava uus PowerShell aken |
-| Rate limit / 429 viga | Tasuta tieri päringulimiit ületatud — oota limiidi lähtestumist või kaalu tasulist tellimust (vt Samm 2.3) |+| Rate limit / 429 viga | Tasuta API võtme päringulimiit ületatud — oota limiidi lähtestumist või kasuta tasulist API võtit (vt Samm 2.3) | 
 +| Gemini CLI ei võta Google'i kontoga sisse | Tasuta Google'i konto tugi lõppes 18. juunil 2026: kasuta tasulist Gemini API võtit või Gemini Code Assist litsentsi (vt Samm 2.3) |
  
 Gemini CLI diagnostika: Gemini CLI diagnostika:
Rida 725: Rida 771:
 ===== 7. MCP tööriistad ===== ===== 7. MCP tööriistad =====
  
-Mõlemad kliendid (Claude Desktop ja Gemini CLI) kasutavad samu tööriistu:+Mõlemad kliendid (Claude Desktop ja Gemini CLI) kasutavad samu 41 tööriista (40 Directo API liidest ja liideste ülevaate tööriist ''get_api_access''):
  
 ^ Grupp ^ Tööriistad ^ ^ Grupp ^ Tööriistad ^
 | Müük | get_invoices, get_orders, get_sales_quotations, get_sales_contracts, get_receipts | | Müük | get_invoices, get_orders, get_sales_quotations, get_sales_contracts, get_receipts |
 | Kliendid | get_customers, get_suppliers, get_contacts | | Kliendid | get_customers, get_suppliers, get_contacts |
-| Tooted / ladu | get_items, get_itemclasses, get_stocklevels, get_stocklevels_sn, get_allocations, get_priceformulas |+| Tooted / ladu | get_items, get_itemclasses, get_stocklevels_sn, get_stocklevels, get_allocations, get_priceformulas, get_stocks |
 | Ost | get_purchase_orders, get_purchase_invoices, get_purchase_payments, get_stock_receipts | | Ost | get_purchase_orders, get_purchase_invoices, get_purchase_payments, get_stock_receipts |
 | Raamatupidamine | get_transactions, get_accounts, get_financial_budgets, get_nettings | | Raamatupidamine | get_transactions, get_accounts, get_financial_budgets, get_nettings |
 | Logistika | get_deliveries, get_movements | | Logistika | get_deliveries, get_movements |
-| Muu | get_projects, get_objects, get_resources, get_events, get_users, get_recipes, get_replacementlogs |+| Personal | get_users, get_absences, get_wage_calculations, get_expenses, get_approvals | 
 +| Varad | get_assets, get_customer_assets | 
 +| Muu | get_projects, get_objects, get_resources, get_events, get_recipes, get_replacementlogs, get_usagelogs |
 | Sünkroonimine | get_deleted | | Sünkroonimine | get_deleted |
 +| Ligipääsu ülevaade | get_api_access |
 +
 +==== Mida tasub teada ====
 +
 +  * **Tööriist töötab ainult siis, kui liides on sinu API võtmel aktiveeritud.** Directo administraator valib võtmel, millised liidesed ja millised väljad on lubatud. Kui liides puudub, ütleb veateade, millise liidese tuleb Directos aktiveerida.
 +  * **Ligipääsu ülevaade:** küsi "Millised Directo liidesed on minu API võtmel lubatud?". Tulemus salvestatakse 1 päevaks (fail ''discovery-cache.json'' kaustas ''directo-mcp''). Kui muudad Directos võtme seadistust, ütle Claude'ile "Uuenda Directo ligipääsu info" (või kustuta see fail ja taaskäivita Claude Desktop). Directo ülevaade võib mõne lubatud liidese välja jätta (nt ''stocklevels''), seega proovi tööriista: päris veateade ütleb, kas ligipääs puudub.
 +  * **Laoseis:** eelista tööriista ''get_stocklevels_sn''. Kui see liides ei ole võtmel lubatud, kasuta ''get_stocklevels''.
 +  * **Filtrid:** igal andmetööriistal on tavalised filtrid (nt kuupäev, klient, staatus) ja lisaks vaba filter, millega saab kasutada mis tahes võtmel lubatud välja (ka realavälju). Filtreerida saab ainult välju, mis on võtmel väljundiks valitud.
 +  * **Tulemuse maht:** iga vastuse algus näitab vastete arvu ja mahtu. Kui see on "LARGE" või "TOO LARGE", kitsenda päringut (soovituslikult kuni 1 kuu korraga). Väga suur vastus ei pruugi AI mällu mahtuda ja kogusummad võivad jääda poolikuks.
 +  * **Tundlikud andmed:** personali-, palga-, kulu- ja kasutuslogi tööriistad (''get_wage_calculations'', ''get_absences'', ''get_expenses'', ''get_approvals'', ''get_usagelogs'') töötavad, kui sinu võtmel on vastavad liidesed aktiveeritud. Võtme omanik otsustab ja vastutab, kas need AI-le avada.
  
 ===== 8. Turvalisus ===== ===== 8. Turvalisus =====
Rida 743: Rida 801:
 | Keskkonnamuutuja (Gemini varuvõimalus) | Kui Credential Manager on seadistatud, pole ''env'' plokk rangelt vajalik — vt Sammu 5.4 täpsustust | | Keskkonnamuutuja (Gemini varuvõimalus) | Kui Credential Manager on seadistatud, pole ''env'' plokk rangelt vajalik — vt Sammu 5.4 täpsustust |
 | Lokaalne server | MCP server töötab ainult sinu arvutis, ei ole avalikult ligipääsetav | | Lokaalne server | MCP server töötab ainult sinu arvutis, ei ole avalikult ligipääsetav |
-| Minimaalsed õigused | Piirita Directo API võtme õigused — ainult vajalikud ressursid |+| Andmed AI teenusepakkujale | Päringute tulemused saadetakse AI teenusepakkuja pilve, et mudel saaks neile vastata. API võti sinu arvutist ei lahku. | 
 +| Minimaalsed õigused | Piirita Directo API võtme õigused — ainult vajalikud liidesed ja väljad (sh personali- ja palgaandmed) | 
 +| Ligipääsu ülevaate vahemälu | Fail ''discovery-cache.json'' (kaustas ''directo-mcp'') sisaldab ainult liideste ja väljade nimesid, mitte andmeid, ja on seotud sinu võtmega |
 | OneDrive/Dropbox | Välista ''directo-mcp'' kaust pilvesünkroonist | | OneDrive/Dropbox | Välista ''directo-mcp'' kaust pilvesünkroonist |
 | Admin õigused | Ainult Node.js installimisel (Samm 3.1) — jagatud eelsamm mõlemale teele — kõik muu, sh CredentialManager moodul, töötab ''-Scope CurrentUser'' all ilma admin-õigusteta (vt 2.4) | | Admin õigused | Ainult Node.js installimisel (Samm 3.1) — jagatud eelsamm mõlemale teele — kõik muu, sh CredentialManager moodul, töötab ''-Scope CurrentUser'' all ilma admin-õigusteta (vt 2.4) |
  
-===== 9. Viited =====+===== 9. Uuendamine ja versioon ===== 
 + 
 +==== Millist versiooni ma kasutan? ==== 
 + 
 +MCP serveri versioon on serveri käivitusrea logis (''Directo MCP server v... started (N tools)''): 
 + 
 +<code powershell> 
 +Select-String -Path "$env:LOCALAPPDATA\Claude\logs\mcp-server-directo.log" -Pattern "Directo MCP server v" | Select-Object -Last 1 
 +</code> 
 + 
 +Skriptide versioon on nähtav nende esimesel real käivitamisel (nt ''v1.5''). 
 + 
 +==== Kuidas uuendada ==== 
 + 
 +  - Laadi alla **värske** ZIP (vt Samm A1), paki lahti ja ava PowerShell lahtipakitud kaustas. 
 +  - Kopeeri uus ''directo-mcp.js'' vana asemele (käsk allpool). 
 +  - Sulge Claude Desktop **täielikult** (Samm 4.3) või Gemini CLI ja ava uuesti. 
 +  - Kontrolli logist versiooni (vt eespool). 
 + 
 +Kopeerimiskäsk: 
 + 
 +<code powershell> 
 +Copy-Item .\directo-mcp.js "$env:USERPROFILE\directo-mcp\directo-mcp.js" -Force 
 +</code> 
 + 
 +<note> 
 +Uus ''directo-mcp.js'' ei vaja uusi sõltuvusi, ''npm install'' ei ole vaja. Paigaldusskriptide uuesti käivitamine serveri faili **ei uuenda**: skript kopeerib ''directo-mcp.js'' ainult siis, kui seda kaustas veel ei ole. 
 +</note> 
 + 
 +===== 10. Viited =====
  
 **Claude Desktop:** **Claude Desktop:**
Rida 753: Rida 842:
   * [[https://modelcontextprotocol.io/docs/develop/connect-local-servers|Claude Desktop MCP seadistamine]]   * [[https://modelcontextprotocol.io/docs/develop/connect-local-servers|Claude Desktop MCP seadistamine]]
   * [[https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop|Claude Desktop lokaalsete MCP serverite juhend]]   * [[https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop|Claude Desktop lokaalsete MCP serverite juhend]]
 +  * [[https://downloads.claude.ai/releases/enterprise/intune/Claude-Intune-README.md|Claude Desktopi andmekaustad Windowsis (Anthropic)]]
   * [[https://modelcontextprotocol.io|MCP ametlik dokumentatsioon]]   * [[https://modelcontextprotocol.io|MCP ametlik dokumentatsioon]]
  
Rida 758: Rida 848:
   * [[https://geminicli.com/docs|Gemini CLI dokumentatsioon]]   * [[https://geminicli.com/docs|Gemini CLI dokumentatsioon]]
   * [[https://geminicli.com/docs/tools/mcp-server/|Gemini CLI MCP seadistamine]]   * [[https://geminicli.com/docs/tools/mcp-server/|Gemini CLI MCP seadistamine]]
 +  * [[https://geminicli.com/docs/resources/quota-and-pricing/|Gemini CLI kvoodid ja hinnad]]
 +  * [[https://github.com/google-gemini/gemini-cli/discussions/28017|Gemini CLI üleminek Antigravity CLI-le (teade)]]
   * [[https://aistudio.google.com/apikey|Google AI Studio API võtmed]]   * [[https://aistudio.google.com/apikey|Google AI Studio API võtmed]]
   * [[https://developers.google.com/gemini-code-assist/docs/gemini-cli|Gemini Code Assist dokumentatsioon]]   * [[https://developers.google.com/gemini-code-assist/docs/gemini-cli|Gemini Code Assist dokumentatsioon]]
Rida 769: Rida 861:
  
 **Kiirpaigalduse skriptid** (vt Tee A, Peatükk 3): **Kiirpaigalduse skriptid** (vt Tee A, Peatükk 3):
-  * ''directo-mcp.js'' — MCP server (32 tööriista, skeemipõhiselt kontrollitud)+  * ''directo-mcp.js'' — MCP server (41 tööriista)
   * ''set-directo-apikey.ps1'' — API võtme haldus (algseadistus + rotatsioon)   * ''set-directo-apikey.ps1'' — API võtme haldus (algseadistus + rotatsioon)
   * ''install-claude-mcp.ps1'' — Claude Desktopi automaatpaigaldus   * ''install-claude-mcp.ps1'' — Claude Desktopi automaatpaigaldus
   * ''install-gemini-mcp.ps1'' — Gemini CLI automaatpaigaldus   * ''install-gemini-mcp.ps1'' — Gemini CLI automaatpaigaldus
et/ask_directo.1790846237.txt.gz · Viimati muutnud: 2026/10/01 12:17 persoon andrus

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki