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.

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: 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 — 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.

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

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