User Tools

Site Tools



lt:ask_directo

Skirtumai

Čia matote skirtumus tarp pasirinktos versijos ir esamo dokumento.

Link to this comparison view

lt:ask_directo [2026/11/13 13:58] – sukurtas karolinalt:ask_directo [2026/11/13 14:09] (esamas) – Vertimas į lietuvių kalbą karolina
Linija 1: Linija 1:
-FIXME **This page is not fully translated, yet. Please help completing the translation.**\\ //(remove this paragraph once the translation is finished)//+====== DI sprendimas Ask Directo: tiesiog klauskite, o DI atsakys remdamasis jūsų Directo duomenimis ======
  
-====== AI solution Ask Directo: just ask, and the AI gives you answers based on your Directo data ======+Ask Directo sprendimas veikia MCP (Model Context Protocol) serverio pagrindu – paprastai tariant, tai nedidelė vietinė techninė pagalbinė programa, veikianti jūsų kompiuteryje. Įdiegę MCP savo kompiuteryje, leidžiate DI asistentui (Claude, Gemini) saugiai skaityti duomenis tiesiai iš jūsų Directo sistemos. Jums tereikia užduoti klausimus paprasta kalba.
  
-The Ask Directo solution is built on an MCP (Model Context Protocol) server, which, simply put, is a small local technical helper program running on your computer. By installing the MCP on your computer, you allow an AI assistant (Claude, Gemini) to securely read data directly from your Directo system. All you need to do is ask your questions in plain language.+Daugiau apie Ask Directo galimybes: [[https://directo.ee/ask-directo]].
  
-Read more about what Ask Directo can do: [[https://directo.ee/ask-directo]].+===== Directo MCP serverio diegimas – Claude Desktop ir Gemini CLI =====
  
-===== Directo MCP Server Setup - Claude Desktop and Gemini CLI =====+Šiame vadove aprašyta, kaip per vietinį MCP (Model Context Protocol) serverį prijungti Directo ERP sistemą prie DI asistento (Claude arba Gemini). Vadovas skirtas tiek Claude Desktop, tiek Gemini CLI naudotojams – bendrus žingsnius reikia atlikti tik vieną kartą, o tada pasirinkti savo DI klientui skirtą skyrių.
  
-This guide explains how to connect the Directo ERP system to an AI assistant (Claude or Gemini) through a local MCP (Model Context Protocol) server. The guide is intended for both Claude Desktop and Gemini CLI users - the shared steps only need to be done once, after which you pick the section for your AI client.+===== 1. Įvadas – kodėl MCP? =====
  
-===== 1. Introduction - why MCP? =====+==== Kas yra MCP? ====
  
-==== What is MCP? ====+MCP (Model Context Protocol) – tai atviras standartas, leidžiantis DI asistentams tiesiogiai bendrauti su išorinėmis sistemomis – duomenų bazėmis, API (programų sąsajomis) ir programomis.
  
-MCP (Model Context Protocol) is an open standard that lets AI assistants communicate directly with external systems — databases, APIs (Application Programming Interfaces), and applications.+**Be MCP** darbas su DI asistentu atrodo taip:
  
-**Without MCP**, working with an AI assistant looks like this:+  - Nukopijuojate duomenis iš Directo 
 +  - Įklijuojate juos į pokalbį su DI 
 +  - DI atsako 
 +  - Nukopijuojate atsakymą atgal į Directo
  
-  - You copy data out of Directo +**Su MCP** tai atrodo taip:
-  - You paste it into the AI conversation +
-  - The AI answers +
-  - You copy the answer back into Directo+
  
-**With MCP**, it looks like this:+  - Klausiate įprasta kalba: "Kurių prekių likutis mažesnis už minimalų?" 
 +  - DI pats pateikia užklausą Directo API (programų sąsajai) 
 +  - DI išanalizuoja duomenis ir iškart atsako
  
-  - You ask in natural language: "Which items are below minimum stock level?" +==== Kokia nauda? ====
-  - The AI queries the Directo API (Application Programming Interface) itself +
-  - The AI analyzes the data and answers immediately+
  
-==== What's the benefit? ====+^ Situacija ^ Be MCP ^ Su MCP ^ 
 +| Likučių tikrinimas | Atidaryti Directo → ieškoti → kopijuoti → įklijuoti į DI | "Kurių prekių sandėlyje liko mažiau nei 10 vnt.?" | 
 +| Sąskaitų analizė | Eksportuoti CSV → įkelti į DI → klausti | "Kurie klientai nesumokėjo per pastarąsias 90 dienų?" | 
 +| Pardavimų ataskaita | Sudaryti rankiniu būdu → kopijuoti → analizuoti | "Palygink šio mėnesio pardavimus su praėjusiais metais" | 
 +| Užsakymų sekimas | Atidaryti kelis langus → kopijuoti informaciją | "Kurie užsakymai vėluoja daugiau nei 5 dienas?" |
  
-^ Situation ^ Without MCP ^ With MCP ^ +==== Architektūra ====
-| Stock level check | Open Directo → search → copy → paste into AI | "Which items have fewer than 10 units in stock?" | +
-| Invoice analysis | Export CSV → upload to AI → ask | "Which customers haven't paid in the last 90 days?" | +
-| Sales report | Build manually → copy → analyze | "Compare this month's sales to last year" | +
-| Order tracking | Open several views → copy info | "Which orders are more than 5 days overdue?" | +
- +
-==== Architecture ====+
  
 <code> <code>
-You (natural language)+Jūs (įprasta kalba)
         ↕         ↕
-AI client (Claude Desktop or Gemini CLI) +DI klientas (Claude Desktop arba Gemini CLI) 
-        ↕  MCP protocol (local) +        ↕  MCP protokolas (vietinis) 
-MCP Server (on your computer, Node.js)+MCP serveris (jūsų kompiuteryje, Node.js)
         ↕  HTTPS         ↕  HTTPS
-Directo API (cloud)+Directo API (debesyje)
 </code> </code>
  
-The MCP server runs **on your computer**. The Directo API key never leaves your machine. The data retrieved from Directo does, however, travel onward to the AI provider's cloud so the model can read it and formulate a natural-language answer - the same as any other message content in the conversation.+MCP serveris veikia **jūsų kompiuteryje**. Directo API raktas niekada nepalieka jūsų kompiuterio. Tačiau iš Directo gauti duomenys perduodami toliau į DI paslaugų teikėjo debesį, kad modelis galėtų juos perskaityti ir suformuluoti atsakymą įprasta kalba – lygiai taip pat, kaip ir bet koks kitas pokalbio turinys.
  
 <note important> <note important>
-**Local install — important to understand:** +**Vietinis diegimas – svarbu žinoti:** 
-  * The MCP server is installed **only on your own computer** +  * MCP serveris įdiegiamas **tik jūsų kompiuteryje** 
-  * It is **not shared** — colleagues cannot access your MCP server +  * Jis **nėra bendrinamas** – kolegos negali naudotis jūsų MCP serveriu 
-  * Every user must do all the steps **themselves**, on their own computer +  * Kiekvienas naudotojas visus žingsnius turi atlikti **pats**, savo kompiuteryje 
-  * The MCP server only works while **your computer is on** and the AI client is running +  * MCP serveris veikia tik tada, kai **jūsų kompiuteris įjungtas** ir veikia DI klientas 
-  * If you want to share an MCP server across multiple users, you need a separate hosted-server solution (out of scope for this guide) +  * Jei norite, kad MCP serveriu naudotųsi keli naudotojai, reikia atskiro serveryje talpinamo sprendimo (šis vadovas jo neapima) 
-  * One API key belongs to **one Directo database**. This MCP server is tied to exactly the database the key was created in and cannot query another database (for example between a production and a test database). The AI itself does not know which database the server is connected to: if it claims to be querying another database, that is not true. The Directo address bar shows the database name (''login.directo.ee/DATABASE/...''): make sure the API key was created in the right database.+  * Vienas API raktas priklauso **vienai Directo duomenų bazei**. Šis MCP serveris susietas būtent su ta duomenų baze, kurioje raktas buvo sukurtas, ir negali teikti užklausų kitai duomenų bazei (pavyzdžiui, perjungti tarp darbinės ir testinės duomenų bazės). Pats DI nežino, prie kurios duomenų bazės prijungtas serveris: jei jis teigia, kad teikia užklausą kitai duomenų bazei, tai netiesa. Directo adreso juostoje matomas duomenų bazės pavadinimas (''login.directo.ee/DUOMENU_BAZE/...''): įsitikinkite, kad API raktas sukurtas tinkamoje duomenų bazėje.
 </note> </note>
  
-===== 2. Checking prerequisites =====+===== 2. Būtinųjų sąlygų patikrinimas =====
  
-Check every prerequisite before installing. A missing prerequisite is the most common cause of failure.+Prieš diegdami patikrinkite visas būtinąsias sąlygas. Neįvykdyta sąlyga – dažniausia nesėkmės priežastis.
  
-==== 2.1 Required for everyone ====+==== 2.1 Būtina visiems ====
  
-^ Prerequisite ^ How to check ^ Fix ^ +^ Sąlyga ^ Kaip patikrinti ^ Sprendimas ^ 
-| Windows 10 or 11 (64-bit) | Start → Settings → System → About | — | +| Windows 10 arba 11 (64 bitų) | Start → Settings → System → About | — | 
-| Node.js 22 or newer (LTS) | ''node --version'' | [[https://nodejs.org|nodejs.org]] → LTS | +| Node.js 22 arba naujesnė (LTS) | ''node --version'' | [[https://nodejs.org|nodejs.org]] → LTS | 
-| npm | ''npm --version'' (only works after execution policy is set, see below) | Comes bundled with Node.js | +| npm | ''npm --version'' (veikia tik nustačius vykdymo politiką, žr. toliau) | Įdiegiamas kartu su Node.js | 
-| PowerShell execution policy | ''Get-ExecutionPolicy'' → should return RemoteSigned | See below | +| PowerShell vykdymo politika | ''Get-ExecutionPolicy'' → turi grąžinti RemoteSigned | Žr. toliau | 
-| CredentialManager module | ''Get-Module -ListAvailable CredentialManager'' | See below | +| CredentialManager modulis | ''Get-Module -ListAvailable CredentialManager'' | Žr. toliau | 
-| Directo API key | Directo → Admin → Settings → API | Ask your Directo administrator |+| Directo API raktas | Directo → Admin → Settings → API | Kreipkitės į savo Directo administratorių |
  
-==== 2.2 Additionally for Claude Desktop users ====+==== 2.2 Papildomai Claude Desktop naudotojams ====
  
-^ Prerequisite ^ How to check ^ Link ^ +^ Sąlyga ^ Kaip patikrinti ^ Nuoroda ^ 
-| Claude Desktop installed | Claude appears in the Start menu | [[https://claude.ai/download]] | +| Įdiegta Claude Desktop | Claude matoma meniu Start | [[https://claude.ai/download]] | 
-| Anthropic account | Sign-in works | [[https://claude.ai]] |+| Anthropic paskyra | Pavyksta prisijungti | [[https://claude.ai]] |
  
-Official documentation: [[https://docs.claude.ai]]+Oficiali dokumentacija: [[https://docs.claude.ai]]
  
-==== 2.3 Additionally for Gemini CLI users ====+==== 2.3 Papildomai Gemini CLI naudotojams ====
  
 <note important> <note important>
-⚠️ **Gemini CLI no longer serves users signed in with a free Google account.** On June 18, 2026, Gemini CLI stopped serving Google AI Pro and Ultra subscribers and free (Gemini Code Assist for individuals) users, and these users have been moved to Antigravity CLI. Gemini CLI remains usable with: +⚠️ **Gemini CLI nebeaptarnauja naudotojų, prisijungusių nemokama Google paskyra.** Nuo 2026 m. birželio 18 d. Gemini CLI nebeaptarnauja Google AI Pro ir Ultra prenumeratorių bei nemokamų (Gemini Code Assist for individuals) naudotojų – jie perkelti į Antigravity CLI. Gemini CLI vis dar galima naudoti su: 
-  * **a paid Gemini API key** +  * **mokamu Gemini API raktu** 
-  * **a Gemini Code Assist Standard / Enterprise license**+  * **Gemini Code Assist Standard / Enterprise licencija**
  
-According to Google's quota page, the free (unpaid) Gemini API key is limited to 250 requests per day and Flash models only. Google's own notices about this path are contradictory, however (the quota page lists it, but a banner says "unpaid tier" users were moved to Antigravity CLI), so check that your key works with Gemini CLI before relying on it. This guide does not cover Antigravity CLI's MCP setup.+Pagal Google kvotų puslapį nemokamas (neapmokamas) Gemini API raktas ribojamas iki 250 užklausų per dieną ir tik Flash modeliais. Vis dėlto paties Google pranešimai apie šį variantą prieštaringi (kvotų puslapyje jis nurodytas, tačiau skelbime teigiama, kad "unpaid tier" naudotojai perkelti į Antigravity CLI), todėl prieš juo pasikliaudami patikrinkite, ar jūsų raktas veikia su Gemini CLI. Šiame vadove Antigravity CLI MCP nustatymas neaprašomas.
 </note> </note>
  
-^ Prerequisite ^ How to check ^ Link ^ +^ Sąlyga ^ Kaip patikrinti ^ Nuoroda ^ 
-| Google account | gmail.com access works | [[https://accounts.google.com]] | +| Google paskyra | Pavyksta prisijungti prie gmail.com | [[https://accounts.google.com]] | 
-| Google AI Studio API key | [[https://aistudio.google.com/apikey]] | Create an API key | +| Google AI Studio API raktas | [[https://aistudio.google.com/apikey]] | Sukurkite API raktą | 
-| Gemini CLI installed | ''gemini --version'' | ''npm install -g @google/gemini-cli'' |+| Įdiegta Gemini CLI | ''gemini --version'' | ''npm install -g @google/gemini-cli'' |
  
-Official documentation: [[https://geminicli.com/docs]]+Oficiali dokumentacija: [[https://geminicli.com/docs]]
  
-==== 2.4 Admin rights — when are they needed? ====+==== 2.4 Administratoriaus teisės – kada jų reikia? ====
  
 <note> <note>
-**Good news:** almost every step can be done **without** administrator rights. You genuinely need admin rights at only one point — installing Node.js.+**Gera žinia:** beveik visus žingsnius galima atlikti **be** administratoriaus teisių. Jų iš tikrųjų reikia tik vienu atveju – diegiant Node.js.
 </note> </note>
  
-^ Step ^ Admin rights? ^ Reason ^ +^ Žingsnis ^ Reikia administratoriaus teisių? ^ Priežastis ^ 
-| Installing Node.js | **Yes** — the installer requires it | System-level install (Program Files) | +| Node.js diegimas | **Taip** – to reikalauja diegimo programa | Diegiama sistemos lygiu (Program Files) | 
-| PowerShell execution policy | No | ''-Scope CurrentUser'' writes to the HKCU registry | +| PowerShell vykdymo politika | Ne | ''-Scope CurrentUser'' rašo į HKCU registrą | 
-| CredentialManager module | No | ''-Scope CurrentUser'' installs under the user's profile | +| CredentialManager modulis | Ne | ''-Scope CurrentUser'' įdiegia naudotojo profilyje | 
-| npm install (MCP server) | No | User-level install | +| npm install (MCP serveris) | Ne | Diegiama naudotojo lygiu | 
-| Claude Desktop config | No | User folders | +| Claude Desktop konfigūracija | Ne | Naudotojo aplankai | 
-| Gemini CLI config | No | User folders | +| Gemini CLI konfigūracija | Ne | Naudotojo aplankai | 
-| Saving the API key | No | Credential Manager, user-level entry |+| API rakto išsaugojimas | Ne | Credential Manager, naudotojo lygio įrašas |
  
-**Risks and an important warning:** +**Rizikos ir svarbus įspėjimas:** 
-  * Node.js installer — low risk, official software +  * Node.js diegimo programa – maža rizika, oficiali programinė įranga 
-  * **Do not open any of the other steps as administrator**, even if an earlier version of this guide or examples found online suggest it — ''-Scope CurrentUser'' exists specifically to avoid needing admin rights +  * **Jokių kitų žingsnių neatlikite kaip administratorius**, net jei taip siūlo ankstesnė šio vadovo versija ar internete rasti pavyzdžiai – ''-Scope CurrentUser'' skirtas būtent tam, kad nereikėtų administratoriaus teisių 
-  * If your everyday account and your admin rights come from **separate Windows accounts** (common in corporate/domain environments), opening something as administrator runs the action under the *other* account's profile — the module, setting, or key then "disappears" from your regular user's point of view. See the troubleshooting chapter for details. +  * Jei jūsų kasdienė paskyra ir administratoriaus teisės priklauso **skirtingoms Windows paskyroms** (įprasta įmonių / domeno aplinkose), paleidus ką nors kaip administratorius veiksmas atliekamas *kitos* paskyros profilyje – modulis, nustatymas ar raktas tada jūsų įprastam naudotojui "dingsta". Daugiau informacijos – trikčių šalinimo skyriuje. 
-  * Don't run ''npm install'' as administrator — this creates permission conflicts +  * Nevykdykite ''npm install'' kaip administratorius – tai sukelia teisių konfliktų 
-  * ''npm install -g'' (e.g. Gemini CLI, Step 5.1) only needs admin rights if npm's global prefix points at the ''Program Files'' folder — Step 5.1 includes a fix that avoids this+  * ''npm install -g'' (pvz., Gemini CLI, 5.1 žingsnis) reikalauja administratoriaus teisių tik tada, kai npm globalusis prefiksas nukreiptas į ''Program Files'' aplanką – 5.1 žingsnyje pateiktas sprendimas, kaip to išvengti
  
-===== 3. Shared steps (do once) =====+===== 3. Bendri žingsniai (atliekami vieną kartą) =====
  
 <note> <note>
-You do these steps **on your own computer**. If a colleague wants to use the same setup, they need to do these steps **on their own computer** independently.+Šiuos žingsnius atliekate **savo kompiuteryje**. Jei kolega nori naudoti tokią pačią sąranką, jis turi šiuos žingsnius atlikti **savo kompiuteryje** savarankiškai.
 </note> </note>
  
-==== Step 3.1 — Installing Node.js (required) ====+==== 3.1 žingsnis – Node.js diegimas (privaloma) ====
  
 <note important> <note important>
-This is the only step that is **required on both paths** below and cannot be automated (it needs admin rights). Do this before moving on, regardless of which path you choose.+Tai vienintelis žingsnis, **privalomas abiem toliau aprašytais būdais**, ir jo negalima automatizuoti (reikia administratoriaus teisių). Atlikite jį prieš tęsdami, nepriklausomai nuo pasirinkto būdo.
 </note> </note>
  
-  - Go to [[https://nodejs.org]] and download the **LTS** version (22 or newer) +  - Eikite į [[https://nodejs.org]] ir atsisiųskite **LTS** versiją (22 arba naujesnę) 
-  - Run the downloaded ''.msi'' file as administrator +  - Paleiskite atsisiųstą ''.msi'' failą kaip administratorius 
-  - Install with the default settings — don't change the install location+  - Diekite su numatytaisiais nustatymais – nekeiskite diegimo vietos
  
-Verify the install (regular PowerShell, not admin):+Patikrinkite diegimą (įprastas PowerShell langas, ne administratoriaus):
  
 <code powershell> <code powershell>
Linija 145: Linija 143:
 </code> </code>
  
-Expected result:+Laukiamas rezultatas:
 <code> <code>
-v22.11.0 or newer+v22.11.0 arba naujesnė
 </code> </code>
  
 <note> <note>
-We deliberately don't check ''npm --version'' here yet — npm is a PowerShell script (''npm.ps1'') and will give a ''running scripts is disabled'' error before the execution policy is set (Path A script, or Step B1), even if Node.js and npm themselves are installed correctly. This is not a bug, it's expected behavior at this stage. ''npm --version'' will work after completing Path A/B.+Čia sąmoningai dar netikriname ''npm --version'' – npm yra PowerShell scenarijus (''npm.ps1''), todėl, kol nenustatyta vykdymo politika (A būdo scenarijus arba B1 žingsnis), jis grąžins klaidą ''running scripts is disabled'', net jei pats Node.js ir npm įdiegti teisingai. Tai ne klaida, o šiame etape numatyta elgsena. ''npm --version'' veiks atlikus A arba B būdą.
 </note> </note>
  
 <note> <note>
-If PowerShell says "not recognized" — close the window and reopen it. Node.js only adds itself to PATH in new PowerShell sessions.+Jei PowerShell rašo "not recognized" – uždarykite langą ir atidarykite iš naujo. Node.js į PATH įtraukiamas tik naujose PowerShell sesijose.
 </note> </note>
  
-==== Choose your path ====+==== Pasirinkite būdą ====
  
 <note important> <note important>
-Below are **two alternative paths** to reach the same result — a working MCP server, with the API key and AI client set up. **Do only ONE of them, not both.**+Toliau pateikti **du alternatyvūs būdai** tam pačiam rezultatui pasiekti – veikiančiam MCP serveriui su nustatytu API raktu ir DI klientu. **Atlikite tik VIENĄ iš jų, ne abu.**
  
-^  ^ Path A — Scripts ^ Path B — Manual ^ +^  ^ A būdas – scenarijai ^ B būdas – rankiniu būdu ^ 
-| Time | ~5 minutes | ~20 minutes | +| Trukmė | ~5 minutės | ~20 minučių | 
-| Best for | Most users | You want to understand every step yourself, or Path A doesn't work in your environment | +| Kam tinka | Daugumai naudotojų | Norite patys suprasti kiekvieną žingsnį arba A būdas jūsų aplinkoje neveikia | 
-| Covers steps | A1—A2 | B1—B7 |+| Apima žingsnius | A1—A2 | B1—B7 |
  
-If you choose Path A and it succeeds, **skip Path B (B1—B7) entirely** — those steps describe, manually, exactly what the scripts already did for you. Path B is troubleshooting reference material, not an additional required step.+Jei pasirinkote A būdą ir jis pavyko, **B būdą (B1—B7) visiškai praleiskite** – tuose žingsniuose rankiniu būdu aprašyta lygiai tai, ką scenarijai jau atliko už jus. B būdas – tai pagalbinė medžiaga trikčių šalinimui, o ne papildomas privalomas žingsnis.
 </note> </note>
  
-==== PATH A — Quick install with scripts (recommended) ====+==== A BŪDAS – greitas diegimas scenarijais (rekomenduojama) ====
  
-**Step A1 — Downloading the files**+**A1 žingsnis – failų atsisiuntimas**
  
-Download ''directo-mcp-files.zip'' and extract it:+Atsisiųskite ''directo-mcp-files.zip'' ir išskleiskite:
  
 {{ :en:directo-mcp-files.zip |directo-mcp-files.zip}} {{ :en:directo-mcp-files.zip |directo-mcp-files.zip}}
  
 <note> <note>
-The files are attached to the wiki as a **ZIP archive**, not as individual links — DokuWiki blocks ''.js'' and ''.ps1'' file uploads by default (for security, see ''conf/mime.conf''), but ''.zip'' is allowed by default. Don't rename the files to a different extension (e.g. ''.txt'') as a "fix" — the wrong extension is exactly what causes ''MODULE_NOT_FOUND''-type errors later.+Failai prie wiki pridėti kaip **ZIP archyvas**, o ne atskiros nuorodos – DokuWiki pagal nutylėjimą blokuoja ''.js'' ir ''.ps1'' failų įkėlimą (saugumo sumetimais, žr. ''conf/mime.conf''), o ''.zip'' pagal nutylėjimą leidžiamas. Nepervadinkite failų kitu plėtiniu (pvz., ''.txt''), bandydami taip "pataisyti" – būtent netinkamas plėtinys vėliau sukelia ''MODULE_NOT_FOUND'' tipo klaidas.
 </note> </note>
  
 <note> <note>
-The scripts print all messages in English: ''[OK]'' = succeeded, ''[!]'' = needs your attention, ''[ERROR]'' = failed.+Scenarijai visus pranešimus rodo anglų kalba: ''[OK]'' = pavyko, ''[!]'' = reikia jūsų dėmesio, ''[ERROR]'' = nepavyko.
 </note> </note>
  
 <note important> <note important>
-The scripts are updated from time to time. If you already downloaded the ZIP earlier (for example an older copy sits in your Downloads folder), **always download a fresh version**. When you run a script, its first line shows a version number (for example ''v1.5''). If you don't see a version number, you have an old copy.+Scenarijai retkarčiais atnaujinami. Jei ZIP failą jau atsisiuntėte anksčiau (pavyzdžiui, senesnė kopija yra aplanke Downloads), **visada atsisiųskite naują versiją**. Paleidus scenarijų, pirmoje jo eilutėje rodomas versijos numeris (pavyzdžiui, ''v1.5''). Jei versijos numerio nematote, turite seną kopiją.
 </note> </note>
  
-Extract it (right-click the ZIP → **Extract All**, or in PowerShell):+Išskleiskite (dešiniuoju pelės mygtuku spustelėkite ZIP → **Extract All** arba PowerShell lange):
  
 <code powershell> <code powershell>
Linija 198: Linija 196:
 </code> </code>
  
-Before running the scripts, two Windows default security restrictions must be cleared — both are required, not optional:+Prieš paleidžiant scenarijus reikia panaikinti du numatytuosius Windows saugos apribojimus – abu privalomi, ne pasirinktiniai:
  
-**1) Allow running scripts in PowerShell at all:**+**1) Leiskite PowerShell aplinkoje apskritai vykdyti scenarijus:**
  
 <code powershell> <code powershell>
Linija 207: Linija 205:
  
 <note> <note>
-Without this, every following script will fail with ''running scripts is disabled on this system'' / ''UnauthorizedAccess''. ''-Scope CurrentUser'' does not require admin rights.+Be šio žingsnio visi tolesni scenarijai baigsis klaida ''running scripts is disabled on this system'' / ''UnauthorizedAccess''. ''-Scope CurrentUser'' nereikalauja administratoriaus teisių.
 </note> </note>
  
-**2) Remove Windows' "downloaded from the internet" (Mark of the Web) flag:**+**2) Pašalinkite Windows žymą "atsisiųsta iš interneto" (Mark of the Web):**
  
 <code powershell> <code powershell>
Linija 217: Linija 215:
  
 <note important> <note important>
-This is also required, not optional — files downloaded through a browser are blocked by default **even if the execution policy is already correct**. Windows tags internet-downloaded files with a separate security marker, which also carries over to files extracted from a ZIP archive — ''RemoteSigned'' requires a digital signature for such files, which our scripts don't have. Without this step you'll see ''is not digitally signed'' / ''UnauthorizedAccess'', which looks confusingly similar to the error from step 1, but has a different cause and fix.+Tai taip pat privaloma, ne pasirinktina – naršykle atsisiųsti failai pagal nutylėjimą blokuojami **net tada, kai vykdymo politika jau nustatyta teisingai**. Windows iš interneto atsisiųstus failus pažymi atskira saugos žyma, kuri perduodama ir iš ZIP archyvo išskleistiems failams – ''RemoteSigned'' tokiems failams reikalauja skaitmeninio parašo, o mūsų scenarijai jo neturi. Be šio žingsnio pamatysite ''is not digitally signed'' / ''UnauthorizedAccess'' – ši klaida klaidinamai panaši į 1 žingsnio klaidą, tačiau jos priežastis ir sprendimas kitokie.
 </note> </note>
  
-The archive contains four files: ''directo-mcp.js'' (the MCP server itself), ''set-directo-apikey.ps1'', ''install-claude-mcp.ps1'', ''install-gemini-mcp.ps1''.+Archyve yra keturi failai: ''directo-mcp.js'' (pats MCP serveris), ''set-directo-apikey.ps1'', ''install-claude-mcp.ps1'', ''install-gemini-mcp.ps1''.
  
-**Step A2 — Running the scripts**+**A2 žingsnis – scenarijų paleidimas**
  
-In the same PowerShell window (not as administrator), in the folder you just extracted: \\ +Tame pačiame PowerShell lange (ne kaip administratorius), ką tik išskleistame aplanke: \\ 
-A2.1 API key (shared by both clients, do this first)+A2.1 API raktas (bendras abiem klientams, atlikite pirmiausia)
  
 <code powershell> <code powershell>
Linija 231: Linija 229:
 </code> </code>
  
-A2.2 Pick your AI client (or both): \\+A2.2 Pasirinkite savo DI klientą (arba abu): \\
 Claude Claude
  
Linija 244: Linija 242:
 </code> </code>
  
-Each script prints a summary at the end: ''[OK]'' = done, ''[!]'' = still needs your action (for example restart Claude Desktop completely), ''[ERROR]'' = failed, with a message saying what to do.+Kiekvienas scenarijus pabaigoje pateikia santrauką: ''[OK]'' = atlikta, ''[!]'' = dar reikia jūsų veiksmų (pavyzdžiui, visiškai iš naujo paleisti Claude Desktop), ''[ERROR]'' = nepavyko, kartu su pranešimu, ką daryti.
  
 <note important> <note important>
-**If the scripts succeeded, you're done with Chapter 3.** Go straight to Chapter 4.3 (Claude Desktop) and/or Chapter 5 (Gemini CLI) — Path B (below) is not needed.+**Jei scenarijai pavyko, 3 skyrius baigtas.** Pereikite tiesiai prie 4.3 žingsnio (Claude Desktop) ir (arba) 5 skyriaus (Gemini CLI) – B būdo (žemiau) nereikia.
 </note> </note>
  
-==== PATH B — Manual, step by step (alternative to Path A) ====+==== B BŪDAS – rankiniu būdu, žingsnis po žingsnio (alternatyva A būdui) ====
  
 <note> <note>
-This is an **alternative to Path A**, not an addition to it. Only do this if the Path A scripts didn't work, or if you want to go through every step yourself. If Path A already succeeded, skip this section.+Tai **alternatyva A būdui**, o ne jo papildymas. Atlikite tai tik tada, jei A būdo scenarijai neveikė arba norite patys pereiti kiekvieną žingsnį. Jei A būdas jau pavyko, šį skyrių praleiskite.
 </note> </note>
  
-==== Step B1 — Setting the PowerShell execution policy ====+==== B1 žingsnis – PowerShell vykdymo politikos nustatymas ====
  
-Check the current setting:+Patikrinkite dabartinį nustatymą:
  
 <code powershell> <code powershell>
Linija 264: Linija 262:
 </code> </code>
  
-If the answer isn't ''RemoteSigned'', fix it in a **regular** PowerShell window (not as administrator):+Jei atsakymas nėra ''RemoteSigned'', pakeiskite jį **įprastame** PowerShell lange (ne kaip administratorius):
  
 <code powershell> <code powershell>
Linija 271: Linija 269:
  
 <note> <note>
-''-Scope CurrentUser'' writes the setting only to the ''HKEY_CURRENT_USER'' registry hive, not a machine-wide location — that's why it doesn't need admin rights. Admin rights would only be needed for ''-Scope LocalMachine'', which this guide does not use.+''-Scope CurrentUser'' įrašo nustatymą tik į ''HKEY_CURRENT_USER'' registro šaką, o ne visam kompiuteriui – todėl administratoriaus teisių nereikia. Jų reikėtų tik ''-Scope LocalMachine'' atveju, o šiame vadove jis nenaudojamas.
 </note> </note>
  
-It will ask for confirmation → press ''Y'' → Enter.+Bus paprašyta patvirtinti → paspauskite ''Y'' → Enter.
  
-==== Step B2 — CredentialManager module ====+==== B2 žingsnis – CredentialManager modulis ====
  
-Open a **regular** PowerShell window (not as administrator) — under exactly the same user account the MCP server will later run under:+Atidarykite **įprastą** PowerShell langą (ne kaip administratorius) – lygiai toje pačioje naudotojo paskyroje, kurioje vėliau veiks MCP serveris:
  
 <code powershell> <code powershell>
Linija 285: Linija 283:
  
 <note> <note>
-''-Scope CurrentUser'' exists specifically to avoid needing admin rights — the module installs under your own profile (''Documents\WindowsPowerShell\Modules''). If the command asks to confirm the NuGet provider or an "untrusted repository," answer ''Y'' — these steps don't need admin rights either.+''-Scope CurrentUser'' skirtas būtent tam, kad nereikėtų administratoriaus teisių – modulis įdiegiamas jūsų profilyje (''Documents\WindowsPowerShell\Modules''). Jei komanda prašo patvirtinti NuGet teikėją arba "untrusted repository" (nepatikimą saugyklą), atsakykite ''Y'' – šiems žingsniams administratoriaus teisių taip pat nereikia.
 </note> </note>
  
-Verify the install succeeded (in the same regular PowerShell window):+Patikrinkite, ar diegimas pavyko (tame pačiame įprastame PowerShell lange):
  
 <code powershell> <code powershell>
Linija 294: Linija 292:
 </code> </code>
  
-Should show the module's name and version.+Turi būti parodytas modulio pavadinimas ir versija.
  
 <note important> <note important>
-⚠️ If your everyday work account and your admin rights come from **separate Windows accounts** (common in corporate/domain setups), make sure this step and the later Step B7 run under **the same account** that ''node directo-mcp.js'' will later run under. A PowerShell window opened with elevation may actually run under a different account's identity, which would leave the module or API key under the wrong profile, and the later step will fail invisibly.+⚠️ Jei jūsų kasdienė darbo paskyra ir administratoriaus teisės priklauso **skirtingoms Windows paskyroms** (įprasta įmonių / domeno aplinkose), įsitikinkite, kad šis ir vėlesnis B7 žingsnis atliekami **toje pačioje paskyroje**, kurioje vėliau bus paleidžiamas ''node directo-mcp.js''. Su padidintomis teisėmis atidarytas PowerShell langas iš tikrųjų gali veikti kitos paskyros vardu – tada modulis ar API raktas atsidurs netinkamame profilyje, o vėlesnis žingsnis nepastebimai nepavyks.
 </note> </note>
  
-==== Step B3 — Creating the MCP server folder ====+==== B3 žingsnis – MCP serverio aplanko sukūrimas ====
  
-Open a regular PowerShell window (not admin) and run:+Atidarykite įprastą PowerShell langą (ne administratoriaus) ir paleiskite:
  
 <code powershell> <code powershell>
Linija 309: Linija 307:
  
 <note> <note>
-Always use the ''$env:USERPROFILE'' variable, rather than manually typing ''C:\Users\YOURNAME''. On domain-joined computers (corporate/AD environments) your actual profile folder may differ from your sign-in name — for example it may include a domain suffix (''YOURNAME.DOMAIN''). ''$env:USERPROFILE'' always gives the real, correct path, regardless.+Visada naudokite kintamąjį ''$env:USERPROFILE'', o ne rankiniu būdu rašykite ''C:\Users\YOURNAME''. Prie domeno prijungtuose kompiuteriuose (įmonių / AD aplinkose) tikrasis profilio aplankas gali skirtis nuo prisijungimo vardo – pavyzdžiui, jame gali būti domeno priesaga (''YOURNAME.DOMAIN''). ''$env:USERPROFILE'' visada grąžina tikrą, teisingą kelią.
 </note> </note>
  
-==== Step B4 — Placing directo-mcp.js ====+==== B4 žingsnis – directo-mcp.js patalpinimas ====
  
 <note important> <note important>
-This file contains all 41 tools (40 Directo API interfaces and the access-overview tool ''get_api_access''), and each tool's parameters have been checked against Directo's actual specifications. Don't copy this file manually from Notepad or any other source — always use a fresh, official copy to avoid ending up with an outdated or incorrectly-parameterized version.+Šiame faile yra visi 41 įrankis (40 Directo API sąsajų ir prieigos apžvalgos įrankis ''get_api_access''), o kiekvieno įrankio parametrai patikrinti pagal faktines Directo specifikacijas. Nekopijuokite šio failo rankiniu būdu iš Notepad ar kito šaltinio – visada naudokite naują, oficialią kopiją, kad neatsirastų pasenusi ar neteisingai parametrizuota versija.
 </note> </note>
  
-Download the ''directo-mcp.js'' file — it's included in the ''directo-mcp-files.zip'' archive linked under Path A (extract it, see Step A1) — and place it in this folder:+Atsisiųskite failą ''directo-mcp.js'' – jis yra archyve ''directo-mcp-files.zip'', į kurį nuoroda pateikta A būde (išskleiskite jį, žr. A1 žingsnį), – ir patalpinkite į šį aplanką:
  
 <code powershell> <code powershell>
Linija 324: Linija 322:
 </code> </code>
  
-The simplest way: if the file is already in the extracted Downloads subfolder, copy it in PowerShell:+Paprasčiausias būdas: jei failas jau yra išskleistame Downloads poaplankyje, nukopijuokite jį PowerShell lange:
  
 <code powershell> <code powershell>
Linija 331: Linija 329:
  
 <note important> <note important>
-Make sure the file name is exactly ''directo-mcp.js'' — not ''directo-mcp.js.txt''. Check:+Įsitikinkite, kad failo pavadinimas yra tiksliai ''directo-mcp.js'', o ne ''directo-mcp.js.txt''. Patikrinkite:
  
 <code powershell> <code powershell>
Linija 337: Linija 335:
 </code> </code>
  
-Should return ''True''. If ''False'', check the exact file name:+Turi grąžinti ''True''. Jei ''False'', patikrinkite tikslų failo pavadinimą:
  
 <code powershell> <code powershell>
Linija 344: Linija 342:
 </note> </note>
  
-==== Step B5 — Creating package.json ====+==== B5 žingsnis – package.json sukūrimas ====
  
-Open a new Notepad window and paste:+Atidarykite naują Notepad langą ir įklijuokite:
  
 <code json> <code json>
Linija 366: Linija 364:
 </code> </code>
  
-Save it in the same folder, named ''package.json'' (file type: All Files).+Išsaugokite tame pačiame aplanke pavadinimu ''package.json'' (failo tipas: All Files).
  
-==== Step B6 — Installing dependencies ====+==== B6 žingsnis – priklausomybių diegimas ====
  
-Regular PowerShell (not admin):+Įprastas PowerShell langas (ne administratoriaus):
  
 <code powershell> <code powershell>
Linija 377: Linija 375:
 </code> </code>
  
-A successful install creates a ''node_modules'' folder and a ''package-lock.json'' file in this folder.+Sėkmingai įdiegus, šiame aplanke atsiranda aplankas ''node_modules'' ir failas ''package-lock.json''.
  
 <note> <note>
-This is a **local** npm install (goes under the ''directo-mcp'' folder's own ''node_modules''), not global — it never needs admin rights or any special npm-prefix configuration, regardless of how Node.js was originally installed.+Tai **vietinis** npm diegimas (į paties ''directo-mcp'' aplanko ''node_modules''), o ne globalus – jam niekada nereikia administratoriaus teisių ar specialaus npm prefikso nustatymo, nepriklausomai nuo to, kaip buvo įdiegtas Node.js.
 </note> </note>
  
-==== Step B7 — Securely saving the API key ====+==== B7 žingsnis – saugus API rakto išsaugojimas ====
  
-The Directo API key is saved to Windows Credential Manager — encrypted, under your user account only. No one else on the computer can see this key.+Directo API raktas išsaugomas Windows Credential Manager – užšifruotas, tik jūsų naudotojo paskyroje. Niekas kitas šiame kompiuteryje šio rakto nemato.
  
 <code powershell> <code powershell>
Linija 391: Linija 389:
 </code> </code>
  
-Verify the save succeeded:+Patikrinkite, ar išsaugota sėkmingai:
  
 <code powershell> <code powershell>
Linija 397: Linija 395:
 </code> </code>
  
-Should display your API key.+Turi būti parodytas jūsų API raktas.
  
-**Rotating the API key in the future:**+**API rakto keitimas ateityje:**
  
 <code powershell> <code powershell>
Linija 407: Linija 405:
  
 <note important> <note important>
-Run this step under **exactly the same user account** that ''node directo-mcp.js'' will later run under. See the warning under Step B2 about the separate-admin-account risk.+Šį žingsnį atlikite **lygiai toje pačioje naudotojo paskyroje**, kurioje vėliau bus paleidžiamas ''node directo-mcp.js''. Žr. B2 žingsnio įspėjimą apie atskiros administratoriaus paskyros riziką.
 </note> </note>
  
 <note> <note>
-The Path A script (''set-directo-apikey.ps1'') does the same thing more securely (asks for the key without echoing it to the screen) and also works for rotation — use it if you can.+A būdo scenarijus (''set-directo-apikey.ps1'') atlieka tą patį saugiau (paprašo rakto jo nerodydamas ekrane) ir tinka rakto keitimui – jei galite, naudokite jį.
 </note> </note>
  
-===== 4. Setting up Claude Desktop =====+===== 4. Claude Desktop nustatymas =====
  
 <note> <note>
-First complete Chapter 3 (Step 3.1 + either Path A or Path B). Setting up Claude Desktop assumes the MCP server already exists.+Pirmiausia atlikite 3 skyrių (3.1 žingsnis + A arba B būdas). Nustatant Claude Desktop daroma prielaida, kad MCP serveris jau yra.
 </note> </note>
  
 <note> <note>
-The MCP server only works **on your own computer** and only inside the **Claude Desktop application** — not in the claude.ai web version, and not on other users' computers.+MCP serveris veikia tik **jūsų kompiuteryje** ir tik **Claude Desktop programoje** – ne claude.ai žiniatinklio versijoje ir ne kitų naudotojų kompiuteriuose.
 </note> </note>
  
 <note important> <note important>
-**Recommended:** if you ran the ''install-claude-mcp.ps1'' script under Path A (Chapter 3), Steps 4.1—4.2 are already done — the script detects, patches, and backs up the configuration file automatically. Go straight to Step 4.3.+**Rekomenduojama:** jei paleidote ''install-claude-mcp.ps1'' scenarijų pagal A būdą (3 skyrius), 4.1—4.2 žingsniai jau atlikti – scenarijus automatiškai suranda konfigūracijos failą, jį papildo ir padaro atsarginę kopiją. Pereikite tiesiai prie 4.3 žingsnio.
 </note> </note>
  
-==== Step 4.1 — Configuration file location ====+==== 4.1 žingsnis – konfigūracijos failo vieta ====
  
-Claude Desktop's configuration file ''claude_desktop_config.json'' is in one of four places on Windows, **depending on the version and how it was installed**. The Path A script finds the right file itself. For the manual path (Path B), find it with the steps below.+Claude Desktop konfigūracijos failas ''claude_desktop_config.json'' sistemoje Windows yra vienoje iš keturių vietų, **priklausomai nuo versijos ir diegimo būdo**. A būdo scenarijus tinkamą failą suranda pats. Diegdami rankiniu būdu (B būdas), jį surasite atlikę toliau nurodytus veiksmus.
  
-^ Variant ^ Location ^ +^ Variantas ^ Vieta ^ 
-| MSIX (claude.ai/download), data moved (Claude Desktop 3.1623 and later) | ''%LOCALAPPDATA%\Claude-Data\claude_pzs8sxrjxfjjc\'' | +| MSIX (claude.ai/download), duomenys perkelti (Claude Desktop 3.1623 ir naujesnės) | ''%LOCALAPPDATA%\Claude-Data\claude_pzs8sxrjxfjjc\'' | 
-| The same MSIX before the data move | ''%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\'' | +| Tas pats MSIX prieš duomenų perkėlimą | ''%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\'' | 
-| Microsoft Store build (not verified) | ''%LOCALAPPDATA%\Claude-Data\anthropicpbc.claude_fnn82j28hfe8t\'' | +| Microsoft Store versija (nepatikrinta) | ''%LOCALAPPDATA%\Claude-Data\anthropicpbc.claude_fnn82j28hfe8t\'' | 
-| Earlier ''.exe'' installer | ''%APPDATA%\Claude\'' |+| Ankstesnė ''.exe'' diegimo programa | ''%APPDATA%\Claude\'' |
  
 <note important> <note important>
-Newer Claude Desktop versions have moved their data from the old package folder to the ''Claude-Data'' folder. The old folder keeps only a ''.user-data-left...'' marker (on some machines also a stale ''claude_desktop_config.json''). **A file that Claude no longer reads can be edited without any error, but the change never reaches the app**, and the MCP server silently fails to load. Always use the new folder when it exists.+Naujesnės Claude Desktop versijos perkėlė savo duomenis iš senojo paketo aplanko į aplanką ''Claude-Data''. Senajame aplanke lieka tik žymė ''.user-data-left...'' (kai kuriuose kompiuteriuose ir pasenęs ''claude_desktop_config.json''). **Failą, kurio Claude nebeskaito, galima redaguoti be jokios klaidos, tačiau pakeitimas niekada nepasiekia programos**, o MCP serveris tyliai neįsikelia. Jei naujasis aplankas yra, visada naudokite jį.
 </note> </note>
  
-Show which of these files exist on your machine (regular PowerShell):+Parodykite, kurie iš šių failų yra jūsų kompiuteryje (įprastas PowerShell langas):
  
 <code powershell> <code powershell>
Linija 451: Linija 449:
 </code> </code>
  
-Use the **first** file in the list (the order is the same as in the table: newer before older). Exceptions:+Naudokite **pirmąjį** sąrašo failą (tvarka tokia pati kaip lentelėje: naujesni prieš senesnius). Išimtys:
  
-  * If the list contains a ''Packages\...'' file and the same folder also contains a ''.user-data-left...'' file, that file is stale — do not use it. +  * Jei sąraše yra failas ''Packages\...'', o tame pačiame aplanke yra ir failas ''.user-data-left...'', tas failas pasenęs – jo nenaudokite. 
-  * If the folder ''%LOCALAPPDATA%\Claude-Data\claude_pzs8sxrjxfjjc'' exists but has no ''claude_desktop_config.json'': open Claude Desktop → Settings → Developer → Edit Config (this creates the file) and run the command again. +  * Jei aplankas ''%LOCALAPPDATA%\Claude-Data\claude_pzs8sxrjxfjjc'' yra, bet jame nėra ''claude_desktop_config.json'': atidarykite Claude Desktop → Settings → Developer → Edit Config (taip failas bus sukurtas) ir paleiskite komandą dar kartą. 
-  * If the list is empty: run Claude Desktop at least once and run the command again.+  * Jei sąrašas tuščias: bent kartą paleiskite Claude Desktop ir paleiskite komandą dar kartą.
  
-==== Step 4.2 — Configuration file ====+==== 4.2 žingsnis – konfigūracijos failas ====
  
-Create a file named ''claude_desktop_config.json'' in the (correct, as identified in Step 4.1) folder.+Sukurkite failą ''claude_desktop_config.json'' (tinkamame, 4.1 žingsnyje nustatytame) aplanke.
  
 <note important> <note important>
-When creating the file with Notepad: File → Save As → file type **All Files (*.*)** → name: ''claude_desktop_config.json''+Kurdami failą su Notepad: File → Save As → failo tipas **All Files (*.*)** → pavadinimas: ''claude_desktop_config.json''
 </note> </note>
  
-File contents:+Failo turinys:
  
 <code json> <code json>
Linija 481: Linija 479:
  
 <note important> <note important>
-Replace ''YOURNAME'' with your **actual** profile folder name — not your assumed username. On domain-joined (AD) computers, the actual profile folder may differ from your sign-in name (e.g. include a domain suffix). Check the exact value:+Pakeiskite ''YOURNAME'' **tikruoju** profilio aplanko pavadinimu – ne numanomu naudotojo vardu. Prie domeno prijungtuose (AD) kompiuteriuose tikrasis profilio aplankas gali skirtis nuo prisijungimo vardo (pvz., turėti domeno priesagą). Patikrinkite tikslią reikšmę:
  
 <code powershell> <code powershell>
Linija 487: Linija 485:
 </code> </code>
  
-Use exactly what the command returns in the JSON (with double backslashes). Example for illustration — if ''$env:USERPROFILE'' returns ''C:\Users\john.user.COMPANY'', the path in the JSON should be ''C:\\Users\\john.user.COMPANY\\directo-mcp\\directo-mcp.js''. Whether or not a domain suffix (''.COMPANY'') is present depends on your own computer's setup — always use your own command's actual output, not this example.+JSON faile naudokite tiksliai tai, ką grąžina komanda (su dvigubais atgaliniais brūkšniais). Pavyzdys iliustracijai – jei ''$env:USERPROFILE'' grąžina ''C:\Users\john.user.COMPANY'', kelias JSON faile turi būti ''C:\\Users\\john.user.COMPANY\\directo-mcp\\directo-mcp.js''. Ar yra domeno priesaga (''.COMPANY''), priklauso nuo jūsų kompiuterio sąrankos – visada naudokite savo komandos faktinį rezultatą, o ne šį pavyzdį.
 </note> </note>
  
 <note> <note>
-If the file already contains other content (Claude Desktop's own settings, e.g. a ''preferences'' block) — **do not overwrite it**. ''mcpServers'' must be at the **root level** of the file, at the same level as ''preferences'', not inside it. If you're unsure about correct brace placement, use the Path A script instead, which edits the file as a structure (''ConvertFrom-Json''/''ConvertTo-Json''), not as raw text — this completely eliminates brace-placement errors.+Jei faile jau yra kito turinio (pačios Claude Desktop nustatymai, pvz., ''preferences'' blokas) – **jo neperrašykite**. ''mcpServers'' turi būti **šakniniame** failo lygyje, tame pačiame lygyje kaip ''preferences'', o ne jo viduje. Jei nesate tikri dėl teisingo skliaustų išdėstymo, verčiau naudokite A būdo scenarijų – jis failą redaguoja kaip struktūrą (''ConvertFrom-Json''/''ConvertTo-Json''), o ne kaip paprastą tekstą, todėl skliaustų išdėstymo klaidų visiškai išvengiama.
 </note> </note>
  
 <note> <note>
-The API key is **not** added to the configuration file — the server reads it automatically from Credential Manager (Path A script, or Step B7).+API raktas į konfigūracijos failą **neįrašomas** – serveris jį automatiškai nuskaito iš Credential Manager (A būdo scenarijus arba B7 žingsnis).
 </note> </note>
  
-==== Step 4.3 — Restarting Claude Desktop ====+==== 4.3 žingsnis – Claude Desktop paleidimas iš naujo ====
  
-  - Right-click the Claude icon in the **system tray** (near the clock, in the taskbar) → **Quit** / **Exit** +  - Dešiniuoju pelės mygtuku spustelėkite Claude piktogramą **sistemos dėkle** (šalia laikrodžio, užduočių juostoje) → **Quit** / **Exit** 
-  - Simply closing the window is not enough — Claude Desktop keeps running in the background +  - Vien uždaryti lango nepakanka – Claude Desktop toliau veikia fone 
-  - If Quit isn't available — open Task Manager → find the Claude process → End Task +  - Jei Quit nėra – atidarykite Task Manager → suraskite Claude procesą → End Task 
-  - Open Claude Desktop again and wait a few seconds+  - Vėl atidarykite Claude Desktop ir palaukite kelias sekundes
  
-==== Step 4.4 — Testing ====+==== 4.4 žingsnis – testavimas ====
  
-In a Claude Desktop conversation, type first:+Claude Desktop pokalbyje pirmiausia parašykite:
  
-> Which Directo interfaces are enabled on my API key?+> Kurios Directo sąsajos įjungtos mano API raktui?
  
-Claude uses the ''get_api_access'' tool and shows the list of interfaces. This query returns no Directo business data, so it is the safest first test. Then try a data query, for example:+Claude naudoja įrankį ''get_api_access'' ir parodo sąsajų sąrašą. Ši užklausa negrąžina jokių Directo verslo duomenų, todėl tai saugiausias pirmasis testas. Tada išbandykite duomenų užklausą, pavyzdžiui:
  
-> Which warehouses do I have in Directo?+> Kokie sandėliai yra mano Directo?
  
-Claude uses a suitable tool (here ''get_stocks'') and returns Directo data. Above the answer you see a gray label "Used directo integration". If the interface is not enabled on your key, Claude tells you which interface must be enabled in Directo.+Claude naudoja tinkamą įrankį (šiuo atveju ''get_stocks'') ir grąžina Directo duomenis. Virš atsakymo matysite pilką žymą "Used directo integration". Jei sąsaja jūsų raktui neįjungta, Claude nurodys, kurią sąsają reikia įjungti Directo sistemoje.
  
 <note important> <note important>
-**Claude Desktop asks for permission the first time.** The first time a new tool is used, a confirmation question appears in the Claude Desktop window (for example Allow once / Allow always). Choose ''Allow always'' if you trust the tool. If there is no answer and a "No result received" message appears after several minutes, check whether a confirmation window is open somewhere.+**Claude Desktop pirmą kartą paprašo leidimo.** Pirmą kartą naudojant naują įrankį, Claude Desktop lange pasirodo patvirtinimo klausimas (pavyzdžiui, Allow once / Allow always). Jei pasitikite įrankiu, pasirinkite ''Allow always''. Jei atsakymo nėra ir po kelių minučių pasirodo pranešimas "No result received", patikrinkite, ar kur nors neatidarytas patvirtinimo langas.
 </note> </note>
  
-Make sure the answer is data from **your database**: ask for something you know from your own Directo (for example a well-known customer or warehouse) and compare.+Įsitikinkite, kad atsakyme pateikti **jūsų duomenų bazės** duomenys: paklauskite apie tai, ką žinote iš savo Directo (pavyzdžiui, gerai žinomą klientą ar sandėlį), ir palyginkite.
  
-**Checking the logs if something doesn't work:**+**Žurnalų tikrinimas, jei kas nors neveikia:**
  
-In current Claude Desktop versions the logs are in ''%LOCALAPPDATA%\Claude\logs'':+Dabartinėse Claude Desktop versijose žurnalai yra aplanke ''%LOCALAPPDATA%\Claude\logs'':
  
 <code powershell> <code powershell>
-# Current Claude Desktop versions:+# Dabartinės Claude Desktop versijos:
 Get-Content "$env:LOCALAPPDATA\Claude\logs\mcp-server-directo.log" -Tail 30 Get-Content "$env:LOCALAPPDATA\Claude\logs\mcp-server-directo.log" -Tail 30
  
-# Earlier .exe installer:+# Ankstesnė .exe diegimo programa:
 Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" -Tail 30 Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" -Tail 30
 </code> </code>
  
-Official Claude Desktop MCP documentation: [[https://modelcontextprotocol.io/docs/develop/connect-local-servers|modelcontextprotocol.io - Connect to local MCP servers]]+Oficiali Claude Desktop MCP dokumentacija: [[https://modelcontextprotocol.io/docs/develop/connect-local-servers|modelcontextprotocol.io - Connect to local MCP servers]]
  
 <note> <note>
-The official MCP documentation still gives the old paths (''%APPDATA%\Claude\...'') for Windows. Step 4.1 of this guide describes where Claude Desktop currently keeps its files.+Oficialioje MCP dokumentacijoje Windows sistemai vis dar nurodyti senieji keliai (''%APPDATA%\Claude\...''). Šio vadovo 4.1 žingsnyje aprašyta, kur Claude Desktop dabar laiko savo failus.
 </note> </note>
  
-===== 5. Setting up Gemini CLI =====+===== 5. Gemini CLI nustatymas =====
  
 <note> <note>
-First complete Chapter 3 (Step 3.1 + either Path A or Path B). Setting up Gemini CLI assumes the MCP server already exists.+Pirmiausia atlikite 3 skyrių (3.1 žingsnis + A arba B būdas). Nustatant Gemini CLI daroma prielaida, kad MCP serveris jau yra.
 </note> </note>
  
 <note> <note>
-The MCP server only works **on your own computer**, and only inside the terminal-based Gemini CLI application — not the Gemini web version, and not on other users' computers.+MCP serveris veikia tik **jūsų kompiuteryje** ir tik terminale veikiančioje Gemini CLI programoje – ne Gemini žiniatinklio versijoje ir ne kitų naudotojų kompiuteriuose.
 </note> </note>
  
 <note important> <note important>
-⚠️ Before continuing, make sure you have valid authentication: a paid Gemini API key, a Gemini Code Assist Standard / Enterprise license, or a free API key that works with Gemini CLI. Gemini CLI no longer works with a free Google account (see Step 2.3).+⚠️ Prieš tęsdami įsitikinkite, kad turite galiojantį autentifikavimo būdą: mokamą Gemini API raktą, Gemini Code Assist Standard / Enterprise licenciją arba nemokamą API raktą, kuris veikia su Gemini CLI. Gemini CLI nebeveikia su nemokama Google paskyra (žr. 2.3 skyrių).
 </note> </note>
  
 <note important> <note important>
-**Recommended:** if you ran the ''install-gemini-mcp.ps1'' script under Path A (Chapter 3), Steps 5.1 and 5.3—5.4 are already done. Only go through Step 5.2 (Google API key — the script doesn't do this, since it's separate Google, not Directo, authentication) and Steps 5.5—5.6.+**Rekomenduojama:** jei paleidote ''install-gemini-mcp.ps1'' scenarijų pagal A būdą (3 skyrius), 5.1 ir 5.3—5.4 žingsniai jau atlikti. Atlikite tik 5.2 žingsnį (Google API raktas – scenarijus jo neatlieka, nes tai atskiras Google, o ne Directo autentifikavimas) ir 5.5—5.6 žingsnius.
 </note> </note>
  
-==== Step 5.1 — Installing Gemini CLI ====+==== 5.1 žingsnis – Gemini CLI diegimas ====
  
 <note> <note>
-This step does not need admin rights — provided npm's global install location points into your own profile. If not yet configured, do this once (regular PowerShell, not as administrator):+Šiam žingsniui administratoriaus teisių nereikia, jei npm globalaus diegimo vieta nukreipta į jūsų profilį. Jei to dar nenustatėte, atlikite tai vieną kartą (įprastas PowerShell langas, ne kaip administratorius):
 </note> </note>
  
Linija 571: Linija 569:
 </code> </code>
  
-Close PowerShell completely and open a **new** window (PATH only refreshes in a new session), then install Gemini CLI:+Visiškai uždarykite PowerShell ir atidarykite **naują** langą (PATH atnaujinamas tik naujoje sesijoje), tada įdiekite Gemini CLI:
  
 <code powershell> <code powershell>
Linija 577: Linija 575:
 </code> </code>
  
-Verify:+Patikrinkite:
  
 <code powershell> <code powershell>
Linija 584: Linija 582:
  
 <note important> <note important>
-⚠️ If the command still asks for admin rights, the likely cause is that npm's prefix was already set (e.g. by another piece of software) to point at ''C:\Program Files\...''. Check the current setting with ''npm config get prefix'' — after the step above it should show ''%APPDATA%\npm-global'', not a Program Files folder.+⚠️ Jei komanda vis tiek prašo administratoriaus teisių, tikėtina priežastis – npm prefiksas jau nustatytas (pvz., kitos programinės įrangos) taip, kad rodytų į ''C:\Program Files\...''. Dabartinį nustatymą patikrinkite komanda ''npm config get prefix'' – atlikus aukščiau nurodytą žingsnį, turi būti rodoma ''%APPDATA%\npm-global'', o ne Program Files aplankas.
 </note> </note>
  
-==== Step 5.2 — Setting up the Google API key ====+==== 5.2 žingsnis – Google API rakto nustatymas ====
  
-Go to [[https://aistudio.google.com/apikey]] and create an API key.+Eikite į [[https://aistudio.google.com/apikey]] ir sukurkite API raktą.
  
-Save the key as a persistent environment variable:+Išsaugokite raktą kaip nuolatinį aplinkos kintamąjį:
  
 <code powershell> <code powershell>
Linija 597: Linija 595:
 </code> </code>
  
-Close PowerShell and reopen it. Verify:+Uždarykite PowerShell ir atidarykite iš naujo. Patikrinkite:
  
 <code powershell> <code powershell>
Linija 603: Linija 601:
 </code> </code>
  
-==== Step 5.3 — Configuration file location ====+==== 5.3 žingsnis – konfigūracijos failo vieta ====
  
-The Gemini CLI configuration is located on Windows at:+Gemini CLI konfigūracija sistemoje Windows yra čia:
  
 <code> <code>
Linija 611: Linija 609:
 </code> </code>
  
-Check whether the folder exists:+Patikrinkite, ar aplankas yra:
  
 <code powershell> <code powershell>
Linija 617: Linija 615:
 </code> </code>
  
-If the answer is ''False'', create the folder:+Jei atsakymas ''False'', sukurkite aplanką:
  
 <code powershell> <code powershell>
Linija 623: Linija 621:
 </code> </code>
  
-==== Step 5.4 — Adding the MCP server ====+==== 5.4 žingsnis – MCP serverio pridėjimas ====
  
-Create or edit the file ''$env:USERPROFILE\.gemini\settings.json'':+Sukurkite arba redaguokite failą ''$env:USERPROFILE\.gemini\settings.json'':
  
 <code json> <code json>
Linija 644: Linija 642:
  
 <note important> <note important>
-Replace ''YOURNAME'' with your **actual** profile folder name — check the exact value with ''$env:USERPROFILE'' (see the warning under Step 4.2 on this same topic).+Pakeiskite ''YOURNAME'' **tikruoju** profilio aplanko pavadinimu – tikslią reikšmę patikrinkite komanda ''$env:USERPROFILE'' (žr. 4.2 žingsnio įspėjimą ta pačia tema).
 </note> </note>
  
 <note> <note>
-**A note on the API key logic:** ''directo-mcp.js'' reads the key from Credential Manager first (Path A script, or Step B7) — this works **exactly the same way for Gemini as for Claude Desktop**, since both run the same server file. The ''env'' block here is a **fallback**, not the only path — if Credential Manager is already set up, this block isn't strictly necessary, though it doesn't hurt either. If you do want to use it, save the value as an environment variable:+**Pastaba apie API rakto logiką:** ''directo-mcp.js'' pirmiausia nuskaito raktą iš Credential Manager (A būdo scenarijus arba B7 žingsnis) – tai veikia **lygiai taip pat Gemini ir Claude Desktop**, nes abu paleidžia tą patį serverio failą. Čia esantis ''env'' blokas yra **atsarginis variantas**, o ne vienintelis būdas – jei Credential Manager jau nustatytas, šis blokas nebūtinas, nors ir nekenkia. Jei vis dėlto norite jį naudoti, išsaugokite reikšmę kaip aplinkos kintamąjį:
  
 <code powershell> <code powershell>
Linija 654: Linija 652:
 </code> </code>
  
-Gemini CLI supports environment-variable expansion in ''env'' values using ''$VAR_NAME'' syntax — that's why the JSON contains ''"$DIRECTO_API_KEY"'', not the actual key.+Gemini CLI palaiko aplinkos kintamųjų išskleidimą ''env'' reikšmėse naudojant ''$VAR_NAME'' sintaksę – todėl JSON faile yra ''"$DIRECTO_API_KEY"'', o ne tikrasis raktas.
 </note> </note>
  
-==== Step 5.5 — Trusting the folder (Trusted Folders) ====+==== 5.5 žingsnis – pasitikėjimas aplanku (Trusted Folders) ====
  
-Gemini CLI has a security feature called **Trusted Folders**, which by default doesn't allow connecting MCP servers from an untrusted folder. If this feature is enabled, the folder needs to be trusted.+Gemini CLI turi saugos funkciją **Trusted Folders** (patikimi aplankai), kuri pagal nutylėjimą neleidžia jungti MCP serverių iš nepatikimo aplanko. Jei ši funkcija įjungta, aplanką reikia pažymėti kaip patikimą.
  
-**The simplest way** — trust the server directly in ''settings.json'', by adding ''"trust": true'' to the ''directo'' block:+**Paprasčiausias būdas** – pažymėkite serverį kaip patikimą tiesiai faile ''settings.json'', į ''directo'' bloką įtraukdami ''"trust": true'':
  
 <code json> <code json>
Linija 681: Linija 679:
  
 <note> <note>
-''"trust": true'' skips the tool-call confirmation dialogs. Only use this for servers you fully manage yourself — this Directo server is such a case.+''"trust": true'' praleidžia įrankių iškvietimo patvirtinimo langus. Naudokite tai tik serveriams, kuriuos visiškai valdote patys – šis Directo serveris kaip tik toks.
 </note> </note>
  
-**Alternative** — if Trusted Folders is enabled, Gemini CLI shows a trust dialog the first time it opens this folder. Choose **Trust folder** there. The choice is saved to ''~/.gemini/trustedFolders.json'' and is only asked once per folder. Use the ''/permissions'' command inside the CLI to change the trust level later.+**Alternatyva** – jei Trusted Folders įjungta, Gemini CLI, pirmą kartą atidarydama šį aplanką, parodo pasitikėjimo langą. Jame pasirinkite **Trust folder**. Pasirinkimas išsaugomas faile ''~/.gemini/trustedFolders.json'' ir kiekvienam aplankui klausiama tik kartą. Vėliau pasitikėjimo lygį galite pakeisti CLI viduje komanda ''/permissions''.
  
-==== Step 5.6 — Testing ====+==== 5.6 žingsnis – testavimas ====
  
-Start Gemini CLI:+Paleiskite Gemini CLI:
  
 <code powershell> <code powershell>
Linija 694: Linija 692:
 </code> </code>
  
-Check the MCP connection:+Patikrinkite MCP ryšį:
  
 <code> <code>
Linija 700: Linija 698:
 </code> </code>
  
-Should show:+Turi būti rodoma:
  
 <code> <code>
Linija 706: Linija 704:
 </code> </code>
  
-Test query: +Bandomoji užklausa: 
-> Which Directo interfaces are enabled on my API key?+> Kurios Directo sąsajos įjungtos mano API raktui?
  
-Official Gemini CLI MCP documentation: [[https://geminicli.com/docs/tools/mcp-server/|geminicli.com/docs/tools/mcp-server]]+Oficiali Gemini CLI MCP dokumentacija: [[https://geminicli.com/docs/tools/mcp-server/|geminicli.com/docs/tools/mcp-server]]
  
-===== 6. Troubleshooting =====+===== 6. Trikčių šalinimas =====
  
-==== Common errors (either client) ====+==== Dažnos klaidos (abiem klientams) ====
  
-^ Error message ^ Cause ^ Fix ^ +^ Klaidos pranešimas ^ Priežastis ^ Sprendimas ^ 
-| ''DIRECTO_API_KEY is missing'' | Credential Manager save failed, or the server runs under a different Windows account | Redo Step B7 (or Path A: ''.\set-directo-apikey.ps1'') under the same account Claude runs under | +| ''DIRECTO_API_KEY is missing'' | Nepavyko išsaugoti Credential Manager arba serveris veikia kitoje Windows paskyroje | Pakartokite B7 žingsnį (arba A būdu: ''.\set-directo-apikey.ps1'') toje pačioje paskyroje, kurioje veikia Claude | 
-| ''Unable to convert Credential object...'' / ''null-valued expression'' | The key was saved with ''cmdkey'', which is not always compatible with how the CredentialManager module reads it | Delete it with ''Remove-StoredCredential -Target DIRECTO_API_KEY'' and save it again with ''New-StoredCredential'' (Step B7) or with the Path A script | +| ''Unable to convert Credential object...'' / ''null-valued expression'' | Raktas buvo išsaugotas su ''cmdkey'', o tai ne visada suderinama su tuo, kaip jį nuskaito CredentialManager modulis | Ištrinkite jį komanda ''Remove-StoredCredential -Target DIRECTO_API_KEY'' ir išsaugokite iš naujo su ''New-StoredCredential'' (B7 žingsnis) arba A būdo scenarijumi | 
-| ''Cannot find module'' | npm install failed, OR directo-mcp.js is in the wrong folder/has the wrong name | Redo Step B6; check ''Test-Path "$env:USERPROFILE\directo-mcp\directo-mcp.js"'' | +| ''Cannot find module'' | npm install nepavyko ARBA directo-mcp.js yra netinkamame aplanke / netinkamu pavadinimu | Pakartokite B6 žingsnį; patikrinkite ''Test-Path "$env:USERPROFILE\directo-mcp\directo-mcp.js"'' | 
-| ''SyntaxError'' | directo-mcp.js file is corrupted or incomplete | Download the file again, see Step B4 (or Path A: A1) | +| ''SyntaxError'' | Failas directo-mcp.js sugadintas arba nepilnas | Atsisiųskite failą iš naujo, žr. B4 žingsnį (arba A būdą: A1) | 
-| ''The "..." interface is not enabled for this API key'' | This interface is not enabled on your API key | Ask your Directo administrator to enable the interface on the key (API Direct). Ask "Which Directo interfaces are enabled on my API key?" to see what the key allows | +| ''The "..." interface is not enabled for this API key'' | Ši sąsaja jūsų API raktui neįjungta | Paprašykite Directo administratoriaus įjungti sąsają raktui (API Direct). Paklauskite "Kurios Directo sąsajos įjungtos mano API raktui?", kad pamatytumėte, ką raktas leidžia | 
-| ''Filter "..." cannot be used ... not selected for output'' | This field is not selected for output on the key | Use another filter, or have the field added to the key's outputs | +| ''Filter "..." cannot be used ... not selected for output'' | Šis laukas rakte nepasirinktas išvedimui | Naudokite kitą filtrą arba paprašykite įtraukti lauką į rakto išvedamus laukus | 
-| ''Unknown filter name'' | Wrong filter name (names are case-sensitive) | Ask which filters the interface allows: "Which filters does the ... interface allow?" | +| ''Unknown filter name'' | Neteisingas filtro pavadinimas (skiriamos didžiosios ir mažosios raidės) | Paklauskite, kokius filtrus leidžia sąsaja: "Kokius filtrus leidžia ... sąsaja?" | 
-| ''Filter "..." has an invalid value syntax'' | The filter value has the wrong format (a date must be ISO 8601, for example 2026-01-01T00:00:00) | Claude usually corrects it itself; if needed, ask it to use the right format | +| ''Filter "..." has an invalid value syntax'' | Neteisingas filtro reikšmės formatas (data turi būti ISO 8601 formato, pavyzdžiui, 2026-01-01T00:00:00) | Claude dažniausiai ištaiso pats; jei reikia, paprašykite naudoti teisingą formatą | 
-| ''The API key is missing or invalid (401)'' | The Directo API key is wrong, expired or deleted | Check the key in Directo admin and save it again (''.\set-directo-apikey.ps1'') | +| ''The API key is missing or invalid (401)'' | Directo API raktas neteisingas, nebegalioja arba ištrintas | Patikrinkite raktą Directo administravime ir išsaugokite iš naujo (''.\set-directo-apikey.ps1'') | 
-| ''Access denied: the IP address of this computer is not allowed'' | The key has an IP restriction and your computer's address is not allowed | Ask your Directo administrator to allow the IP | +| ''Access denied: the IP address of this computer is not allowed'' | Raktui taikomas IP apribojimas, o jūsų kompiuterio adresas neleidžiamas | Paprašykite Directo administratoriaus leisti šį IP | 
-| ''Rate limit exceeded (429)'' | Too many requests | Wait a moment and try again (recommended limit: up to 60 requests per minute) | +| ''Rate limit exceeded (429)'' | Per daug užklausų | Šiek tiek palaukite ir bandykite dar kartą (rekomenduojama riba – iki 60 užklausų per minutę) | 
-| ''Directo reported a server error (5xx)'' | A temporary problem on Directo's side | Try again later; if it persists, contact Directo support | +| ''Directo reported a server error (5xx)'' | Laikina problema Directo pusėje | Bandykite vėliau; jei problema išlieka, kreipkitės į Directo pagalbą | 
-| ''running scripts is disabled'' | PowerShell execution policy | ''Set-ExecutionPolicy RemoteSigned -Scope CurrentUser'' (Step A1 or B1) | +| ''running scripts is disabled'' | PowerShell vykdymo politika | ''Set-ExecutionPolicy RemoteSigned -Scope CurrentUser'' (A1 arba B1 žingsnis) | 
-| ''is not digitally signed'' / ''UnauthorizedAccess'' | Windows Mark-of-the-Web (file downloaded via a browser) | ''Get-ChildItem <folder> -Recurse %%|%% Unblock-File'' (see Step A1) | +| ''is not digitally signed'' / ''UnauthorizedAccess'' | Windows Mark-of-the-Web (failas atsisiųstas naršykle) | ''Get-ChildItem <folder> -Recurse %%|%% Unblock-File'' (žr. A1 žingsnį) | 
-| ''npm not recognized'' | Node.js is not on PATH | Close and reopen PowerShell |+| ''npm not recognized'' | Node.js nėra PATH | Uždarykite ir vėl atidarykite PowerShell |
  
 <note> <note>
-The server's error messages are in English. Claude explains them to you in your own language.+Serverio klaidų pranešimai pateikiami anglų kalba. Claude juos paaiškina jūsų kalba.
 </note> </note>
  
  
  
-^ Problem ^ Fix ^ +^ Problema ^ Sprendimas ^ 
-| No hammer icon visible | Check the log file (see below) | +| Nematyti plaktuko piktogramos | Patikrinkite žurnalo failą (žr. toliau) | 
-| MCP server doesn't start | Check that the config file's name doesn't have a ''.txt'' extension | +| MCP serveris nepasileidžia | Patikrinkite, ar konfigūracijos failo pavadinimas neturi ''.txt'' plėtinio | 
-| Config folder is missing | Run Claude Desktop once — the folders are created automatically | +| Nėra konfigūracijos aplanko | Vieną kartą paleiskite Claude Desktop – aplankai sukuriami automatiškai | 
-| Config edited, but nothing changes | Make sure you're editing the RIGHT file — see Step 4.1 (four possible locations; in current Claude Desktop the file is in ''Claude-Data'', the old package folder is empty or stale) | +| Konfigūracija pakeista, bet niekas nesikeičia | Įsitikinkite, kad redaguojate TINKAMĄ failą – žr. 4.1 žingsnį (keturios galimos vietos; dabartinėje Claude Desktop versijoje failas yra ''Claude-Data'' aplanke, senasis paketo aplankas tuščias arba pasenęs) | 
-| No answer (after several minutes: "No result received") | Claude Desktop is waiting for you to confirm the tool use: check whether a confirmation window is open in Claude Desktop, and choose Allow once / Allow always | +| Nėra atsakymo (po kelių minučių: "No result received") | Claude Desktop laukia, kol patvirtinsite įrankio naudojimą: patikrinkite, ar Claude Desktop neatidarytas patvirtinimo langas, ir pasirinkite Allow once / Allow always | 
-| MCP disappeared after a Claude Desktop update | Claude moved its data to the new folder (Step 4.1). Check that ''claude_desktop_config.json'' in the new folder contains the ''directo-mcp.js'' line (''Select-String -Path "<file>" -Pattern "directo-mcp.js"''). If not, run the Path A script again. |+| MCP dingo atnaujinus Claude Desktop | Claude perkėlė savo duomenis į naują aplanką (4.1 žingsnis). Patikrinkite, ar naujajame aplanke esančiame ''claude_desktop_config.json'' yra eilutė su ''directo-mcp.js'' (''Select-String -Path "<failas>" -Pattern "directo-mcp.js"''). Jei ne, dar kartą paleiskite A būdo scenarijų. |
  
-Log file (current Claude Desktop versions; the second line is for the earlier .exe installer):+Žurnalo failas (dabartinės Claude Desktop versijos; antroji eilutė – ankstesnei .exe diegimo programai):
  
 <code powershell> <code powershell>
Linija 753: Linija 751:
 </code> </code>
  
-==== Gemini CLI-specific errors ====+==== Gemini CLI būdingos klaidos ====
  
-^ Problem ^ Fix ^ +^ Problema ^ Sprendimas ^ 
-| ''/mcp list'' shows Disconnected | Add ''"trust": true'' to the server config (Step 5.4), or trust the folder via the dialog / the ''/permissions'' command | +| ''/mcp list'' rodo Disconnected | Į serverio konfigūraciją įtraukite ''"trust": true'' (5.5 žingsnis) arba pažymėkite aplanką kaip patikimą dialogo lange / komanda ''/permissions'' | 
-| ''GEMINI_API_KEY'' error | Redo Step 5.2, open a new PowerShell window | +| ''GEMINI_API_KEY'' klaida | Pakartokite 5.2 žingsnį, atidarykite naują PowerShell langą | 
-| Rate limit / 429 error | Free API key request limit exceeded — wait for the limit to reset, or use a paid API key (see Step 2.3) | +| Užklausų limito / 429 klaida | Viršytas nemokamo API rakto užklausų limitas – palaukite, kol limitas atsinaujins, arba naudokite mokamą API raktą (žr. 2.3 skyrių) | 
-| Gemini CLI won't sign in with a Google account | Free Google account support ended on June 18, 2026: use a paid Gemini API key or a Gemini Code Assist license (see Step 2.3) |+| Gemini CLI neleidžia prisijungti Google paskyra | Nemokamų Google paskyrų palaikymas baigėsi 2026 m. birželio 18 d.: naudokite mokamą Gemini API raktą arba Gemini Code Assist licenciją (žr. 2.3 skyrių) |
  
-Gemini CLI diagnostics:+Gemini CLI diagnostika:
  
 <code> <code>
Linija 767: Linija 765:
 </code> </code>
  
-===== 7. MCP tools =====+===== 7. MCP įrankiai =====
  
-Both clients (Claude Desktop and Gemini CLI) use the same 41 tools (40 Directo API interfaces and the access-overview tool ''get_api_access''):+Abu klientai (Claude Desktop ir Gemini CLI) naudoja tuos pačius 41 įrankį (40 Directo API sąsajų ir prieigos apžvalgos įrankį ''get_api_access''):
  
-^ Group ^ Tools ^ +^ Grupė ^ Įrankiai ^ 
-| Sales | get_invoices, get_orders, get_sales_quotations, get_sales_contracts, get_receipts | +| Pardavimai | get_invoices, get_orders, get_sales_quotations, get_sales_contracts, get_receipts | 
-| Customers | get_customers, get_suppliers, get_contacts | +| Klientai | get_customers, get_suppliers, get_contacts | 
-| Items / stock | get_items, get_itemclasses, get_stocklevels_sn, get_stocklevels, get_allocations, get_priceformulas, get_stocks | +| Prekės / atsargos | get_items, get_itemclasses, get_stocklevels_sn, get_stocklevels, get_allocations, get_priceformulas, get_stocks | 
-| Purchasing | get_purchase_orders, get_purchase_invoices, get_purchase_payments, get_stock_receipts | +| Pirkimai | get_purchase_orders, get_purchase_invoices, get_purchase_payments, get_stock_receipts | 
-| Accounting | get_transactions, get_accounts, get_financial_budgets, get_nettings | +| Apskaita | get_transactions, get_accounts, get_financial_budgets, get_nettings | 
-| Logistics | get_deliveries, get_movements | +| Logistika | get_deliveries, get_movements | 
-| People / HR | get_users, get_absences, get_wage_calculations, get_expenses, get_approvals | +| Personalas | get_users, get_absences, get_wage_calculations, get_expenses, get_approvals | 
-| Assets | get_assets, get_customer_assets | +| Turtas | get_assets, get_customer_assets | 
-| Other | get_projects, get_objects, get_resources, get_events, get_recipes, get_replacementlogs, get_usagelogs | +| Kita | get_projects, get_objects, get_resources, get_events, get_recipes, get_replacementlogs, get_usagelogs | 
-| Sync | get_deleted | +| Sinchronizavimas | get_deleted | 
-| Access overview | get_api_access |+| Prieigos apžvalga | get_api_access |
  
-==== Good to know ====+==== Naudinga žinoti ====
  
-  * **A tool only works if its interface is enabled on your API key.** Your Directo administrator chooses which interfaces and which fields the key allows. If an interface is missing, the error message says which interface must be enabled in Directo. +  * **Įrankis veikia tik tada, kai jo sąsaja įjungta jūsų API raktui.** Directo administratorius pasirenka, kurias sąsajas ir laukus raktas leidžia. Jei sąsajos trūksta, klaidos pranešime nurodoma, kurią sąsają reikia įjungti Directo sistemoje. 
-  * **Access overview:** ask "Which Directo interfaces are enabled on my API key?". The result is saved for 1 day (file ''discovery-cache.json'' in the ''directo-mcp'' folder). If you change the key's configuration in Directo, tell Claude "Refresh the Directo access info" (or delete that file and restart Claude Desktop). Directo's overview can omit some enabled interfaces (for example ''stocklevels''), so try the tool: the real error message tells you whether access is missing. +  * **Prieigos apžvalga:** paklauskite "Kurios Directo sąsajos įjungtos mano API raktui?". Rezultatas išsaugomas 1 dienai (failas ''discovery-cache.json'' aplanke ''directo-mcp''). Jei Directo sistemoje pakeičiate rakto konfigūraciją, parašykite Claude "Atnaujink Directo prieigos informaciją" (arba ištrinkite tą failą ir iš naujo paleiskite Claude Desktop). Directo apžvalgoje kai kurios įjungtos sąsajos gali būti nerodomos (pavyzdžiui, ''stocklevels''), todėl išbandykite įrankį: tikrasis klaidos pranešimas parodys, ar trūksta prieigos. 
-  * **Stock levels:** prefer the ''get_stocklevels_sn'' tool. If that interface is not enabled on the key, use ''get_stocklevels''. +  * **Likučiai:** pirmenybę teikite įrankiui ''get_stocklevels_sn''. Jei ši sąsaja raktui neįjungta, naudokite ''get_stocklevels''. 
-  * **Filters:** every data tool has the usual filters (for example date, customer, status) plus a free-form filter that lets the AI use any field enabled on the key (including row fields). Only fields selected for output on the key can be filtered. +  * **Filtrai:** kiekvienas duomenų įrankis turi įprastus filtrus (pavyzdžiui, data, klientas, būsena) ir laisvos formos filtrą, leidžiantį DI naudoti bet kurį raktui įjungtą lauką (įskaitant eilučių laukus). Filtruoti galima tik pagal laukus, kurie rakte pasirinkti išvedimui. 
-  * **Result size:** the start of every answer shows the number of matches and the size. If it says "LARGE" or "TOO LARGE", narrow the query (ideally up to 1 month at a time). A very large answer may not fit in the AI's memory and totals may end up incomplete. +  * **Rezultato dydis:** kiekvieno atsakymo pradžioje rodomas atitikmenų skaičius ir dydis. Jei rašoma "LARGE" arba "TOO LARGE", susiaurinkite užklausą (geriausia – iki 1 mėnesio vienu kartu). Labai didelis atsakymas gali netilpti į DI atmintį, o sumos gali būti nepilnos. 
-  * **Sensitive data:** the people, payroll, expense and usage-log tools (''get_wage_calculations'', ''get_absences'', ''get_expenses'', ''get_approvals'', ''get_usagelogs'') work if the matching interfaces are enabled on your key. The key owner decides, and is responsible for, whether these are opened to the AI.+  * **Jautrūs duomenys:** personalo, darbo užmokesčio, išlaidų ir naudojimo žurnalų įrankiai (''get_wage_calculations'', ''get_absences'', ''get_expenses'', ''get_approvals'', ''get_usagelogs'') veikia, jei atitinkamos sąsajos įjungtos jūsų raktui. Rakto savininkas sprendžia ir atsako, ar jie atveriami DI.
  
-===== 8. Security =====+===== 8. Saugumas =====
  
-^ Measure ^ Explanation ^ +^ Priemonė ^ Paaiškinimas ^ 
-| Credential Manager (both clients) | The API key is encrypted and visible only to your Windows account — Claude and Gemini read the same entry | +| Credential Manager (abu klientai) | API raktas užšifruotas ir matomas tik jūsų Windows paskyrai – Claude ir Gemini nuskaito tą patį įrašą | 
-| Environment variable (Gemini fallback) | If Credential Manager is set up, the ''env'' block isn't strictly necessary — see the note under Step 5.4 | +| Aplinkos kintamasis (atsarginis Gemini variantas) | Jei Credential Manager nustatytas, ''env'' blokas nebūtinas – žr. 5.4 žingsnio pastabą | 
-| Local server | The MCP server only runs on your computer, it is not publicly reachable | +| Vietinis serveris | MCP serveris veikia tik jūsų kompiuteryje, jis nepasiekiamas viešai | 
-| Data to the AI provider | Query results are sent to the AI provider's cloud so the model can answer them. The API key never leaves your computer. | +| Duomenys DI paslaugų teikėjui | Užklausų rezultatai siunčiami į DI paslaugų teikėjo debesį, kad modelis galėtų atsakyti. API raktas niekada nepalieka jūsų kompiuterio. | 
-| Minimal permissions | Restrict the Directo API key's permissions to only the interfaces and fields you need (including people and payroll data) | +| Minimalios teisės | Apribokite Directo API rakto teises tik būtinomis sąsajomis ir laukais (įskaitant personalo ir darbo užmokesčio duomenis) | 
-| Access-overview cache | The file ''discovery-cache.json'' (in the ''directo-mcp'' folder) contains only interface and field names, not data, and is tied to your key | +| Prieigos apžvalgos podėlis | Faile ''discovery-cache.json'' (aplanke ''directo-mcp'') yra tik sąsajų ir laukų pavadinimai, ne duomenys, ir jis susietas su jūsų raktu | 
-| OneDrive/Dropbox | Exclude the ''directo-mcp'' folder from cloud sync | +| OneDrive/Dropbox | Neįtraukite ''directo-mcp'' aplanko į sinchronizavimą su debesimi | 
-| Admin rights | Only for installing Node.js (Step 3.1) — a shared prerequisite for both paths — everything else, including the CredentialManager module, runs under ''-Scope CurrentUser'' without admin rights (see 2.4) |+| Administratoriaus teisės | Tik Node.js diegimui (3.1 žingsnis) – bendrai abiejų būdų sąlygai – visa kita, įskaitant CredentialManager modulį, atliekama su ''-Scope CurrentUser'' be administratoriaus teisių (žr. 2.4) |
  
-===== 9. Updating and versions =====+===== 9. Atnaujinimas ir versijos =====
  
-==== Which version am I running? ====+==== Kurią versiją naudoju? ====
  
-The MCP server version is in the server's start-up line in the log (''Directo MCP server v... started (N tools)''):+MCP serverio versija nurodyta serverio paleidimo eilutėje žurnale (''Directo MCP server v... started (N tools)''):
  
 <code powershell> <code powershell>
Linija 815: Linija 813:
 </code> </code>
  
-The scripts' version is visible on their first line when you run them (for example ''v1.5'').+Scenarijų versija matoma pirmoje jų eilutėje, kai juos paleidžiate (pavyzdžiui, ''v1.5'').
  
-==== How to update ====+==== Kaip atnaujinti ====
  
-  - Download a **fresh** ZIP (see Step A1), extract it and open PowerShell in the extracted folder. +  - Atsisiųskite **naują** ZIP (žr. A1 žingsnį), išskleiskite jį ir atidarykite PowerShell išskleistame aplanke. 
-  - Copy the new ''directo-mcp.js'' over the old one (command below). +  - Nukopijuokite naująjį ''directo-mcp.js'' vietoj senojo (komanda toliau). 
-  - Close Claude Desktop **completely** (Step 4.3) or Gemini CLI and open it again. +  - **Visiškai** uždarykite Claude Desktop (4.3 žingsnis) arba Gemini CLI ir atidarykite iš naujo. 
-  - Check the version in the log (see above).+  - Patikrinkite versiją žurnale (žr. aukščiau).
  
-Copy command:+Kopijavimo komanda:
  
 <code powershell> <code powershell>
Linija 831: Linija 829:
  
 <note> <note>
-The new ''directo-mcp.js'' needs no new dependencies, so ''npm install'' is not needed. Running the install scripts again does **not** update the server file: the script copies ''directo-mcp.js'' only if it is not in the folder yet.+Naujajam ''directo-mcp.js'' naujų priklausomybių nereikia, todėl ''npm install'' vykdyti nereikia. Pakartotinai paleidus diegimo scenarijus serverio failas **neatnaujinamas**: scenarijus nukopijuoja ''directo-mcp.js'' tik tada, jei jo aplanke dar nėra.
 </note> </note>
  
-===== 10. References =====+===== 10. Nuorodos =====
  
 **Claude Desktop:** **Claude Desktop:**
-  * [[https://claude.ai/download|Download Claude Desktop]] +  * [[https://claude.ai/download|Atsisiųsti Claude Desktop]] 
-  * [[https://modelcontextprotocol.io/docs/develop/connect-local-servers|Claude Desktop MCP setup]] +  * [[https://modelcontextprotocol.io/docs/develop/connect-local-servers|Claude Desktop MCP nustatymas]] 
-  * [[https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop|Guide: local MCP servers on Claude Desktop]] +  * [[https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop|Vadovas: vietiniai MCP serveriai Claude Desktop programoje]] 
-  * [[https://downloads.claude.ai/releases/enterprise/intune/Claude-Intune-README.md|Claude Desktop data folders on Windows (Anthropic)]] +  * [[https://downloads.claude.ai/releases/enterprise/intune/Claude-Intune-README.md|Claude Desktop duomenų aplankai Windows sistemoje (Anthropic)]] 
-  * [[https://modelcontextprotocol.io|Official MCP documentation]]+  * [[https://modelcontextprotocol.io|Oficiali MCP dokumentacija]]
  
 **Gemini CLI:** **Gemini CLI:**
-  * [[https://geminicli.com/docs|Gemini CLI documentation]] +  * [[https://geminicli.com/docs|Gemini CLI dokumentacija]] 
-  * [[https://geminicli.com/docs/tools/mcp-server/|Gemini CLI MCP setup]] +  * [[https://geminicli.com/docs/tools/mcp-server/|Gemini CLI MCP nustatymas]] 
-  * [[https://geminicli.com/docs/resources/quota-and-pricing/|Gemini CLI quotas and pricing]] +  * [[https://geminicli.com/docs/resources/quota-and-pricing/|Gemini CLI kvotos ir kainos]] 
-  * [[https://github.com/google-gemini/gemini-cli/discussions/28017|Gemini CLI transition to Antigravity CLI (announcement)]] +  * [[https://github.com/google-gemini/gemini-cli/discussions/28017|Gemini CLI perėjimas prie Antigravity CLI (pranešimas)]] 
-  * [[https://aistudio.google.com/apikey|Google AI Studio API keys]] +  * [[https://aistudio.google.com/apikey|Google AI Studio API raktai]] 
-  * [[https://developers.google.com/gemini-code-assist/docs/gemini-cli|Gemini Code Assist documentation]]+  * [[https://developers.google.com/gemini-code-assist/docs/gemini-cli|Gemini Code Assist dokumentacija]]
  
 **Directo:** **Directo:**
-  * [[https://wiki.directo.ee/et/api_direct|Directo API documentation]]+  * [[https://wiki.directo.ee/et/api_direct|Directo API dokumentacija]]
  
-**General:** +**Bendra:** 
-  * [[https://nodejs.org|Download Node.js]] +  * [[https://nodejs.org|Atsisiųsti Node.js]] 
-  * [[https://www.powershellgallery.com/packages/CredentialManager|CredentialManager PowerShell module]]+  * [[https://www.powershellgallery.com/packages/CredentialManager|CredentialManager PowerShell modulis]]
  
-**Quick-install scripts** (see Path A, Chapter 3): +**Greito diegimo scenarijai** (žr. A būdą, 3 skyrių): 
-  * ''directo-mcp.js'' — MCP server (41 tools) +  * ''directo-mcp.js'' – MCP serveris (41 įrankis) 
-  * ''set-directo-apikey.ps1'' — API key management (initial setup + rotation) +  * ''set-directo-apikey.ps1'' – API rakto valdymas (pradinis nustatymas + keitimas) 
-  * ''install-claude-mcp.ps1'' — automatic Claude Desktop install +  * ''install-claude-mcp.ps1'' – automatinis Claude Desktop diegimas 
-  * ''install-gemini-mcp.ps1'' — automatic Gemini CLI install+  * ''install-gemini-mcp.ps1'' – automatinis Gemini CLI diegimas
lt/ask_directo.txt · Keista: 2026/11/13 14:09 vartotojo karolina

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki