User Tools

Site Tools



en:ask_directo

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
en:ask_directo [2026/10/01 12:25] – [Directo MCP Server Setup - Claude Desktop and Gemini CLI] andrusen:ask_directo [2026/11/12 15:58] (current) – toomas
Line 4: Line 4:
  
 Read more about what Ask Directo can do: [[https://directo.ee/ask-directo]]. Read more about what Ask Directo can do: [[https://directo.ee/ask-directo]].
 +
 ===== Directo MCP Server Setup - Claude Desktop and Gemini CLI ===== ===== Directo MCP Server Setup - Claude Desktop and Gemini CLI =====
  
Line 47: Line 48:
 </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.+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.
  
 <note important> <note important>
Line 56: Line 57:
   * The MCP server only works while **your computer is on** and the AI client is running   * The MCP server only works while **your computer is on** and the AI client is running
   * If you want to share an MCP server across multiple users, you need a separate hosted-server solution (out of scope for this guide)   * If you want to share an MCP server across multiple users, you need a separate hosted-server solution (out of scope for this guide)
 +  * 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.
 </note> </note>
  
Line 83: Line 85:
  
 <note important> <note important>
-⚠️ **The Gemini CLI free tier still exists, but has changed.** Depending on your authentication method: +⚠️ **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: 
-  * **Google account (Gemini Code Assist, individual user):** ~60 requests/min and ~1000 requests/day +  * **a paid Gemini API key** 
-  * **Free Gemini API key (unpaid):** narrower — ~10 requests/min, ~250 requests/day, Flash models only+  * **a Gemini Code Assist Standard / Enterprise license**
  
-On June 18, 2026, the Gemini CLI will be replaced by **Antigravity CLI** for the unpaid tier and Google One users — this affects a specific authentication path, not free access as a whole. For higher volume or Pro models you need a Google AI Pro/Ultra subscription or a Gemini Code Assist license. Check your project's actual limits in AI Studio, as they change frequently and depend on region and account status.+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.
 </note> </note>
  
Line 175: Line 177:
 {{ :en:directo-mcp-files.zip |directo-mcp-files.zip}} {{ :en:directo-mcp-files.zip |directo-mcp-files.zip}}
  
-<note important>+<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. 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.
 +</note>
 +
 +<note>
 +The scripts print all messages in English: ''[OK]'' = succeeded, ''[!]'' = needs your attention, ''[ERROR]'' = failed.
 </note> </note>
  
 <note important> <note important>
-⚠️ **Current limitation:** the scripts inside this archive still print their status messages in Estonian (e.g. "Kontrollin Node.js-i"). They work identically regardless of the message language — only the on-screen text differs. An English-language version of the scripts is planned; until then, refer to the step descriptions in this guide to know what each stage of the output means.+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.
 </note> </note>
  
Line 216: Line 222:
 **Step A2 — Running the scripts** **Step A2 — Running the scripts**
  
-In the same PowerShell window (not as administrator), in the folder you just extracted:+In the same PowerShell window (not as administrator), in the folder you just extracted: \\ 
 +A2.1 API key (shared by both clients, do this first)
  
 <code powershell> <code powershell>
-# API key (shared by both clients, do this first) 
 .\set-directo-apikey.ps1 .\set-directo-apikey.ps1
 +</code>
  
-# Pick your AI client (or both):+A2.2 Pick your AI client (or both): \\ 
 +Claude 
 + 
 +<code powershell>
 .\install-claude-mcp.ps1 .\install-claude-mcp.ps1
 +</code>
 +
 +Gemini
 +
 +<code powershell>
 .\install-gemini-mcp.ps1 .\install-gemini-mcp.ps1
 </code> </code>
  
-Each script prints a summary at the end — what's done (✅) and what still needs manual action (❗).+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.
  
 <note important> <note important>
Line 298: Line 313:
  
 <note important> <note important>
-This file contains all 32 Directo API tools and has been **fully schema-verified** — every parameter has been checked against Directo's actual ws_*.json schemas. 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.+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.
 </note> </note>
  
Line 413: Line 428:
 ==== Step 4.1 — Configuration file location ==== ==== Step 4.1 — Configuration file location ====
  
-Claude Desktop has **two possible** configuration locations on Windows, depending on how it was installed:+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.
  
-^ Install type ^ Location ^ +^ Variant ^ Location ^ 
-| Direct ''.exe'' installer (typical) | ''%APPDATA%\Claude\'' | +| MSIX (claude.ai/download), data moved (Claude Desktop 3.1623 and later) | ''%LOCALAPPDATA%\Claude-Data\claude_pzs8sxrjxfjjc\'' | 
-| Microsoft Store / MSIX | ''%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\'' |+| The same MSIX before the data move | ''%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\'' | 
 +| Microsoft Store build (not verified) | ''%LOCALAPPDATA%\Claude-Data\anthropicpbc.claude_fnn82j28hfe8t\'' | 
 +| Earlier ''.exe'' installer | ''%APPDATA%\Claude\'' |
  
 <note important> <note important>
-This is a documented, currently active Claude Desktop issue: with an MSIX install, Windows **virtualizes** the ''%APPDATA%\Claude\'' location transparently to a different path. If you edit the wrong (standard) file, the change never reaches the app, and the MCP server silently fails to load, with no explanatory error.+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.
 </note> </note>
  
-Check which one applies on your machine — open File Explorer and try both in the address bar:+Show which of these files exist on your machine (regular PowerShell):
  
-<code> +<code powershell> 
-%APPDATA%\Claude+"$env:LOCALAPPDATA\Claude-Data\claude_pzs8sxrjxfjjc\claude_desktop_config.json", 
 +"$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json", 
 +"$env:LOCALAPPDATA\Claude-Data\anthropicpbc.claude_fnn82j28hfe8t\claude_desktop_config.json", 
 +"$env:APPDATA\Claude\claude_desktop_config.json" | Where-Object { Test-Path $_ }
 </code> </code>
  
-If a ''claude_desktop_config.json'' file already exists there (or Claude Desktop has already created something there), use this path. If not, try:+Use the **first** file in the list (the order is the same as in the table: newer before older). Exceptions:
  
-<code> +  * 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. 
-%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude +  * 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. 
-</code> +  * If the list is empty: run Claude Desktop at least once and run the command again.
- +
-<note> +
-If neither folder exists, run Claude Desktop at least once — it creates the necessary folders automatically (usually at the standard path). +
-</note>+
  
 ==== Step 4.2 — Configuration file ==== ==== Step 4.2 — Configuration file ====
Line 489: Line 505:
 ==== Step 4.4 — Testing ==== ==== Step 4.4 — Testing ====
  
-In a Claude Desktop conversation, type:+In a Claude Desktop conversation, type first:
  
-> Show me all stock levels+> Which Directo interfaces are enabled on my API key?
  
-Claude should automatically use the ''get_stocklevels'' tool and return data from Directo.+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: 
 + 
 +> Which warehouses do I have in 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. 
 + 
 +<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. 
 +</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.
  
 **Checking the logs if something doesn't work:** **Checking the logs if something doesn't work:**
  
-The log location follows the same two possibilities as Step 4.1:+In current Claude Desktop versions the logs are in ''%LOCALAPPDATA%\Claude\logs'':
  
 <code powershell> <code powershell>
-# Direct .exe installer: +# Current Claude Desktop versions: 
-Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" -Tail 30+Get-Content "$env:LOCALAPPDATA\Claude\logs\mcp-server-directo.log" -Tail 30
  
-# Microsoft Store / MSIX: +# Earlier .exe installer: 
-Get-Content "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\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]]+Official Claude Desktop MCP documentation: [[https://modelcontextprotocol.io/docs/develop/connect-local-servers|modelcontextprotocol.io - Connect to local MCP servers]] 
 + 
 +<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. 
 +</note>
  
 ===== 5. Setting up Gemini CLI ===== ===== 5. Setting up Gemini CLI =====
Line 520: Line 550:
  
 <note important> <note important>
-⚠️ Before continuing, make sure you have valid authentication — either a Google account (Gemini Code Assist), a free Gemini API key (Flash models), or a paid subscription. Limits and model choice depend on the authentication method (see Step 2.3).+⚠️ 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).
 </note> </note>
  
Line 671: Line 701:
  
 <code> <code>
-🟢 directo - Ready (32 tools)+🟢 directo - Ready (41 tools)
 </code> </code>
  
 Test query: Test query:
-> Show me all stock levels+> Which Directo interfaces are enabled on my API key?
  
 Official Gemini CLI MCP documentation: [[https://geminicli.com/docs/tools/mcp-server/|geminicli.com/docs/tools/mcp-server]] Official Gemini CLI MCP documentation: [[https://geminicli.com/docs/tools/mcp-server/|geminicli.com/docs/tools/mcp-server]]
Line 684: Line 714:
  
 ^ Error message ^ Cause ^ Fix ^ ^ Error message ^ Cause ^ Fix ^
-| ''DIRECTO_API_KEY puudub'' *(literal log text, still Estonian — see note below)* | Credential Manager save failed | Redo Step B7 (or Path A: ''.\set-directo-apikey.ps1'') |+| ''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 | 
 +| ''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 |
 | ''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 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"'' |
 | ''SyntaxError'' | directo-mcp.js file is corrupted or incomplete | Download the file again, see Step B4 (or Path A: A1) | | ''SyntaxError'' | directo-mcp.js file is corrupted or incomplete | Download the file again, see Step B4 (or Path A: A1) |
-| ''Incorrect filter id'' | Invalid API filter name | Known limitation — use without that filter | +| ''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 | 
-| ''401 / 403'' | Directo API key is invalid or expired | Check the key in Directo admin |+| ''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 | 
 +| ''Unknown filter name'' | Wrong filter name (names are case-sensitive) | Ask which filters the interface allows: "Which filters does the ... interface allow?" | 
 +| ''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 | 
 +| ''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'') | 
 +| ''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 | 
 +| ''Rate limit exceeded (429)'' | Too many requests | Wait a moment and try again (recommended limit: up to 60 requests per minute) | 
 +| ''Directo reported a server error (5xx)'' | A temporary problem on Directo's side | Try again later; if it persists, contact Directo support |
 | ''running scripts is disabled'' | PowerShell execution policy | ''Set-ExecutionPolicy RemoteSigned -Scope CurrentUser'' (Step A1 or B1) | | ''running scripts is disabled'' | PowerShell execution policy | ''Set-ExecutionPolicy RemoteSigned -Scope CurrentUser'' (Step A1 or B1) |
-| ''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 (file downloaded via a browser) | ''Get-ChildItem <folder> -Recurse %%|%% Unblock-File'' (see Step A1) |
 | ''npm not recognized'' | Node.js is not on PATH | Close and reopen PowerShell | | ''npm not recognized'' | Node.js is not on PATH | Close and reopen PowerShell |
  
 <note> <note>
-The first row above ("DIRECTO_API_KEY puudub") shows exactly what will appear in the log file — it's a literal message printed by ''directo-mcp.js'', which is still written in Estonian pending an English version of that file. If you see this text in your logs, it means "DIRECTO_API_KEY is missing," and the fix column above still applies.+The server's error messages are in English. Claude explains them to you in your own language.
 </note> </note>
  
-==== Claude Desktop-specific errors ====+
  
 ^ Problem ^ Fix ^ ^ Problem ^ Fix ^
Line 703: Line 740:
 | MCP server doesn't start | Check that the config file's name doesn't have a ''.txt'' extension | | MCP server doesn't start | Check that the config file's name doesn't have a ''.txt'' extension |
 | Config folder is missing | Run Claude Desktop once — the folders are created automatically | | Config folder is missing | Run Claude Desktop once — the folders are created automatically |
-| Config edited, but nothing changes | Make sure you're editing the RIGHT file — see Step 4.1 (two possible locations, MSIX vs. direct install) |+| 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) | 
 +| 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 | 
 +| 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. |
  
-Log file (try both, see Step 4.1):+Log file (current Claude Desktop versions; the second line is for the earlier .exe installer):
  
 <code powershell> <code powershell>
 +Get-Content "$env:LOCALAPPDATA\Claude\logs\mcp-server-directo.log" -Tail 30
 Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" -Tail 30 Get-Content "$env:APPDATA\Claude\logs\mcp-server-directo.log" -Tail 30
-Get-Content "$env:LOCALAPPDATA\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\logs\mcp-server-directo.log" -Tail 30 
 </code> </code>
  
Line 717: Line 756:
 | ''/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'' shows Disconnected | Add ''"trust": true'' to the server config (Step 5.4), or trust the folder via the dialog / the ''/permissions'' command |
 | ''GEMINI_API_KEY'' error | Redo Step 5.2, open a new PowerShell window | | ''GEMINI_API_KEY'' error | Redo Step 5.2, open a new PowerShell window |
-| Rate limit / 429 error | Free-tier request limit exceeded — wait for the limit to reset, or consider a paid subscription (see Step 2.3) |+| 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) | 
 +| 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 diagnostics: Gemini CLI diagnostics:
Line 727: Line 767:
 ===== 7. MCP tools ===== ===== 7. MCP tools =====
  
-Both clients (Claude Desktop and Gemini CLI) use the same tools:+Both clients (Claude Desktop and Gemini CLI) use the same 41 tools (40 Directo API interfaces and the access-overview tool ''get_api_access''):
  
 ^ Group ^ Tools ^ ^ Group ^ Tools ^
 | Sales | get_invoices, get_orders, get_sales_quotations, get_sales_contracts, get_receipts | | Sales | get_invoices, get_orders, get_sales_quotations, get_sales_contracts, get_receipts |
 | Customers | get_customers, get_suppliers, get_contacts | | Customers | get_customers, get_suppliers, get_contacts |
-| Products / stock | get_items, get_itemclasses, get_stocklevels, get_stocklevels_sn, get_allocations, get_priceformulas |+| Items / stock | 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 | | Purchasing | get_purchase_orders, get_purchase_invoices, get_purchase_payments, get_stock_receipts |
 | Accounting | get_transactions, get_accounts, get_financial_budgets, get_nettings | | Accounting | get_transactions, get_accounts, get_financial_budgets, get_nettings |
 | Logistics | get_deliveries, get_movements | | Logistics | get_deliveries, get_movements |
-| Other | get_projects, get_objects, get_resources, get_events, get_users, get_recipes, get_replacementlogs |+| People / HR | get_users, get_absences, get_wage_calculations, get_expenses, get_approvals | 
 +| Assets | get_assets, get_customer_assets | 
 +| Other | get_projects, get_objects, get_resources, get_events, get_recipes, get_replacementlogs, get_usagelogs |
 | Sync | get_deleted | | Sync | get_deleted |
 +| Access overview | get_api_access |
 +
 +==== Good to know ====
 +
 +  * **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.
 +  * **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.
 +  * **Stock levels:** prefer the ''get_stocklevels_sn'' tool. If that interface is not enabled on the key, use ''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.
 +  * **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.
 +  * **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.
  
 ===== 8. Security ===== ===== 8. Security =====
  
 ^ Measure ^ Explanation ^ ^ Measure ^ Explanation ^
-| Credential Manager (both clients) | API key is encrypted, visible only to your Windows account — Claude and Gemini read the same entry |+| Credential Manager (both clients) | The API key is encrypted and visible only to your Windows account — Claude and Gemini read the same entry |
 | Environment variable (Gemini fallback) | If Credential Manager is set up, the ''env'' block isn't strictly necessary — see the note under Step 5.4 | | Environment variable (Gemini fallback) | If Credential Manager is set up, the ''env'' block isn't strictly necessary — see the note under Step 5.4 |
 | Local server | The MCP server only runs on your computer, it is not publicly reachable | | Local server | The MCP server only runs on your computer, it is not publicly reachable |
-| Minimal permissions | Restrict the Directo API key's permissions to only the resources you need |+| 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. | 
 +| Minimal permissions | Restrict the Directo API key's permissions to only the interfaces and fields you need (including people and payroll data) | 
 +| 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 |
 | OneDrive/Dropbox | Exclude the ''directo-mcp'' folder from cloud sync | | OneDrive/Dropbox | Exclude the ''directo-mcp'' folder from cloud sync |
 | 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) | | 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) |
  
