lt:ask_directo
Skirtumai
Čia matote skirtumus tarp pasirinktos versijos ir esamo dokumento.
| lt:ask_directo [2026/11/13 13:58] – sukurtas karolina | lt: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 |
| - | The Ask Directo | + | Daugiau apie Ask Directo |
| - | Read more about what Ask Directo | + | ===== Directo |
| - | ===== Directo | + | Šiame vadove aprašyta, kaip per vietinį |
| - | 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 |
| - | ===== 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), | + | **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: " |
| + | - 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 | " | ||
| + | | 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 | " | ||
| + | | 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' | + | |
| - | | Sales report | Build manually → copy → analyze | " | + | |
| - | | Order tracking | Open several views → copy info | "Which orders are more than 5 days overdue?" | + | |
| - | + | ||
| - | ==== Architecture | + | |
| < | < | ||
| - | You (natural language) | + | Jūs (įprasta kalba) |
| ↕ | ↕ | ||
| - | AI client | + | DI klientas |
| - | ↕ MCP protocol | + | ↕ MCP protokolas |
| - | MCP Server | + | MCP serveris |
| ↕ HTTPS | ↕ HTTPS | ||
| - | Directo API (cloud) | + | Directo API (debesyje) |
| </ | </ | ||
| - | The MCP server runs **on your computer**. The Directo API key never leaves your machine. The data retrieved from Directo | + | MCP serveris veikia |
| <note important> | <note important> | ||
| - | **Local install — important to understand:** | + | **Vietinis diegimas – svarbu žinoti:** |
| - | * The MCP server is installed | + | * MCP serveris įdiegiamas |
| - | * It is **not shared** — colleagues cannot access your MCP server | + | * Jis **nėra bendrinamas** – kolegos negali naudotis jūsų |
| - | * Every user must do all the steps **themselves**, on their own computer | + | * Kiekvienas naudotojas visus žingsnius turi atlikti |
| - | * 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 | + | * Jei norite, kad MCP serveriu naudotųsi keli naudotojai, reikia atskiro serveryje talpinamo sprendimo |
| - | * One API key belongs to **one Directo | + | * Vienas |
| </ | </ | ||
| - | ===== 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 | + | ^ Sąlyga |
| - | | 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.js 22 arba naujesnė |
| - | | npm | '' | + | | npm | '' |
| - | | PowerShell | + | | PowerShell |
| - | | CredentialManager | + | | CredentialManager |
| - | | Directo API key | Directo → Admin → Settings → API | Ask your Directo | + | | Directo API raktas |
| - | ==== 2.2 Additionally for Claude Desktop | + | ==== 2.2 Papildomai |
| - | ^ Prerequisite | + | ^ Sąlyga |
| - | | Claude Desktop | + | | Įdiegta |
| - | | Anthropic | + | | Anthropic |
| - | Official documentation: [[https:// | + | Oficiali dokumentacija: [[https:// |
| - | ==== 2.3 Additionally for Gemini CLI users ==== | + | ==== 2.3 Papildomai |
| <note important> | <note important> | ||
| - | ⚠️ **Gemini CLI no longer serves users signed in with a free Google | + | ⚠️ **Gemini CLI nebeaptarnauja naudotojų, prisijungusių nemokama |
| - | * **a paid Gemini API key** | + | * **mokamu |
| - | * **a Gemini Code Assist Standard / Enterprise | + | * **Gemini Code Assist Standard / Enterprise |
| - | According to Google's quota page, the free (unpaid) Gemini API key is limited to 250 requests | + | Pagal Google |
| </ | </ | ||
| - | ^ Prerequisite | + | ^ Sąlyga |
| - | | Google | + | | Google |
| - | | Google AI Studio API key | [[https:// | + | | Google AI Studio API raktas |
| - | | Gemini CLI installed | + | | Įdiegta |
| - | Official documentation: [[https:// | + | Oficiali dokumentacija: [[https:// |
| - | ==== 2.4 Admin rights — when are they needed? ==== | + | ==== 2.4 Administratoriaus teisės – kada jų reikia? ==== |
| < | < | ||
| - | **Good news:** almost every step can be done **without** administrator rights. You genuinely need admin rights at only one point — installing | + | **Gera žinia:** beveik visus žingsnius galima atlikti |
| </ | </ | ||
| - | ^ Step ^ Admin rights? ^ Reason | + | ^ Žingsnis |
| - | | Installing | + | | Node.js |
| - | | PowerShell | + | | PowerShell |
| - | | CredentialManager | + | | CredentialManager |
| - | | npm install (MCP server) | No | User-level install | + | | npm install (MCP serveris) | Ne | Diegiama naudotojo lygiu | |
| - | | Claude Desktop | + | | Claude Desktop |
| - | | Gemini CLI config | + | | Gemini CLI konfigūracija |
| - | | Saving the API key | No | Credential Manager, | + | | API rakto išsaugojimas |
| - | **Risks and an important warning:** | + | **Rizikos ir svarbus įspėjimas:** |
| - | * Node.js | + | * Node.js |
| - | * **Do not open any of the other steps as administrator**, even if an earlier version of this guide or examples found online suggest it — '' | + | * **Jokių kitų žingsnių neatlikite kaip administratorius**, net jei taip siūlo ankstesnė šio vadovo versija ar internete rasti pavyzdžiai – '' |
| - | * If your everyday account and your admin rights come from **separate | + | * Jei jūsų kasdienė paskyra ir administratoriaus teisės priklauso |
| - | * Don't run '' | + | * Nevykdykite |
| - | * '' | + | * '' |
| - | ===== 3. Shared steps (do once) ===== | + | ===== 3. Bendri žingsniai |
| < | < | ||
| - | 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 |
| </ | </ | ||
| - | ==== Step 3.1 — Installing | + | ==== 3.1 žingsnis – Node.js |
| <note important> | <note important> | ||
| - | This is the only step that is **required on both paths** below and cannot be automated | + | Tai vienintelis žingsnis, |
| </ | </ | ||
| - | - Go to [[https:// | + | - Eikite į [[https:// |
| - | - Run the downloaded | + | - Paleiskite atsisiųstą |
| - | - Install with the default settings — don't change the install location | + | - Diekite su numatytaisiais nustatymais – nekeiskite diegimo vietos |
| - | Verify the install | + | Patikrinkite diegimą |
| <code powershell> | <code powershell> | ||
| Linija 145: | Linija 143: | ||
| </ | </ | ||
| - | Expected result: | + | Laukiamas rezultatas: |
| < | < | ||
| - | v22.11.0 | + | v22.11.0 |
| </ | </ | ||
| < | < | ||
| - | We deliberately don't check '' | + | Čia sąmoningai dar netikriname |
| </ | </ | ||
| < | < | ||
| - | If PowerShell | + | Jei PowerShell |
| </ | </ | ||
| - | ==== Choose your path ==== | + | ==== Pasirinkite būdą |
| <note important> | <note important> | ||
| - | Below are **two alternative paths** to reach the same result — a working | + | Toliau pateikti |
| - | ^ ^ Path A — Scripts | + | ^ ^ A būdas – scenarijai |
| - | | Time | ~5 minutes | + | | Trukmė |
| - | | Best for | Most users | You want to understand every step yourself, or Path A doesn' | + | | Kam tinka | Daugumai naudotojų |
| - | | Covers steps | A1—A2 | B1—B7 | | + | | Apima žingsnius |
| - | If you choose Path A and it succeeds, **skip Path B (B1—B7) | + | Jei pasirinkote |
| </ | </ | ||
| - | ==== PATH A — Quick install with scripts | + | ==== A BŪDAS – greitas diegimas scenarijais |
| - | **Step A1 — Downloading the files** | + | **A1 žingsnis – failų atsisiuntimas** |
| - | Download | + | Atsisiųskite |
| {{ : | {{ : | ||
| < | < | ||
| - | The files are attached to the wiki as a **ZIP archive**, not as individual links — DokuWiki | + | Failai prie wiki pridėti kaip **ZIP archyvas**, o ne atskiros nuorodos – DokuWiki |
| </ | </ | ||
| < | < | ||
| - | The scripts print all messages in English: '' | + | Scenarijai visus pranešimus rodo anglų kalba: '' |
| </ | </ | ||
| <note important> | <note important> | ||
| - | The scripts are updated from time to time. If you already downloaded the ZIP earlier | + | Scenarijai retkarčiais atnaujinami. Jei ZIP failą jau atsisiuntėte anksčiau |
| </ | </ | ||
| - | Extract it (right-click the ZIP → **Extract All**, or in PowerShell): | + | Išskleiskite |
| <code powershell> | <code powershell> | ||
| Linija 198: | Linija 196: | ||
| </ | </ | ||
| - | Before running the scripts, two Windows | + | Prieš paleidžiant scenarijus reikia panaikinti du numatytuosius |
| - | **1) Allow running scripts in PowerShell | + | **1) Leiskite |
| <code powershell> | <code powershell> | ||
| Linija 207: | Linija 205: | ||
| < | < | ||
| - | Without this, every following script will fail with '' | + | Be šio žingsnio visi tolesni scenarijai baigsis klaida |
| </ | </ | ||
| - | **2) Remove | + | **2) Pašalinkite |
| <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 | + | Tai taip pat privaloma, ne pasirinktina – naršykle atsisiųsti failai pagal nutylėjimą blokuojami |
| </ | </ | ||
| - | The archive contains four files: '' | + | Archyve yra keturi failai: '' |
| - | **Step A2 — Running the scripts** | + | **A2 žingsnis – scenarijų paleidimas** |
| - | In the same PowerShell | + | Tame pačiame |
| - | A2.1 API key (shared by both clients, do this first) | + | A2.1 API raktas |
| <code powershell> | <code powershell> | ||
| Linija 231: | Linija 229: | ||
| </ | </ | ||
| - | A2.2 Pick your AI client | + | A2.2 Pasirinkite savo DI klientą |
| Claude | Claude | ||
| Linija 244: | Linija 242: | ||
| </ | </ | ||
| - | Each script prints a summary at the end: '' | + | Kiekvienas scenarijus pabaigoje pateikia santrauką: '' |
| <note important> | <note important> | ||
| - | **If the scripts succeeded, you're done with Chapter | + | **Jei scenarijai pavyko, 3 skyrius baigtas.** Pereikite tiesiai prie 4.3 žingsnio |
| </ | </ | ||
| - | ==== PATH B — Manual, step by step (alternative to Path A) ==== | + | ==== B BŪDAS – rankiniu būdu, žingsnis po žingsnio |
| < | < | ||
| - | 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 |
| </ | </ | ||
| - | ==== Step B1 — Setting the PowerShell | + | ==== B1 žingsnis – PowerShell |
| - | Check the current setting: | + | Patikrinkite dabartinį nustatymą: |
| <code powershell> | <code powershell> | ||
| Linija 264: | Linija 262: | ||
| </ | </ | ||
| - | If the answer isn' | + | Jei atsakymas nėra '' |
| <code powershell> | <code powershell> | ||
| Linija 271: | Linija 269: | ||
| < | < | ||
| - | '' | + | '' |
| </ | </ | ||
| - | It will ask for confirmation | + | Bus paprašyta patvirtinti |
| - | ==== Step B2 — CredentialManager | + | ==== B2 žingsnis – CredentialManager |
| - | Open a **regular** PowerShell | + | Atidarykite |
| <code powershell> | <code powershell> | ||
| Linija 285: | Linija 283: | ||
| < | < | ||
| - | '' | + | '' |
| </ | </ | ||
| - | Verify the install succeeded | + | Patikrinkite, |
| <code powershell> | <code powershell> | ||
| Linija 294: | Linija 292: | ||
| </ | </ | ||
| - | Should show the module' | + | Turi būti parodytas modulio pavadinimas ir versija. |
| <note important> | <note important> | ||
| - | ⚠️ | + | ⚠️ |
| </ | </ | ||
| - | ==== Step B3 — Creating the MCP server folder | + | ==== B3 žingsnis – MCP serverio aplanko sukūrimas |
| - | Open a regular | + | Atidarykite įprastą |
| <code powershell> | <code powershell> | ||
| Linija 309: | Linija 307: | ||
| < | < | ||
| - | Always use the '' | + | Visada naudokite kintamąjį |
| </ | </ | ||
| - | ==== Step B4 — Placing | + | ==== B4 žingsnis – directo-mcp.js |
| <note important> | <note important> | ||
| - | This file contains all 41 tools (40 Directo API interfaces and the access-overview tool '' | + | Šiame faile yra visi 41 įrankis |
| </ | </ | ||
| - | Download the '' | + | Atsisiųskite failą |
| <code powershell> | <code powershell> | ||
| Linija 324: | Linija 322: | ||
| </ | </ | ||
| - | The simplest way: if the file is already in the extracted | + | Paprasčiausias būdas: jei failas jau yra išskleistame |
| <code powershell> | <code powershell> | ||
| Linija 331: | Linija 329: | ||
| <note important> | <note important> | ||
| - | Make sure the file name is exactly | + | Įsitikinkite, |
| <code powershell> | <code powershell> | ||
| Linija 337: | Linija 335: | ||
| </ | </ | ||
| - | Should return | + | Turi grąžinti |
| <code powershell> | <code powershell> | ||
| Linija 344: | Linija 342: | ||
| </ | </ | ||
| - | ==== Step B5 — Creating | + | ==== B5 žingsnis – package.json |
| - | Open a new Notepad | + | Atidarykite naują |
| <code json> | <code json> | ||
| Linija 366: | Linija 364: | ||
| </ | </ | ||
| - | Save it in the same folder, named '' | + | Išsaugokite tame pačiame aplanke pavadinimu |
| - | ==== Step B6 — Installing dependencies | + | ==== B6 žingsnis – priklausomybių diegimas |
| - | Regular | + | Įprastas |
| <code powershell> | <code powershell> | ||
| Linija 377: | Linija 375: | ||
| </ | </ | ||
| - | A successful install creates a '' | + | Sėkmingai įdiegus, šiame aplanke atsiranda aplankas |
| < | < | ||
| - | This is a **local** npm install | + | Tai **vietinis** npm diegimas |
| </ | </ | ||
| - | ==== Step B7 — Securely saving the API key ==== | + | ==== B7 žingsnis – saugus |
| - | The Directo API key is saved to Windows Credential Manager | + | Directo API raktas išsaugomas |
| <code powershell> | <code powershell> | ||
| Linija 391: | Linija 389: | ||
| </ | </ | ||
| - | Verify the save succeeded: | + | Patikrinkite, |
| <code powershell> | <code powershell> | ||
| Linija 397: | Linija 395: | ||
| </ | </ | ||
| - | Should display your API key. | + | Turi būti parodytas jūsų |
| - | **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 '' | + | Šį žingsnį atlikite |
| </ | </ | ||
| < | < | ||
| - | The Path A script | + | A būdo scenarijus |
| </ | </ | ||
| - | ===== 4. Setting up Claude Desktop ===== | + | ===== 4. Claude Desktop |
| < | < | ||
| - | First complete Chapter | + | Pirmiausia atlikite |
| </ | </ | ||
| < | < | ||
| - | The MCP server only works **on your own computer** and only inside the **Claude Desktop | + | MCP serveris veikia tik **jūsų kompiuteryje** ir tik **Claude Desktop |
| </ | </ | ||
| <note important> | <note important> | ||
| - | **Recommended:** if you ran the '' | + | **Rekomenduojama:** jei paleidote |
| </ | </ | ||
| - | ==== Step 4.1 — Configuration file location | + | ==== 4.1 žingsnis – konfigūracijos failo vieta ==== |
| - | Claude Desktop's configuration file '' | + | Claude Desktop |
| - | ^ Variant | + | ^ Variantas |
| - | | MSIX (claude.ai/ | + | | MSIX (claude.ai/ |
| - | | The same MSIX before the data move | '' | + | | Tas pats MSIX prieš duomenų perkėlimą |
| - | | Microsoft Store build (not verified) | '' | + | | Microsoft Store versija |
| - | | Earlier | + | | Ankstesnė |
| <note important> | <note important> | ||
| - | Newer Claude Desktop | + | Naujesnės |
| </ | </ | ||
| - | Show which of these files exist on your machine | + | Parodykite, kurie iš šių failų yra jūsų kompiuteryje |
| <code powershell> | <code powershell> | ||
| Linija 451: | Linija 449: | ||
| </ | </ | ||
| - | Use the **first** file in the list (the order is the same as in the table: newer before older). Exceptions: | + | Naudokite |
| - | * If the list contains a '' | + | * Jei sąraše yra failas |
| - | * If the folder | + | * Jei aplankas |
| - | * If the list is empty: run Claude Desktop | + | * Jei sąrašas tuščias: bent kartą paleiskite |
| - | ==== Step 4.2 — Configuration file ==== | + | ==== 4.2 žingsnis – konfigūracijos failas |
| - | Create a file named '' | + | Sukurkite failą |
| <note important> | <note important> | ||
| - | When creating the file with Notepad: File → Save As → file type **All Files (*.*)** → name: '' | + | Kurdami failą su Notepad: File → Save As → failo tipas **All Files (*.*)** → pavadinimas: '' |
| </ | </ | ||
| - | File contents: | + | Failo turinys: |
| <code json> | <code json> | ||
| Linija 481: | Linija 479: | ||
| <note important> | <note important> | ||
| - | Replace | + | Pakeiskite |
| <code powershell> | <code powershell> | ||
| Linija 487: | Linija 485: | ||
| </ | </ | ||
| - | Use exactly what the command returns in the JSON (with double backslashes). Example for illustration — if '' | + | JSON faile naudokite tiksliai tai, ką grąžina komanda |
| </ | </ | ||
| < | < | ||
| - | If the file already contains other content | + | Jei faile jau yra kito turinio |
| </ | </ | ||
| < | < | ||
| - | 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ą |
| </ | </ | ||
| - | ==== Step 4.3 — Restarting | + | ==== 4.3 žingsnis – Claude Desktop |
| - | - Right-click the Claude | + | - Dešiniuoju pelės mygtuku spustelėkite |
| - | - Simply closing the window is not enough — Claude Desktop | + | - Vien uždaryti lango nepakanka – Claude Desktop |
| - | - If Quit isn't available — open Task Manager → find the Claude | + | - Jei Quit nėra – atidarykite |
| - | - Open Claude Desktop | + | - Vėl atidarykite |
| - | ==== Step 4.4 — Testing | + | ==== 4.4 žingsnis – testavimas |
| - | In a Claude Desktop | + | Claude Desktop |
| - | > Which Directo | + | > Kurios |
| - | Claude | + | Claude |
| - | > Which warehouses do I have in Directo? | + | > Kokie sandėliai yra mano Directo? |
| - | Claude | + | Claude |
| <note important> | <note important> | ||
| - | **Claude Desktop | + | **Claude Desktop |
| </ | </ | ||
| - | 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, |
| - | **Checking the logs if something doesn' | + | **Žurnalų tikrinimas, jei kas nors neveikia:** |
| - | In current | + | Dabartinėse |
| <code powershell> | <code powershell> | ||
| - | # Current | + | # Dabartinės |
| Get-Content " | Get-Content " | ||
| - | # Earlier | + | # Ankstesnė |
| Get-Content " | Get-Content " | ||
| </ | </ | ||
| - | Official | + | Oficiali |
| < | < | ||
| - | The official | + | Oficialioje |
| </ | </ | ||
| - | ===== 5. Setting up Gemini CLI ===== | + | ===== 5. Gemini CLI nustatymas |
| < | < | ||
| - | First complete Chapter | + | Pirmiausia atlikite |
| </ | </ | ||
| < | < | ||
| - | The MCP server only works **on your own computer**, and only inside the terminal-based | + | MCP serveris veikia tik **jūsų kompiuteryje** ir tik terminale veikiančioje |
| </ | </ | ||
| <note important> | <note important> | ||
| - | ⚠️ | + | ⚠️ |
| </ | </ | ||
| <note important> | <note important> | ||
| - | **Recommended:** if you ran the '' | + | **Rekomenduojama:** jei paleidote |
| </ | </ | ||
| - | ==== Step 5.1 — Installing | + | ==== 5.1 žingsnis – Gemini CLI diegimas |
| < | < | ||
| - | This step does not need admin rights — provided | + | Šiam žingsniui administratoriaus teisių nereikia, jei npm globalaus diegimo vieta nukreipta į jūsų profilį. Jei to dar nenustatėte, atlikite tai vieną kartą |
| </ | </ | ||
| Linija 571: | Linija 569: | ||
| </ | </ | ||
| - | Close PowerShell | + | Visiškai uždarykite |
| <code powershell> | <code powershell> | ||
| Linija 577: | Linija 575: | ||
| </ | </ | ||
| - | Verify: | + | Patikrinkite: |
| <code powershell> | <code powershell> | ||
| Linija 584: | Linija 582: | ||
| <note important> | <note important> | ||
| - | ⚠️ | + | ⚠️ |
| </ | </ | ||
| - | ==== Step 5.2 — Setting up the Google API key ==== | + | ==== 5.2 žingsnis – Google API rakto nustatymas |
| - | Go to [[https:// | + | Eikite į [[https:// |
| - | Save the key as a persistent environment variable: | + | Išsaugokite raktą kaip nuolatinį aplinkos kintamąjį: |
| <code powershell> | <code powershell> | ||
| Linija 597: | Linija 595: | ||
| </ | </ | ||
| - | Close PowerShell | + | Uždarykite |
| <code powershell> | <code powershell> | ||
| Linija 603: | Linija 601: | ||
| </ | </ | ||
| - | ==== Step 5.3 — Configuration file location | + | ==== 5.3 žingsnis – konfigūracijos failo vieta ==== |
| - | The Gemini CLI configuration is located on Windows | + | Gemini CLI konfigūracija sistemoje |
| < | < | ||
| Linija 611: | Linija 609: | ||
| </ | </ | ||
| - | Check whether the folder exists: | + | Patikrinkite, |
| <code powershell> | <code powershell> | ||
| Linija 617: | Linija 615: | ||
| </ | </ | ||
| - | If the answer is '' | + | Jei atsakymas |
| <code powershell> | <code powershell> | ||
| Linija 623: | Linija 621: | ||
| </ | </ | ||
| - | ==== Step 5.4 — Adding the MCP server | + | ==== 5.4 žingsnis – MCP serverio pridėjimas |
| - | Create or edit the file '' | + | Sukurkite arba redaguokite failą |
| <code json> | <code json> | ||
| Linija 644: | Linija 642: | ||
| <note important> | <note important> | ||
| - | Replace | + | Pakeiskite |
| </ | </ | ||
| < | < | ||
| - | **A note on the API key logic:** '' | + | **Pastaba apie API rakto logiką:** '' |
| <code powershell> | <code powershell> | ||
| Linija 654: | Linija 652: | ||
| </ | </ | ||
| - | Gemini CLI supports environment-variable expansion in '' | + | Gemini CLI palaiko aplinkos kintamųjų išskleidimą |
| </ | </ | ||
| - | ==== Step 5.5 — Trusting the folder | + | ==== 5.5 žingsnis – pasitikėjimas aplanku |
| - | Gemini CLI has a security feature called | + | Gemini CLI turi saugos funkciją |
| - | **The simplest way** — trust the server | + | **Paprasčiausias būdas** – pažymėkite |
| <code json> | <code json> | ||
| Linija 681: | Linija 679: | ||
| < | < | ||
| - | ''" | + | ''" |
| </ | </ | ||
| - | **Alternative** — if Trusted Folders | + | **Alternatyva** – jei Trusted Folders |
| - | ==== Step 5.6 — Testing | + | ==== 5.6 žingsnis – testavimas |
| - | Start Gemini CLI: | + | Paleiskite |
| <code powershell> | <code powershell> | ||
| Linija 694: | Linija 692: | ||
| </ | </ | ||
| - | Check the MCP connection: | + | Patikrinkite |
| < | < | ||
| Linija 700: | Linija 698: | ||
| </ | </ | ||
| - | Should show: | + | Turi būti rodoma: |
| < | < | ||
| Linija 706: | Linija 704: | ||
| </ | </ | ||
| - | Test query: | + | Bandomoji užklausa: |
| - | > Which Directo | + | > Kurios |
| - | Official | + | Oficiali |
| - | ===== 6. Troubleshooting | + | ===== 6. Trikčių šalinimas |
| - | ==== Common errors | + | ==== Dažnos klaidos |
| - | ^ Error message | + | ^ Klaidos pranešimas |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| - | | '' | + | | '' |
| < | < | ||
| - | The server' | + | Serverio klaidų pranešimai pateikiami anglų kalba. Claude |
| </ | </ | ||
| - | ^ Problem | + | ^ Problema |
| - | | No hammer icon visible | + | | Nematyti plaktuko piktogramos |
| - | | MCP server doesn' | + | | MCP serveris nepasileidžia |
| - | | Config folder is missing | + | | Nėra konfigūracijos aplanko |
| - | | Config edited, but nothing changes | + | | Konfigūracija pakeista, bet niekas nesikeičia |
| - | | No answer | + | | Nėra atsakymo |
| - | | MCP disappeared after a Claude Desktop | + | | MCP dingo atnaujinus |
| - | Log file (current | + | Žurnalo failas |
| <code powershell> | <code powershell> | ||
| Linija 753: | Linija 751: | ||
| </ | </ | ||
| - | ==== Gemini CLI-specific errors | + | ==== Gemini CLI būdingos klaidos |
| - | ^ Problem | + | ^ Problema |
| - | | ''/ | + | | ''/ |
| - | | '' | + | | '' |
| - | | 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 |
| - | | Gemini CLI won't sign in with a Google | + | | Gemini CLI neleidžia prisijungti |
| - | Gemini CLI diagnostics: | + | Gemini CLI diagnostika: |
| < | < | ||
| Linija 767: | Linija 765: | ||
| </ | </ | ||
| - | ===== 7. MCP tools ===== | + | ===== 7. MCP įrankiai |
| - | Both clients | + | Abu klientai |
| - | ^ Group ^ Tools ^ | + | ^ Grupė |
| - | | Sales | get_invoices, | + | | Pardavimai |
| - | | Customers | + | | Klientai |
| - | | Items / stock | get_items, get_itemclasses, | + | | Prekės |
| - | | Purchasing | + | | Pirkimai |
| - | | Accounting | + | | Apskaita |
| - | | Logistics | + | | Logistika |
| - | | People / HR | get_users, get_absences, | + | | Personalas |
| - | | Assets | + | | Turtas |
| - | | Other | get_projects, | + | | Kita | get_projects, |
| - | | Sync | get_deleted | | + | | Sinchronizavimas |
| - | | Access overview | + | | Prieigos apžvalga |
| - | ==== Good to know ==== | + | ==== Naudinga žinoti |
| - | * **A tool only works if its interface is enabled on your API key.** Your Directo | + | * **Įrankis veikia tik tada, kai jo sąsaja įjungta jūsų |
| - | * **Access overview:** ask "Which Directo | + | * **Prieigos apžvalga:** paklauskite |
| - | * **Stock levels:** prefer the '' | + | * **Likučiai:** pirmenybę teikite įrankiui |
| - | * **Filters:** every data tool has the usual filters | + | * **Filtrai:** kiekvienas duomenų įrankis turi įprastus filtrus |
| - | * **Result size:** the start of every answer shows the number of matches and the size. If it says " | + | * **Rezultato dydis:** kiekvieno atsakymo pradžioje rodomas atitikmenų skaičius ir dydis. Jei rašoma |
| - | * **Sensitive data:** the people, payroll, expense and usage-log tools ('' | + | * **Jautrūs duomenys:** personalo, darbo užmokesčio, išlaidų ir naudojimo žurnalų įrankiai |
| - | ===== 8. Security | + | ===== 8. Saugumas |
| - | ^ Measure | + | ^ Priemonė |
| - | | Credential Manager (both clients) | The API key is encrypted and visible only to your Windows | + | | Credential Manager (abu klientai) | API raktas užšifruotas ir matomas tik jūsų |
| - | | Environment variable | + | | Aplinkos kintamasis |
| - | | Local server | + | | Vietinis serveris |
| - | | Data to the AI provider | + | | Duomenys DI paslaugų teikėjui |
| - | | Minimal permissions | + | | Minimalios teisės |
| - | | Access-overview cache | The file '' | + | | Prieigos apžvalgos podėlis |
| - | | OneDrive/ | + | | OneDrive/ |
| - | | Admin rights | + | | Administratoriaus teisės |
| - | ===== 9. Updating and versions | + | ===== 9. Atnaujinimas ir versijos |
| - | ==== Which version am I running? ==== | + | ==== Kurią versiją naudoju? ==== |
| - | The MCP server version is in the server' | + | MCP serverio versija nurodyta serverio paleidimo eilutėje žurnale |
| <code powershell> | <code powershell> | ||
| Linija 815: | Linija 813: | ||
| </ | </ | ||
| - | The scripts' | + | Scenarijų versija matoma pirmoje jų eilutėje, kai juos paleidžiate |
| - | ==== How to update | + | ==== Kaip atnaujinti |
| - | - Download a **fresh** ZIP (see Step A1), extract it and open PowerShell | + | - Atsisiųskite |
| - | - Copy the new '' | + | - Nukopijuokite naująjį |
| - | - Close Claude Desktop | + | - **Visiškai** uždarykite Claude Desktop |
| - | - Check the version in the log (see above). | + | - Patikrinkite versiją žurnale |
| - | Copy command: | + | Kopijavimo komanda: |
| <code powershell> | <code powershell> | ||
| Linija 831: | Linija 829: | ||
| < | < | ||
| - | The new '' | + | Naujajam |
| </ | </ | ||
| - | ===== 10. References | + | ===== 10. Nuorodos |
| **Claude Desktop:** | **Claude Desktop:** | ||
| - | * [[https:// | + | * [[https:// |
| - | * [[https:// | + | * [[https:// |
| - | * [[https:// | + | * [[https:// |
| - | * [[https:// | + | * [[https:// |
| - | * [[https:// | + | * [[https:// |
| **Gemini CLI:** | **Gemini CLI:** | ||
| - | * [[https:// | + | * [[https:// |
| - | * [[https:// | + | * [[https:// |
| - | * [[https:// | + | * [[https:// |
| - | * [[https:// | + | * [[https:// |
| - | * [[https:// | + | * [[https:// |
| - | * [[https:// | + | * [[https:// |
| **Directo: | **Directo: | ||
| - | * [[https:// | + | * [[https:// |
| - | **General:** | + | **Bendra:** |
| - | * [[https:// | + | * [[https:// |
| - | * [[https:// | + | * [[https:// |
| - | **Quick-install scripts** (see Path A, Chapter | + | **Greito diegimo scenarijai** (žr. A būdą, 3 skyrių): |
| - | * '' | + | * '' |
| - | * '' | + | * '' |
| - | * '' | + | * '' |
| - | * '' | + | * '' |
lt/ask_directo.txt · Keista: 2026/11/13 14:09 vartotojo karolina