Ask Directo: Directo MCP servera uzstādīšana - Claude Desktop un Gemini CLI

Šī pamācība skaidro, kā savienot Directo ERP sistēmu ar MI asistentu (Claude vai Gemini), izmantojot lokālu MCP (Model Context Protocol) serveri. Pamācība paredzēta gan Claude Desktop, gan Gemini CLI lietotājiem — kopīgie soļi jāizdara tikai vienu reizi, pēc tam izvēlies sadaļu, kas atbilst tavam MI klientam.

MCP (Model Context Protocol) ir atvērts standarts, kas ļauj MI asistentiem sazināties tieši ar ārējām sistēmām — datubāzēm, API (lietojumprogrammu saskarnēm) un lietotnēm.

Bez MCP darbs ar MI asistentu izskatās šādi:

1. Tu nokopē datus no Directo
2. Tu ielīmē tos MI sarunā
3. MI atbild
4. Tu kopē atbildi atpakaļ Directo

Ar MCP tas izskatās šādi:

1. Tu pajautā dabiskā valodā: „Kuriem artikuliem atlikums ir zem minimuma?”
2. MI pats vaicā Directo API (lietojumprogrammu saskarnei)
3. MI analizē datus un atbild uzreiz

Tu (dabiskā valodā)
        ↕
MI klients (Claude Desktop vai Gemini CLI)
        ↕  MCP protokols (lokāli)
MCP serveris (tavā datorā, Node.js)
        ↕  HTTPS
Directo API (mākonis)

MCP serveris darbojas tavā datorā. Directo API atslēga nekad nepamet tavu datoru. Taču no Directo iegūtie dati tiek nosūtīti tālāk uz MI pakalpojuma sniedzēja mākoni, lai modelis tos varētu izlasīt un formulēt atbildi dabiskā valodā — tieši tāpat kā jebkurš cits sarunas saturs.

Pirms instalēšanas pārbaudi visus priekšnosacījumus. Neizpildīts priekšnosacījums ir visbiežākais neveiksmes iemesls.

Oficiālā dokumentācija: https://docs.claude.ai

Oficiālā dokumentācija: https://geminicli.com/docs

Riski un svarīgs brīdinājums:

• Node.js instalētājs — zems risks, oficiāla programmatūra
• Nevienu no pārējiem soļiem neatver kā administrators, pat ja iepriekšēja šīs pamācības versija vai internetā atrasti piemēri to iesaka — -Scope CurrentUser pastāv tieši tāpēc, lai administratora tiesības nebūtu vajadzīgas
• Ja tava ikdienas konta un administratora tiesību konts ir divi atsevišķi Windows konti (bieži uzņēmumu un domēna vidēs), atverot kaut ko kā administrators, darbība tiek veikta otra konta profilā — modulis, iestatījums vai atslēga pēc tam „pazūd” no tava parastā lietotāja skatpunkta. Sīkāk skat. problēmu novēršanas nodaļā.
• Nepalaid npm install kā administrators — tas rada atļauju konfliktus
• npm install -g (piemēram, Gemini CLI, solis 5.1) prasa administratora tiesības tikai tad, ja npm globālais prefikss norāda uz Program Files mapi — solī 5.1 ir aprakstīts risinājums, kas no tā izvairās

1. Ej uz https://nodejs.org un lejupielādē LTS versiju (22 vai jaunāku)
2. Palaid lejupielādēto .msi failu kā administrators
3. Instalē ar noklusējuma iestatījumiem — nemaini instalācijas atrašanās vietu

Pārbaudi instalāciju (parastā PowerShell, nevis administratora režīmā):

node --version

Gaidāmais rezultāts:

v22.11.0 vai jaunāka

Ja izvēlies A ceļu un tas izdodas, B ceļu (B1—B7) izlaid pavisam — tie soļi manuāli apraksta tieši to, ko skripti jau ir izdarījuši tavā vietā. B ceļš ir problēmu novēršanas atsauces materiāls, nevis papildu obligāts solis.

Solis A1 — Failu lejupielāde

Lejupielādē directo-mcp-files.zip un atarhivē to:

directo-mcp-files.zip

Atarhivē to (labais klikšķis uz ZIP → Extract All, vai PowerShell):

Expand-Archive "$env:USERPROFILE\Downloads\directo-mcp-files.zip" -DestinationPath "$env:USERPROFILE\Downloads\directo-mcp-files"
cd "$env:USERPROFILE\Downloads\directo-mcp-files"

Pirms skriptu palaišanas jānoņem divi Windows noklusējuma drošības ierobežojumi — abi ir obligāti, nevis pēc izvēles:

1) Atļaut skriptu izpildi PowerShell vispār:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

2) Noņemt Windows atzīmi „lejupielādēts no interneta” (Mark of the Web):

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

