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:

1. Sina kopeerid andmeid Directost
2. kleebid need AI vestlusesse
3. AI vastab
4. Sina kopeerid vastuse tagasi Directosse

MCP-ga töötab see nii:

1. Sina küsid loomulikus keeles: „Mis artikleid on laos alla miinimumtaseme?“
2. AI küsib ise Directo API-st andmed
3. AI analüüsib ja vastab kohe

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 - Directo andmed ei liigu läbi AI pilveteenuse serveri.

Ametlik dokumentatsioon: docs.claude.ai

Ametlik dokumentatsioon: geminicli.com/docs

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 CurrentUser on 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 install administraatorina - see tekitab õiguste konflikte
• npm 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

1. Mine https://nodejs.org ja laadi alla LTS versioon (22 või uuem)
2. Käivita allalaaditud .msi fail administraatorina
3. Installi vaikimisi seadetega — ära muuda paigalduskohta

Kontrolli paigaldust (tavaline PowerShell, mitte admin):

node --version

Oodatav tulemus:

v22.11.0 või uuem

Samm A1 — failide allalaadimine

Lae alla directo-mcp-failid.zip ja paki lahti:

directo-mcp-failid.zip

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

2) Eemalda Windowsi „kaugelt pärit“ (Mark of the Web) märgistus:

Get-ChildItem "$env:USERPROFILE\Downloads\directo-mcp-failid" -Recurse | Unblock-File

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:

# API võti (ühine mõlemale, tee see esimesena)
.\set-directo-apikey.ps1
 
# Vali oma AI klient (või mõlemad):
.\install-claude-mcp.ps1
.\install-gemini-mcp.ps1

Iga skript näitab lõpus kokkuvõtte — mis on tehtud (✅) ja mis vajab veel käsitsi tegevust (❗).

Kontrolli olemasolevat seadistust:

Get-ExecutionPolicy

Kui vastus ei ole RemoteSigned, paranda seda tavalises PowerShellis (mitte administraatorina):

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

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

Kontrolli et installimine õnnestus (samas tavalises PowerShellis):

Get-Module -ListAvailable CredentialManager

Peaks kuvama mooduli nime ja versiooni.

Ava tavaline PowerShell (mitte admin) ja käivita:

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\directo-mcp"

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"

Test-Path "$env:USERPROFILE\directo-mcp\directo-mcp.js"

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 API võti salvestatakse Windows Credential Managerisse — krüpteeritult sinu kasutajakonto alla. Keegi teine arvutis ei näe seda võtit.

cmdkey /generic:DIRECTO_API_KEY /user:directo /pass:SINU_PÄRIS_VÕTI_SIIA

Kontrolli et salvestus õnnestus:

(Get-StoredCredential -Target DIRECTO_API_KEY).GetNetworkCredential().Password

Peaks kuvama sinu API võtme.

API võtme uuendamine tulevikus (rotatsioon):

cmdkey /delete:DIRECTO_API_KEY
cmdkey /generic:DIRECTO_API_KEY /user:directo /pass:UUS_VÕTI

Claude Desktopil on Windowsis kaks võimalikku konfiguratsiooni asukohta, sõltuvalt installimisviisist:

Kontrolli, kumb sinu masinas kehtib — ava File Explorer ja proovi mõlemat aadressiribale:

%APPDATA%\Claude

Kui seal on olemas claude_desktop_config.json fail (või Claude Desktop on seal midagi juba loonud), kasuta seda teed. Kui mitte, proovi:

%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude

Loo (õiges, Sammus 4.1 tuvastatud) kaustas fail nimega claude_desktop_config.json.

Faili sisu:

{
  "mcpServers": {
    "directo": {
      "command": "node",
      "args": [
        "C:\\Users\\SINUNIMI\\directo-mcp\\directo-mcp.js"
      ]
    }
  }
}

$env:USERPROFILE

1. Paremklikk Claude ikoonil süsteemisalves (tegumiriba kella kõrval) → Quit / Exit
2. Pelgalt akna sulgemisest ei piisa — Claude Desktop jääb taustal tööle
3. Kui Quit puudub — ava Task Manager → leia Claude protsess → End Task
4. Ava Claude Desktop uuesti ja oota mõni sekund

Kirjuta Claude Desktop vestluses:

Anna mulle kõik laoseisud

Claude peaks automaatselt kasutama get_stocklevels tööriista ja tagastama Directo andmed.

Logide kontroll kui midagi ei tööta:

Logi asukoht järgib sama kahte võimalust, mis Sammus 4.1:

# Otsene .exe installer:
Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" -Tail 30
 
# Microsoft Store / MSIX:
Get-Content "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\logs\mcp-server-directo.log" -Tail 30

Ametlik Claude Desktop MCP dokumentatsioon: modelcontextprotocol.io — Connect to local MCP servers

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

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"
      }
    }
  }
}

[System.Environment]::SetEnvironmentVariable("DIRECTO_API_KEY", "SINU_DIRECTO_API_VÕTI", "User")

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
    }
  }
}

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 (32 tools)

Testi päring:

Anna mulle kõik laoseisud

Ametlik Gemini CLI MCP dokumentatsioon: geminicli.com/docs/tools/mcp-server

Logifail (proovi mõlemat, vt Samm 4.1):

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

Gemini CLI diagnostika:

/mcp list

Mõlemad kliendid (Claude Desktop ja Gemini CLI) kasutavad samu tööriistu:

Claude Desktop:

• Claude Desktop allalaadimine
• Claude Desktop MCP seadistamine
• Claude Desktop lokaalsete MCP serverite juhend
• MCP ametlik dokumentatsioon

Gemini CLI:

• Gemini CLI dokumentatsioon
• Gemini CLI MCP seadistamine
• Google AI Studio API võtmed
• Gemini Code Assist dokumentatsioon

Directo:

• Directo API dokumentatsioon

Üldine:

• Node.js allalaadimine
• CredentialManager PowerShell moodul

Kiirpaigalduse skriptid (vt Tee A, Peatükk 3):

• directo-mcp.js — MCP server (32 tööriista, skeemipõhiselt kontrollitud)
• set-directo-apikey.ps1 — API võtme haldus (algseadistus + rotatsioon)
• install-claude-mcp.ps1 — Claude Desktopi automaatpaigaldus
• install-gemini-mcp.ps1 — Gemini CLI automaatpaigaldus