Sisujuht
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
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?
Mis on MCP?
MCP (Model Context Protocol) on avatud standard, mis võimaldab AI assistentidel otse suhelda väliste süsteemidega — andmebaasidega, API-dega ja rakendustega.
Ilma MCP-ta töötab AI assistendiga nii:
- Sina kopeerid andmeid Directost
- kleebid need AI vestlusesse
- AI vastab
- Sina kopeerid vastuse tagasi Directosse
MCP-ga töötab see nii:
- Sina küsid loomulikus keeles: „Mis artikleid on laos alla miinimumtaseme?“
- AI küsib ise Directo API-st andmed
- AI analüüsib ja vastab kohe
Mis kasu see annab?
| Olukord | Ilma MCP-ta | MCP-ga |
|---|---|---|
| Laoseisu kontroll | Ava Directo → otsi → kopeeri → kleebi AI-sse | „Mis artikleid on laos alla 10 ühiku?“ |
| Arve analüüs | Ekspordi CSV → laadi AI-sse → küsi | „Millised kliendid pole viimase 90 päeva jooksul maksnud?“ |
| Müügiaruanne | Käsitsi koosta → kopeeri → analüüsi | „Võrdle selle kuu müüki eelmise aastaga“ |
| Tellimuste jälgimine | Ava mitu vaadet → kopeeri infot | „Millised tellimused on üle 5 päeva täitmata?“ |
Arhitektuur
Sina (loomulikus keeles)
↕
AI klient (Claude Desktop või Gemini CLI)
↕ MCP protokoll (lokaalne)
MCP Server (sinu arvutis, Node.js)
↕ HTTPS
Directo API (pilves)
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.
- MCP server paigaldatakse ainult sinu isiklikku arvutisse
- See ei ole jagatud - teised kolleegid ei pääse sinu MCP serverile ligi
- Iga kasutaja peab ise kõik sammud tegema oma arvutis
- 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)
- Ü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.
2. Eelduste kontroll
2.1 Kõigile kohustuslikud eeldused
| Eeldus | Kontrollimine | Parandus |
|---|---|---|
| Windows 10 või 11 (64-bit) | Start → Settings → System → About | — |
| Node.js 22 või uuem (LTS) | node –version | nodejs.org → LTS |
| npm | npm –version (töötab alles pärast execution policy seadistamist, vt allpool) | Tuleb Node.js-ga automaatselt kaasa |
| PowerShell execution policy | Get-ExecutionPolicy → peab vastama RemoteSigned | Vt allpool |
| CredentialManager moodul | Get-Module -ListAvailable CredentialManager | Vt allpool |
| Directo API võti | Directo → Admin → Seaded → API | Küsi Directo administraatorilt |
2.2 Claude Desktop kasutajale lisaks
| Eeldus | Kontrollimine | Link |
|---|---|---|
| Claude Desktop installitud | Start menüüs on Claude olemas | claude.ai/download |
| Anthropic konto | Sisselogimine töötab | claude.ai |
Ametlik dokumentatsioon: docs.claude.ai
2.3 Gemini CLI kasutajale lisaks
- tasulise Gemini API võtmega
- Gemini Code Assist Standard / Enterprise litsentsiga
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.
| Eeldus | Kontrollimine | Link |
|---|---|---|
| Google konto | gmail.com ligipääs töötab | accounts.google.com |
| Google AI Studio API võti | aistudio.google.com/apikey | Loo API võti |
| Gemini CLI installitud | gemini –version | npm install -g @google/gemini-cli |
Ametlik dokumentatsioon: geminicli.com/docs
2.4 Admin õigused — millal on vaja?
| Samm | Admin õigused? | Põhjus |
|---|---|---|
| Node.js installimine | Jah - installer nõuab | Süsteemitaseme paigaldus (Program Files) |
| PowerShell execution policy | Ei | -Scope CurrentUser kirjutab HKCU registrisse |
| CredentialManager moodul | Ei | -Scope CurrentUser paigaldab kasutaja profiili alla |
| npm install (MCP server) | Ei | Kasutajataseme paigaldus |
| Claude Desktop config | Ei | Kasutaja kaustad |
| Gemini CLI config | Ei | Kasutaja kaustad |
| API võtme salvestamine | Ei | Credential Manager kasutajataseme võti |
Riskid ja oluline hoiatus:
- Node.js installer — madal risk, ametlik tarkvara
- Ära ava ühtegi ülejäänud sammu administraatorina, isegi kui varasem juhendi versioon või internetist leitud näited seda soovitavad -
-Scope CurrentUseron mõeldud just admin-õiguste vältimiseks - Kui sinu igapäevane konto ja admin-õigused tulevad eraldi Windowsi kontodelt (levinud ettevõtte/domeeni keskkonnas), tekitab administraatorina avamine tegevuse teise konto profiili all — moodul, seadistus või võti „kaob“ sinu tavakasutaja vaatevinklist. Vaata täpsemalt tõrkeotsingu peatükki.
- Ära käivita
npm installadministraatorina - see tekitab õiguste konflikte npm install -g(nt Gemini CLI, Samm 5.1) vajab admin-õigusi ainult siis, kui npm'i globaalne prefix osutabProgram Fileskausta — Samm 5.1 sisaldab parandust, mis seda vältib
3. Ühised sammud (tee üks kord)
Samm 3.1 — Node.js paigaldamine (kohustuslik)
- Mine https://nodejs.org ja laadi alla LTS versioon (22 või uuem)
- Käivita allalaaditud
.msifail administraatorina - Installi vaikimisi seadetega — ära muuda paigalduskohta
Kontrolli paigaldust (tavaline PowerShell, mitte admin):
node --version
Oodatav tulemus:
v22.11.0 või uuem
npm –version kontrolli siin veel tahtlikult ei tee — npm on PowerShelli skript (npm.ps1) ja annab enne execution policy seadistamist (Tee A skript või Samm B1) vea running scripts is disabled, isegi kui Node.js ja npm ise on korrektselt paigaldatud. See ei ole viga, vaid oodatav käitumine selles etapis. npm –version töötab pärast Tee A/B läbimist.
Vali oma tee
| Tee A — Skriptid | Tee B — Käsitsi | |
|---|---|---|
| Aeg | ~5 minutit | ~20 minutit |
| Sobib | Enamikule kasutajatele | Soovid ise igast sammust aru saada, või Tee A ei tööta sinu keskkonnas |
| Sisaldab samme | A1—A2 | B1—B7 |
Kui valid Tee A ja see õnnestub, jäta Tee B (B1—B7) täielikult vahele — need kirjeldavad sama asja, mida skriptid juba sinu eest tegid, ainult käsitsi. Tee B on abimaterjal tõrkeotsinguks, mitte täiendav kohustuslik samm.
TEE A — Kiirpaigaldus skriptidega (soovitatud)
Samm A1 — failide allalaadimine
Lae alla directo-mcp-failid.zip ja paki lahti:
.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.
[OK] = õnnestus, [!] = vajab sinu tähelepanu, [ERROR] = viga.
v1.5). Kui versiooninumbrit ei näe, on tegu vana koopiaga.
Paki lahti (parem klõps ZIP-il → Extract All, või PowerShellis):
Expand-Archive "$env:USERPROFILE\Downloads\directo-mcp-failid.zip" -DestinationPath "$env:USERPROFILE\Downloads\directo-mcp-failid" cd "$env:USERPROFILE\Downloads\directo-mcp-failid"
Enne skriptide käivitamist tuleb kõrvaldada kaks Windowsi vaikimisi turvapiirangut — mõlemad on kohustuslikud, mitte valikulised:
1) Luba PowerShellis skriptide käivitamine üldse:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
running scripts is disabled on this system / UnauthorizedAccess. -Scope CurrentUser ei vaja admin-õigusi.
2) Eemalda Windowsi „kaugelt pärit“ (Mark of the Web) märgistus:
Get-ChildItem "$env:USERPROFILE\Downloads\directo-mcp-failid" -Recurse | Unblock-File
RemoteSigned nõuab selliste failide puhul digiallkirja, mida meie skriptidel pole. Ilma selle sammuta on veateade is not digitally signed / UnauthorizedAccess, mis on eksitavalt sarnane 1. sammu veaga, aga põhjus ja lahendus on erinevad.
Arhiiv sisaldab nelja faili: directo-mcp.js (MCP server ise), set-directo-apikey.ps1, install-claude-mcp.ps1, install-gemini-mcp.ps1.
Samm A2 — käivitamine
Samas PowerShelli aknas (mitte administraatorina), juba lahtipakitud kaustas:
A2.1 API võti (ühine mõlemale, tee see esimesena)
.\set-directo-apikey.ps1
A2.2 Vali oma AI klient (või mõlemad):
Claude
.\install-claude-mcp.ps1
Gemini
.\install-gemini-mcp.ps1
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.
TEE B — Käsitsi, samm-sammult (alternatiiv Tee A-le)
Samm B1 — PowerShell execution policy seadistamine
Kontrolli olemasolevat seadistust:
Get-ExecutionPolicy
Kui vastus ei ole RemoteSigned, paranda seda tavalises PowerShellis (mitte administraatorina):
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
-Scope CurrentUser kirjutab seadistuse ainult HKEY_CURRENT_USER registrisse, mitte masina tasemel kohta — seetõttu ei vaja see admin-õigusi. Admin-õigusi läheks vaja ainult -Scope LocalMachine korral, mida see juhend ei kasuta.
Küsib kinnitust → vajuta Y → Enter.
Samm B2 — CredentialManager moodul
Ava tavaline PowerShell (mitte administraatorina) — täpselt sama kasutajakonto all, mille all hiljem ka MCP server töötab:
Install-Module -Name CredentialManager -Force -Scope CurrentUser
-Scope CurrentUser on mõeldud just selleks, et vältida admin-õiguste vajadust — moodul paigaldub sinu enda profiili alla (Documents\WindowsPowerShell\Modules). Kui käsk küsib kinnitust NuGet provideri või „untrusted repository“ jaoks, vasta Y — ka need sammud ei vaja admin-õigusi.
Kontrolli et installimine õnnestus (samas tavalises PowerShellis):
Get-Module -ListAvailable CredentialManager
Peaks kuvama mooduli nime ja versiooni.
node directo-mcp.js. Elevatsiooniga avatud PowerShell võib tegelikult töötada teise konto identiteedi all, mistõttu moodul või API võti jääks vale profiili alla ja hilisem samm ebaõnnestub nähtamatult.
Samm B3 — MCP serveri kausta loomine
Ava tavaline PowerShell (mitte admin) ja käivita:
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\directo-mcp"
$env:USERPROFILE muutujat, mitte käsitsi kirjutatud C:\Users\SINUNIMI. Domeeniga liidetud arvutites (ettevõtte/AD keskkond) võib tegelik profiilikaust erineda sinu sisselogimisnimest — nt sisaldada domeenisufiksit (SINUNIMI.DOMEEN). $env:USERPROFILE annab alati tegeliku, õige tee, sõltumata sellest.
Samm B4 — directo-mcp.js paigutamine
Lae alla directo-mcp.js fail — see sisaldub Tee A juures viidatud directo-mcp-failid.zip arhiivis (paki lahti, vt Samm A1) — ja aseta see kausta:
$env:USERPROFILE\directo-mcp\directo-mcp.js
Kõige lihtsam viis: kui fail on juba lahtipakitud Downloads alamkaustas, kopeeri see PowerShellis:
Copy-Item "$env:USERPROFILE\Downloads\directo-mcp-failid\directo-mcp.js" "$env:USERPROFILE\directo-mcp\directo-mcp.js"
directo-mcp.js — mitte directo-mcp.js.txt. Kontrolli:Test-Path "$env:USERPROFILE\directo-mcp\directo-mcp.js"
Peaks vastama True. Kui False, kontrolli täpset failinime:
Get-ChildItem "$env:USERPROFILE\directo-mcp"
Samm B5 — package.json loomine
Ava uus Notepad aken ja kopeeri:
{
"name": "directo-mcp",
"version": "1.0.0",
"type": "module",
"description": "Directo ERP MCP Server",
"main": "directo-mcp.js",
"scripts": {
"start": "node directo-mcp.js"
},
"dependencies": {
"@modelcontextprotocol/sdk": "^1.0.0",
"zod": "^3.22.0"
}
}
Salvesta sama kausta nimega package.json (failitüüp: All Files).
Samm B6 — Sõltuvuste installimine
Tavaline PowerShell (mitte admin):
cd "$env:USERPROFILE\directo-mcp" npm install
Edukal installimisel tekib kaustas node_modules kaust ja package-lock.json fail.
directo-mcp kausta enda node_modules alla), mitte globaalne — ei vaja kunagi admin-õigusi ega erilist npm-prefixi seadistust, sõltumata sellest, kuidas Node.js algselt paigaldati.
Samm B7 — API võtme turvaline salvestamine
Directo API võti salvestatakse Windows Credential Managerisse — krüpteeritult sinu kasutajakonto alla. Keegi teine arvutis ei näe seda võtit.
New-StoredCredential -Target DIRECTO_API_KEY -UserName directo -Password SINU_PÄRIS_VÕTI_SIIA -Persist LocalMachine
Kontrolli et salvestus õnnestus:
(Get-StoredCredential -Target DIRECTO_API_KEY).GetNetworkCredential().Password
Peaks kuvama sinu API võtme.
API võtme uuendamine tulevikus (rotatsioon):
Remove-StoredCredential -Target DIRECTO_API_KEY New-StoredCredential -Target DIRECTO_API_KEY -UserName directo -Password UUS_VÕTI -Persist LocalMachine
node directo-mcp.js töötab. Vaata Sammu B2 hoiatust eraldi admin-konto riski kohta.
set-directo-apikey.ps1) teeb sama asja turvalisemalt (küsib võtme varjatult, ei kuva ekraanil) ja sobib ka rotatsiooniks — kasuta seda, kui saad.
4. Claude Desktop seadistamine
install-claude-mcp.ps1 skripti, on Sammud 4.1—4.2 juba tehtud — skript tuvastab, patchib ja varundab konfiguratsioonifaili automaatselt. Mine otse Sammu 4.3 juurde.
Samm 4.1 — Konfiguratsioonifaili asukoht
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.
| Variant | Asukoht |
|---|---|
| MSIX (claude.ai/download), andmed kolitud (Claude Desktop 3.1623 ja uuem) | %LOCALAPPDATA%\Claude-Data\claude_pzs8sxrjxfjjc\ |
| 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\ |
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.
Näita, millised neist failidest sinu masinas olemas on (tavaline PowerShell):
"$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 $_ }
Kasuta nimekirja esimest faili (järjekord on sama mis tabelis: uuem enne vanemat). Erandid:
- Kui nimekirjas on
Packages\…fail ja samas kaustas on ka fail.user-data-left…, on see fail aegunud — ära kasuta seda. - Kui kaust
%LOCALAPPDATA%\Claude-Data\claude_pzs8sxrjxfjjcon olemas, aga seal ei oleclaude_desktop_config.jsonfaili: ava Claude Desktop → Settings → Developer → Edit Config (see loob faili) ja korda käsku. - Kui nimekiri on tühi: käivita Claude Desktop vähemalt korra ja korda käsku.
Samm 4.2 — Konfiguratsioonifail
Loo (õiges, Sammus 4.1 tuvastatud) kaustas fail nimega claude_desktop_config.json.
claude_desktop_config.json
Faili sisu:
{
"mcpServers": {
"directo": {
"command": "node",
"args": [
"C:\\Users\\SINUNIMI\\directo-mcp\\directo-mcp.js"
]
}
}
}
SINUNIMI oma tegeliku profiilikausta nimega — mitte oletatava kasutajanimega. Domeeniga (AD) liidetud arvutites võib tegelik profiilikaust erineda sisselogimisnimest (nt sisaldada domeenisufiksit). Kontrolli täpset väärtust:$env:USERPROFILE
Kasuta JSON-is täpselt seda, mida käsk tagastab (topelt-kaldkriipsudega). Näide illustratsiooniks — kui $env:USERPROFILE annab tulemuseks C:\Users\jaan.kasutaja.FIRMA, peaks tee JSON-is olema C:\\Users\\jaan.kasutaja.FIRMA\\directo-mcp\\directo-mcp.js. Domeenisufiksi (.FIRMA) olemasolu või puudumine sõltub sinu enda arvuti seadistusest — kasuta alati oma käsu tegelikku väljundit, mitte seda näidet.
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.
Samm 4.3 — Claude Desktop taaskäivitamine
- Paremklikk Claude ikoonil süsteemisalves (tegumiriba kella kõrval) → Quit / Exit
- Pelgalt akna sulgemisest ei piisa — Claude Desktop jääb taustal tööle
- Kui Quit puudub — ava Task Manager → leia Claude protsess → End Task
- Ava Claude Desktop uuesti ja oota mõni sekund
Samm 4.4 — Testimine
Kirjuta Claude Desktop vestluses esmalt:
Millised Directo liidesed on minu API võtmel lubatud?
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.
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.
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:
Praegustes Claude Desktopi versioonides on logid kaustas %LOCALAPPDATA%\Claude\logs:
# Praegused Claude Desktopi versioonid: Get-Content "$env:LOCALAPPDATA\Claude\logs\mcp-server-directo.log" -Tail 30 # Vana .exe installer: Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" -Tail 30
Ametlik Claude Desktop MCP dokumentatsioon: modelcontextprotocol.io - Connect to local MCP servers
%APPDATA%\Claude\…). Selle juhendi Samm 4.1 kirjeldab Claude Desktopi praegust asukohta.
5. Gemini CLI seadistamine
install-gemini-mcp.ps1 skripti, on Sammud 5.1 ja 5.3—5.4 juba tehtud. Käi läbi ainult Samm 5.2 (Google API võti — skript seda ei tee, see on eraldiseisev Google'i, mitte Directo, autentimine) ja Sammud 5.5—5.6.
Samm 5.1 — Gemini CLI paigaldamine
mkdir "$env:APPDATA\npm-global" -Force npm config set prefix "$env:APPDATA\npm-global" [Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:APPDATA\npm-global", "User")
Sulge PowerShell täielikult ja ava uus aken (PATH värskendub alles uues sessioonis), seejärel paigalda Gemini CLI:
npm install -g @google/gemini-cli
Kontrolli:
gemini --version
C:\Program Files\… peale. Kontrolli praegust seadistust käsuga npm config get prefix — see peaks pärast ülaltoodud sammu näitama %APPDATA%\npm-global, mitte Program Files kausta.
Samm 5.2 — Google API võtme seadistamine
Ava aistudio.google.com/apikey ja loo API võti.
Salvesta võti keskkonnmuutujana püsivalt:
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "SINU_GOOGLE_API_VÕTI", "User")
Sulge PowerShell ja ava uuesti. Kontrolli:
$env:GEMINI_API_KEY
Samm 5.3 — Konfiguratsioonifaili asukoht
Gemini CLI konfiguratsioon asub Windowsis:
$env:USERPROFILE\.gemini\settings.json
Kontrolli kas kaust on olemas:
Test-Path "$env:USERPROFILE\.gemini"
Kui vastus on False, loo kaust:
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.gemini"
Samm 5.4 — MCP serveri lisamine
Loo või muuda faili $env:USERPROFILE\.gemini\settings.json:
{
"mcpServers": {
"directo": {
"command": "node",
"args": [
"C:\\Users\\SINUNIMI\\directo-mcp\\directo-mcp.js"
],
"env": {
"DIRECTO_API_KEY": "$DIRECTO_API_KEY"
}
}
}
}
„trust“: true lisandub Sammus 5.5 — see puudutab kausta usaldamist, mitte API võtit, seega on eraldi teema.
SINUNIMI oma tegeliku profiilikausta nimega — kontrolli täpset väärtust käsuga $env:USERPROFILE (vt Sammu 4.2 hoiatust sama teema kohta).
directo-mcp.js loeb võtme kõigepealt Credential Managerist (Tee A skript või Samm B7) — see töötab täpselt samamoodi Gemini puhul kui Claude Desktopi puhul, kuna mõlemad käivitavad sama serverifaili. env plokk siin on varuvõimalus, mitte ainuke tee — kui Credential Manager on juba seadistatud, ei ole see plokk rangelt vajalik, aga ei tee ka kahju. Kui soovid seda siiski kasutada, salvesta väärtus keskkonnamuutujana:[System.Environment]::SetEnvironmentVariable("DIRECTO_API_KEY", "SINU_DIRECTO_API_VÕTI", "User")
Gemini CLI toetab env väärtustes keskkonnamuutuja laiendust süntaksiga $VAR_NAME — sellepärast on JSON-is kirjas „$DIRECTO_API_KEY“, mitte tegelik võti.
Samm 5.5 — Kausta usaldamine (Trusted Folders)
Gemini CLI-l on turvafunktsioon Trusted Folders, mis vaikimisi ei luba usaldamata kaustast MCP servereid ühendada. Kui see funktsioon on sisse lülitatud, tuleb kaust usaldada.
Kõige lihtsam viis — usalda server otse settings.json-is, lisades directo plokki „trust“: true:
{
"mcpServers": {
"directo": {
"command": "node",
"args": [
"C:\\Users\\SINUNIMI\\directo-mcp\\directo-mcp.js"
],
"env": {
"DIRECTO_API_KEY": "$DIRECTO_API_KEY"
},
"trust": true
}
}
}
„trust“: true möödub tööriistakutsete kinnitusdialoogidest. Kasuta seda ainult serverite puhul, mida sa ise täielikult haldad — see Directo server on selline.
Alternatiiv — kui Trusted Folders on sisse lülitatud, kuvab Gemini CLI kausta esmakordsel avamisel usaldusdialoogi. Vali seal Trust folder. Valik salvestatakse faili ~/.gemini/trustedFolders.json ja seda küsitakse iga kausta kohta ainult üks kord. Usaldustaseme hilisemaks muutmiseks kasuta CLI sees käsku /permissions.
Samm 5.6 — Testimine
Käivita Gemini CLI:
gemini
Kontrolli MCP ühendust:
/mcp list
Peaks kuvama:
🟢 directo - Ready (41 tools)
Testi päring:
Millised Directo liidesed on minu API võtmel lubatud?
Ametlik Gemini CLI MCP dokumentatsioon: geminicli.com/docs/tools/mcp-server
6. Tõrkeotsing
Üldised vead (mõlemale kliendile)
| Veateade | Põhjus | Lahendus |
|---|---|---|
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“ |
SyntaxError | directo-mcp.js fail on vigane või poolik | Lae fail uuesti alla, vt Samm B4 (või Tee A: A1) |
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?“ |
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) |
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 |
| Probleem | Lahendus |
|---|---|
| Haamriikoon puudub | Kontrolli logifaili (vt allpool) |
| 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 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 (praegused Claude Desktopi versioonid, vana .exe installeri jaoks teine rida):
Get-Content "$env:LOCALAPPDATA\Claude\logs\mcp-server-directo.log" -Tail 30 Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" -Tail 30
Gemini CLI spetsiifilised vead
| Probleem | Lahendus |
|---|---|
/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 |
| 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:
/mcp list
7. MCP tööriistad
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 |
|---|---|
| Müük | get_invoices, get_orders, get_sales_quotations, get_sales_contracts, get_receipts |
| Kliendid | get_customers, get_suppliers, get_contacts |
| 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 |
| Raamatupidamine | get_transactions, get_accounts, get_financial_budgets, get_nettings |
| Logistika | get_deliveries, get_movements |
| 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 |
| 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.jsonkaustasdirecto-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 (ntstocklevels), 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, kasutaget_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
| Meede | Selgitus |
|---|---|
| Credential Manager (mõlemad kliendid) | API võti krüpteeritud, nähtav ainult sinu Windowsi kontole — Claude ja Gemini loevad sama kirjet |
| 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 |
| 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 |
| 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. Uuendamine ja versioon
Millist versiooni ma kasutan?
MCP serveri versioon on serveri käivitusrea logis (Directo MCP server v… started (N tools)):
Select-String -Path "$env:LOCALAPPDATA\Claude\logs\mcp-server-directo.log" -Pattern "Directo MCP server v" | Select-Object -Last 1
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.jsvana 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:
Copy-Item .\directo-mcp.js "$env:USERPROFILE\directo-mcp\directo-mcp.js" -Force
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.
10. Viited
Claude Desktop:
Gemini CLI:
Directo:
Üldine:
Kiirpaigalduse skriptid (vt Tee A, Peatükk 3):
directo-mcp.js— MCP server (41 tööriista)set-directo-apikey.ps1— API võtme haldus (algseadistus + rotatsioon)install-claude-mcp.ps1— Claude Desktopi automaatpaigaldusinstall-gemini-mcp.ps1— Gemini CLI automaatpaigaldus