Arhīvā ir četri faili: directo-mcp.js (pats MCP serveris), set-directo-apikey.ps1, install-claude-mcp.ps1, install-gemini-mcp.ps1.

Solis A2 — Skriptu palaišana

Tajā pašā PowerShell logā (ne kā administrators), tikko atarhivētajā mapē:

# API atslēga (kopīga abiem klientiem, dari to vispirms)
.\set-directo-apikey.ps1
 
# Izvēlies savu MI klientu (vai abus):
.\install-claude-mcp.ps1
.\install-gemini-mcp.ps1

Katrs skripts beigās izvada kopsavilkumu — kas ir izdarīts (✅) un kas vēl jādara manuāli (❗).

Pārbaudi pašreizējo iestatījumu:

Get-ExecutionPolicy

Ja atbilde nav RemoteSigned, izlabo to parastā PowerShell logā (ne kā administrators):

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Tiks prasīts apstiprinājums → nospied Y → Enter.

Atver parastu PowerShell logu (ne kā administrators) — tieši ar to pašu lietotāja kontu, ar kuru vēlāk darbosies MCP serveris:

Install-Module -Name CredentialManager -Force -Scope CurrentUser

Pārbaudi, vai instalācija izdevās (tajā pašā parastajā PowerShell logā):

Get-Module -ListAvailable CredentialManager

Jāparāda moduļa nosaukums un versija.

Atver parastu PowerShell logu (ne administratora) un palaid:

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

Lejupielādē failu directo-mcp.js — tas ir iekļauts A ceļā saistītajā directo-mcp-files.zip arhīvā (atarhivē to, skat. soli A1) — un ievieto to šajā mapē:

$env:USERPROFILE\directo-mcp\directo-mcp.js

Vienkāršākais veids: ja fails jau ir atarhivētajā Downloads apakšmapē, nokopē to ar PowerShell:

Copy-Item "$env:USERPROFILE\Downloads\directo-mcp-files\directo-mcp.js" "$env:USERPROFILE\directo-mcp\directo-mcp.js"

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

Jāatgriež True. Ja False, pārbaudi precīzu faila nosaukumu:

Get-ChildItem "$env:USERPROFILE\directo-mcp"

Atver jaunu Notepad logu un ielīmē:

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

Saglabā to tajā pašā mapē ar nosaukumu package.json (faila tips: All Files).

Parastā PowerShell (ne administratora):

cd "$env:USERPROFILE\directo-mcp"
npm install

Veiksmīga instalācija izveido šajā mapē node_modules mapi un package-lock.json failu.

Directo API atslēga tiek saglabāta Windows Credential Manager — šifrēti un tikai tava lietotāja konta ietvaros. Neviens cits šajā datorā šo atslēgu neredz.

New-StoredCredential -Target DIRECTO_API_KEY -UserName directo -Password YOUR_REAL_KEY_HERE -Persist LocalMachine

Pārbaudi, vai saglabāšana izdevās:

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

Jāparāda tava API atslēga.

API atslēgas nomaiņa nākotnē:

Remove-StoredCredential -Target DIRECTO_API_KEY
New-StoredCredential -Target DIRECTO_API_KEY -UserName directo -Password NEW_KEY -Persist LocalMachine

Claude Desktop Windows vidē ir divas iespējamās konfigurācijas atrašanās vietas atkarībā no tā, kā tas tika instalēts:

Pārbaudi, kurš variants attiecas uz tavu datoru — atver File Explorer un izmēģini adreses joslā abus:

%APPDATA%\Claude

Ja tur jau ir fails claude_desktop_config.json (vai Claude Desktop tur jau kaut ko izveidojis), izmanto šo ceļu. Ja nē, izmēģini:

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

Izveido failu ar nosaukumu claude_desktop_config.json mapē, ko noteici solī 4.1.

Faila saturs:

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

$env:USERPROFILE

JSON failā izmanto tieši to, ko komanda atgriež (ar dubultajām slīpsvītrām). Piemērs ilustrācijai — ja $env:USERPROFILE atgriež C:\Users\john.user.COMPANY, tad ceļam JSON failā jābūt C:\\Users\\john.user.COMPANY\\directo-mcp\\directo-mcp.js. Vai domēna sufikss (.COMPANY) ir vai nav, atkarīgs no tava datora konfigurācijas — vienmēr izmanto savas komandas faktisko izvadi, nevis šo piemēru.

1. Labais klikšķis uz Claude ikonas sistēmas teknē (pie pulksteņa, uzdevumjoslā) → Quit / Exit
2. Ar loga aizvēršanu vien nepietiek — Claude Desktop turpina darboties fonā
3. Ja Quit nav pieejams — atver uzdevumu pārvaldnieku → atrodi Claude procesu → End Task
4. Atver Claude Desktop no jauna un uzgaidi dažas sekundes

