et:ask_directo
Erinevused
Siin näed erinevusi valitud versiooni ja hetkel kehtiva lehekülje vahel.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| et:ask_directo [2026/10/01 12:19] – [AI-lahendus Ask Directo: küsi ja tehisaru annab Sulle Directo andmete põhjal vastused] andrus | et:ask_directo [2026/11/12 15:56] (Hetkel kehtiv) – toomas | ||
|---|---|---|---|
| Rida 4: | Rida 4: | ||
| Loe Ask Directo võimaluste kohta lähemalt: [[https:// | Loe Ask Directo võimaluste kohta lähemalt: [[https:// | ||
| + | |||
| ===== 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 45: | Rida 46: | ||
| </ | </ | ||
| - | MCP server jookseb **sinu arvutis** | + | MCP server jookseb **sinu arvutis** |
| <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 54: | 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, | ||
| </ | </ | ||
| Rida 83: | Rida 85: | ||
| <note important> | <note important> | ||
| - | ⚠️ **Gemini CLI tasuta | + | ⚠️ **Gemini CLI ei teeni enam tasuta |
| - | * **Google | + | * **tasulise |
| - | * **Tasuta | + | * **Gemini Code Assist Standard |
| - | \ | + | |
| - | 18. juunil 2026 asendatakse unpaid tieri ja Google | + | Tasuta (unpaid) Gemini API võtme piir on Google' |
| </ | </ | ||
| Rida 177: | Rida 179: | ||
| < | < | ||
| Failid on wikisse lisatud **ZIP-arhiivina**, | Failid on wikisse lisatud **ZIP-arhiivina**, | ||
| + | </ | ||
| + | |||
| + | < | ||
| + | Skriptid kuvavad kõik teated **inglise keeles**: '' | ||
| + | </ | ||
| + | |||
| + | <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 '' | ||
| </ | </ | ||
| Rida 212: | Rida 222: | ||
| **Samm A2 — käivitamine** | **Samm A2 — käivitamine** | ||
| - | Samas PowerShelli aknas (mitte administraatorina), | + | Samas PowerShelli aknas (mitte administraatorina), |
| - | 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 220: | 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 225: | Rida 237: | ||
| Gemini | Gemini | ||
| + | |||
| <code powershell> | <code powershell> | ||
| .\install-gemini-mcp.ps1 | .\install-gemini-mcp.ps1 | ||
| </ | </ | ||
| - | Iga skript näitab lõpus kokkuvõtte | + | Iga skript näitab lõpus kokkuvõtte: '' |
| <note important> | <note important> | ||
| Rida 300: | Rida 313: | ||
| <note important> | <note important> | ||
| - | See fail sisaldab kõiki | + | See fail sisaldab kõiki |
| </ | </ | ||
| Rida 398: | Rida 411: | ||
| Tee A skript ('' | Tee A skript ('' | ||
| </ | </ | ||
| + | |||
| ===== 4. Claude Desktop seadistamine ===== | ===== 4. Claude Desktop seadistamine ===== | ||
| Rida 414: | Rida 428: | ||
| ==== Samm 4.1 — Konfiguratsioonifaili asukoht ==== | ==== Samm 4.1 — Konfiguratsioonifaili asukoht ==== | ||
| - | Claude | + | Claude |
| - | ^ Installimisviis | + | ^ Variant |
| - | | Otsene '' | + | | MSIX (claude.ai/ |
| - | | Microsoft Store / MSIX | '' | + | | Sama MSIX enne andmete kolimist |
| + | | Microsoft Store build (kinnitamata) | '' | ||
| + | | Vana '' | ||
| <note important> | <note important> | ||
| - | See on dokumenteeritud, | + | Uuemas Claude Desktopis |
| </ | </ | ||
| - | Kontrolli, kumb sinu masinas | + | Näita, millised neist failidest |
| - | < | + | < |
| - | %APPDATA%\Claude | + | " |
| + | " | ||
| + | " | ||
| + | "$env:APPDATA\Claude\claude_desktop_config.json" | ||
| </ | </ | ||
| - | Kui seal on olemas '' | + | Kasuta nimekirja **esimest** faili (järjekord |
| - | < | + | * Kui nimekirjas on '' |
| - | %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude | + | * Kui kaust '' |
| - | </ | + | |
| - | + | ||
| - | < | + | |
| - | Kui kumbki kaust ei eksisteeri, | + | |
| - | </ | + | |
| ==== Samm 4.2 — Konfiguratsioonifail ==== | ==== Samm 4.2 — Konfiguratsioonifail ==== | ||
| Rida 474: | Rida 489: | ||
| < | < | ||
| - | Kui fail juba sisaldab muud sisu (Claude Desktopi enda seaded, nt '' | + | Kui fail juba sisaldab muud sisu (Claude Desktopi enda seaded, nt '' |
| </ | </ | ||
| Rida 490: | Rida 505: | ||
| ==== Samm 4.4 — Testimine ==== | ==== Samm 4.4 — Testimine ==== | ||
| - | Kirjuta Claude Desktop vestluses: | + | Kirjuta Claude Desktop vestluses |
| - | > Anna mulle kõik laoseisud | + | > Millised Directo liidesed on minu API võtmel lubatud? |
| - | Claude | + | Claude |
| + | |||
| + | > Millised laod mul Directos on? | ||
| + | |||
| + | Claude kasutab sobivat | ||
| + | |||
| + | <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 '' | ||
| + | </ | ||
| + | |||
| + | 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 '' |
| <code powershell> | <code powershell> | ||
| - | # Otsene .exe installer: | + | # Praegused Claude Desktopi versioonid: |
| - | Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" | + | Get-Content "$env:LOCALAPPDATA\Claude\logs\mcp-server-directo.log" |
| - | # Microsoft Store / MSIX: | + | # Vana .exe installer: |
| - | Get-Content "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\logs\mcp-server-directo.log" | + | Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" |
| </ | </ | ||
| - | Ametlik Claude Desktop MCP dokumentatsioon: | + | Ametlik Claude Desktop MCP dokumentatsioon: |
| + | |||
| + | < | ||
| + | Ametlik MCP dokumentatsioon annab Windowsi puhul veel vanad teed ('' | ||
| + | </ | ||
| ===== 5. Gemini CLI seadistamine ===== | ===== 5. Gemini CLI seadistamine ===== | ||
| Rida 521: | Rida 550: | ||
| <note important> | <note important> | ||
| - | ⚠️ Enne jätkamist veendu, et sul on kehtiv autentimine | + | ⚠️ Enne jätkamist veendu, et sul on kehtiv autentimine: tasuline Gemini API võti, |
| </ | </ | ||
| Rida 675: | Rida 704: | ||
| Peaks kuvama: | Peaks kuvama: | ||
| < | < | ||
| - | 🟢 directo - Ready (32 tools) | + | 🟢 directo - Ready (41 tools) |
| </ | </ | ||
| 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: | Ametlik Gemini CLI MCP dokumentatsioon: | ||
| Rida 689: | Rida 718: | ||
| ^ Veateade ^ Põhjus ^ Lahendus ^ | ^ Veateade ^ Põhjus ^ Lahendus ^ | ||
| - | | '' | + | | '' |
| + | | '' | ||
| | '' | | '' | ||
| | '' | | '' | ||
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| | '' | | '' | ||
| - | | '' | + | | '' |
| | '' | | '' | ||
| - | ==== Claude | + | < |
| + | Serveri veateated on inglise keeles. | ||
| + | </ | ||
| + | |||
| ^ Probleem ^ Lahendus ^ | ^ Probleem ^ Lahendus ^ | ||
| Rida 704: | Rida 744: | ||
| | MCP server ei käivitu | Kontrolli et config faili nimi pole '' | | MCP server ei käivitu | Kontrolli et config faili nimi pole '' | ||
| | 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, | + | | 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 '' |
| + | | Päring ei anna vastust (mitme minuti pärast "No result received" | ||
| + | | MCP kadus pärast Claude Desktopi uuendust | Claude kolis andmed uude kausta (Samm 4.1). Kontrolli, et uue kausta '' | ||
| - | 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 " | ||
| Get-Content " | Get-Content " | ||
| - | Get-Content " | ||
| </ | </ | ||
| Rida 718: | Rida 760: | ||
| | ''/ | | ''/ | ||
| | '' | | '' | ||
| - | | Rate limit / 429 viga | Tasuta | + | | Rate limit / 429 viga | Tasuta |
| + | | Gemini CLI ei võta Google' | ||
| Gemini CLI diagnostika: | Gemini CLI diagnostika: | ||
| Rida 728: | 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 '' |
| ^ Grupp ^ Tööriistad ^ | ^ Grupp ^ Tööriistad ^ | ||
| | Müük | get_invoices, | | Müük | get_invoices, | ||
| | Kliendid | get_customers, | | Kliendid | get_customers, | ||
| - | | Tooted / ladu | get_items, get_itemclasses, get_stocklevels, get_stocklevels_sn, | + | | Tooted / ladu | get_items, get_itemclasses, |
| | Ost | get_purchase_orders, | | Ost | get_purchase_orders, | ||
| | Raamatupidamine | get_transactions, | | Raamatupidamine | get_transactions, | ||
| | Logistika | get_deliveries, | | Logistika | get_deliveries, | ||
| - | | Muu | get_projects, | + | | Personal | get_users, get_absences, |
| + | | Varad | get_assets, get_customer_assets | | ||
| + | | Muu | get_projects, | ||
| | 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: | ||
| + | * **Laoseis: | ||
| + | * **Filtrid: | ||
| + | * **Tulemuse maht:** iga vastuse algus näitab vastete arvu ja mahtu. Kui see on " | ||
| + | * **Tundlikud andmed:** personali-, palga-, kulu- ja kasutuslogi tööriistad ('' | ||
| ===== 8. Turvalisus ===== | ===== 8. Turvalisus ===== | ||
| Rida 746: | Rida 801: | ||
| | Keskkonnamuutuja (Gemini varuvõimalus) | Kui Credential Manager on seadistatud, | | Keskkonnamuutuja (Gemini varuvõimalus) | Kui Credential Manager on seadistatud, | ||
| | 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 | + | | 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 | ||
| + | | Ligipääsu ülevaate vahemälu | Fail '' | ||
| | OneDrive/ | | OneDrive/ | ||
| | Admin õigused | Ainult Node.js installimisel (Samm 3.1) — jagatud eelsamm mõlemale teele — kõik muu, sh CredentialManager moodul, töötab '' | | Admin õigused | Ainult Node.js installimisel (Samm 3.1) — jagatud eelsamm mõlemale teele — kõik muu, sh CredentialManager moodul, töötab '' | ||
| - | ===== 9. Viited ===== | + | ===== 9. Uuendamine ja versioon ===== |
| + | |||
| + | ==== Millist versiooni ma kasutan? ==== | ||
| + | |||
| + | MCP serveri versioon on serveri käivitusrea logis ('' | ||
| + | |||
| + | <code powershell> | ||
| + | Select-String -Path " | ||
| + | </ | ||
| + | |||
| + | Skriptide versioon on nähtav nende esimesel real käivitamisel (nt '' | ||
| + | |||
| + | ==== Kuidas uuendada ==== | ||
| + | |||
| + | - Laadi alla **värske** ZIP (vt Samm A1), paki lahti ja ava PowerShell lahtipakitud kaustas. | ||
| + | - Kopeeri uus '' | ||
| + | - 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 " | ||
| + | </ | ||
| + | |||
| + | < | ||
| + | Uus '' | ||
| + | </ | ||
| + | |||
| + | ===== 10. Viited ===== | ||
| **Claude Desktop:** | **Claude Desktop:** | ||
| Rida 756: | Rida 842: | ||
| * [[https:// | * [[https:// | ||
| * [[https:// | * [[https:// | ||
| + | * [[https:// | ||
| * [[https:// | * [[https:// | ||
| Rida 761: | Rida 848: | ||
| * [[https:// | * [[https:// | ||
| * [[https:// | * [[https:// | ||
| + | * [[https:// | ||
| + | * [[https:// | ||
| * [[https:// | * [[https:// | ||
| * [[https:// | * [[https:// | ||
| Rida 772: | Rida 861: | ||
| **Kiirpaigalduse skriptid** (vt Tee A, Peatükk 3): | **Kiirpaigalduse skriptid** (vt Tee A, Peatükk 3): | ||
| - | * '' | + | * '' |
| * '' | * '' | ||
| * '' | * '' | ||
| * '' | * '' | ||
et/ask_directo.1790846365.txt.gz · Viimati muutnud: 2026/10/01 12:19 persoon andrus