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.
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.
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:
MCP-ga töötab see nii:
| 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?“ |
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.
login.directo.ee/BAAS/…): veendu, et API võti on loodud õiges andmebaasis.| 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 |
| 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
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
| 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:
-Scope CurrentUser on mõeldud just admin-õiguste vältimiseksnpm install administraatorina - see tekitab õiguste konfliktenpm install -g (nt Gemini CLI, Samm 5.1) vajab admin-õigusi ainult siis, kui npm'i globaalne prefix osutab Program Files kausta — Samm 5.1 sisaldab parandust, mis seda vältib.msi fail administraatorinaKontrolli 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.
| 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.
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.
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.
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.
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.
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"
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).
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.
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.
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.
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:
Packages\… fail ja samas kaustas on ka fail .user-data-left…, on see fail aegunud — ära kasuta seda.%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.
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.
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.
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.
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.
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
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"
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.
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.
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
| 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
| 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
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 |
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.get_stocklevels_sn. Kui see liides ei ole võtmel lubatud, kasuta get_stocklevels.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.| 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) |
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).
directo-mcp.js vana asemele (käsk allpool).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.
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