Claude Desktop sarunā ieraksti:

Parādi visus noliktavas atlikumus

Claude automātiski izmantos rīku get_stocklevels un atgriezīs datus no Directo.

Žurnālfailu pārbaude, ja kaut kas nedarbojas:

Žurnālfaila atrašanās vietai ir tās pašas divas iespējas, kas solī 4.1:

# Tiešais .exe instalētājs:
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

Oficiālā Claude Desktop MCP dokumentācija: 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")

Aizver PowerShell pilnībā un atver jaunu logu (PATH atjaunojas tikai jaunā sesijā), pēc tam instalē Gemini CLI:

npm install -g @google/gemini-cli

Pārbaudi:

gemini --version

Ej uz https://aistudio.google.com/apikey un izveido API atslēgu.

Saglabā atslēgu kā pastāvīgu vides mainīgo:

[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "YOUR_GOOGLE_API_KEY", "User")

Aizver PowerShell un atver to no jauna. Pārbaudi:

$env:GEMINI_API_KEY

Gemini CLI konfigurācija Windows vidē atrodas šeit:

$env:USERPROFILE\.gemini\settings.json

Pārbaudi, vai mape eksistē:

Test-Path "$env:USERPROFILE\.gemini"

Ja atbilde ir False, izveido mapi:

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.gemini"

Izveido vai labo failu $env:USERPROFILE\.gemini\settings.json:

{
  "mcpServers": {
    "directo": {
      "command": "node",
      "args": [
        "C:\\Users\\YOURNAME\\directo-mcp\\directo-mcp.js"
      ],
      "env": {
        "DIRECTO_API_KEY": "$DIRECTO_API_KEY"
      }
    }
  }
}

[System.Environment]::SetEnvironmentVariable("DIRECTO_API_KEY", "YOUR_DIRECTO_API_KEY", "User")

Gemini CLI atbalsta vides mainīgo izvēršanu env vērtībās ar $VAR_NAME sintaksi — tāpēc JSON failā ir „$DIRECTO_API_KEY“, nevis pati atslēga.

Gemini CLI ir drošības funkcija Trusted Folders, kas pēc noklusējuma neļauj pievienot MCP serverus no neuzticamas mapes. Ja šī funkcija ir ieslēgta, mapei jābūt atzīmētai kā uzticamai.

Vienkāršākais veids — uzticēties serverim tieši settings.json failā, pievienojot „trust“: true directo blokam:

{
  "mcpServers": {
    "directo": {
      "command": "node",
      "args": [
        "C:\\Users\\YOURNAME\\directo-mcp\\directo-mcp.js"
      ],
      "env": {
        "DIRECTO_API_KEY": "$DIRECTO_API_KEY"
      },
      "trust": true
    }
  }
}

Alternatīva — ja Trusted Folders ir ieslēgts, Gemini CLI, pirmoreiz atverot šo mapi, parāda uzticēšanās dialogu. Tur izvēlies Trust folder. Izvēle tiek saglabāta failā ~/.gemini/trustedFolders.json un tiek prasīta tikai vienu reizi katrai mapei. Lai vēlāk mainītu uzticēšanās līmeni, CLI iekšienē izmanto komandu /permissions.

Palaid Gemini CLI:

gemini

Pārbaudi MCP savienojumu:

/mcp list

Jāparāda:

🟢 directo - Ready (32 tools)

Testa vaicājums:

Parādi visus noliktavas atlikumus

Oficiālā Gemini CLI MCP dokumentācija: geminicli.com/docs/tools/mcp-server

Žurnālfails (izmēģini abus, skat. soli 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

Abi klienti (Claude Desktop un Gemini CLI) izmanto vienus un tos pašus rīkus:

Claude Desktop:

• Lejupielādēt Claude Desktop
• Claude Desktop MCP uzstādīšana
• Pamācība: lokālie MCP serveri Claude Desktop vidē
• Oficiālā MCP dokumentācija

Gemini CLI:

• Gemini CLI dokumentācija
• Gemini CLI MCP uzstādīšana
• Google AI Studio API atslēgas
• Gemini Code Assist dokumentācija

Directo:

• Directo API dokumentācija

Vispārīgi:

• Lejupielādēt Node.js
• CredentialManager PowerShell modulis

Ātrās instalācijas skripti (skat. A ceļu, 3. nodaļa):

• directo-mcp.js — MCP serveris (32 rīki, pārbaudīts pret shēmām)
• set-directo-apikey.ps1 — API atslēgas pārvaldība (sākotnējā uzstādīšana + nomaiņa)
• install-claude-mcp.ps1 — automātiska Claude Desktop uzstādīšana
• install-gemini-mcp.ps1 — automātiska Gemini CLI uzstādīšana