-===== 9. References =====+===== 9. Updating and versions ===== 
 + 
 +==== Which version am I running? ==== 
 + 
 +The MCP server version is in the server's start-up line in the log (''Directo MCP server v... started (N tools)''): 
 + 
 +<code powershell> 
 +Select-String -Path "$env:LOCALAPPDATA\Claude\logs\mcp-server-directo.log" -Pattern "Directo MCP server v" | Select-Object -Last 1 
 +</code> 
 + 
 +The scripts' version is visible on their first line when you run them (for example ''v1.5''). 
 + 
 +==== How to update ==== 
 + 
 +  - Download a **fresh** ZIP (see Step A1), extract it and open PowerShell in the extracted folder. 
 +  - Copy the new ''directo-mcp.js'' over the old one (command below). 
 +  - Close Claude Desktop **completely** (Step 4.3) or Gemini CLI and open it again. 
 +  - Check the version in the log (see above). 
 + 
 +Copy command: 
 + 
 +<code powershell> 
 +Copy-Item .\directo-mcp.js "$env:USERPROFILE\directo-mcp\directo-mcp.js" -Force 
 +</code> 
 + 
 +<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. 
 +</note> 
 + 
 +===== 10. References =====
  
 **Claude Desktop:** **Claude Desktop:**
Line 755: Line 838:
   * [[https://modelcontextprotocol.io/docs/develop/connect-local-servers|Claude Desktop MCP setup]]   * [[https://modelcontextprotocol.io/docs/develop/connect-local-servers|Claude Desktop MCP setup]]
   * [[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|Guide: local MCP servers on Claude Desktop]]
 +  * [[https://downloads.claude.ai/releases/enterprise/intune/Claude-Intune-README.md|Claude Desktop data folders on Windows (Anthropic)]]
   * [[https://modelcontextprotocol.io|Official MCP documentation]]   * [[https://modelcontextprotocol.io|Official MCP documentation]]
  
Line 760: Line 844:
   * [[https://geminicli.com/docs|Gemini CLI documentation]]   * [[https://geminicli.com/docs|Gemini CLI documentation]]
   * [[https://geminicli.com/docs/tools/mcp-server/|Gemini CLI MCP setup]]   * [[https://geminicli.com/docs/tools/mcp-server/|Gemini CLI MCP setup]]
 +  * [[https://geminicli.com/docs/resources/quota-and-pricing/|Gemini CLI quotas and pricing]]
 +  * [[https://github.com/google-gemini/gemini-cli/discussions/28017|Gemini CLI transition to Antigravity CLI (announcement)]]
   * [[https://aistudio.google.com/apikey|Google AI Studio API keys]]   * [[https://aistudio.google.com/apikey|Google AI Studio API keys]]
   * [[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 documentation]]
Line 771: Line 857:
  
 **Quick-install scripts** (see Path A, Chapter 3): **Quick-install scripts** (see Path A, Chapter 3):
-  * ''directo-mcp.js'' — MCP server (32 tools, schema-verified)+  * ''directo-mcp.js'' — MCP server (41 tools)
   * ''set-directo-apikey.ps1'' — API key management (initial setup + rotation)   * ''set-directo-apikey.ps1'' — API key management (initial setup + rotation)
   * ''install-claude-mcp.ps1'' — automatic Claude Desktop install   * ''install-claude-mcp.ps1'' — automatic Claude Desktop install
   * ''install-gemini-mcp.ps1'' — automatic Gemini CLI install   * ''install-gemini-mcp.ps1'' — automatic Gemini CLI install
en/ask_directo.txt · Last modified: 2026/11/12 15:58 by toomas

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki