Skip to content
Back to search

macola-mcp

Unofficial MCP server for the Macola 10 REST API. Lets Claude, Codex, Copilot and other MCP clients look up and update Macola data (customers, orders, inventory, pricing, POs) using Windows sign-in, with no stored passwords. Read-only by default. One-click Claude Desktop install.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/banidan--macola-mcp/badge.svg)](/listings/banidan--macola-mcp)

HTML

<a href="/listings/banidan--macola-mcp"><img src="/api/listings/banidan--macola-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Download `macola.mcpb` from [Releases](../../releases), or build it yourself (below). 2. Double-click it (or Claude Desktop → Settings → Extensions → Install Extension). 3. Enter your **Macola server name**, e.g. `ERPSERVER` (it becomes `http://ERPSERVER/Macola/api`). Use the server's **name**, not its IP address; Kerberos needs the name. A full address such as `https://erp.example.local/Macola/api` also works. 4. Leave **Read-only** on until you're comfortable.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 108 lines
  1. # macola-mcp
  2. An **unofficial** [MCP](https://modelcontextprotocol.io) server for the **Macola 10 REST API**. It lets Claude (or any MCP client) look up and, if you allow it, update your Macola data: customers, contacts, addresses, customer orders, inventory, prices, purchase orders, GL accounts and more. 88 tools in all.
  3. > **Not affiliated with or endorsed by ECI Software Solutions.** "Macola" is a trademark of its owner. This project contains no Macola code or documentation; it only calls the REST API that your own licensed Macola 10 installation provides.
  4. ## Highlights
  5. - **Windows sign-in, no stored password.** Each request is made as the Windows user running the MCP client (Kerberos), so people get their own Macola rights and Macola records changes under their own name.
  6. - **Read-only by default** in the desktop extension. Turn it off only when you want Claude to create, change or delete records.
  7. - **One-click install** for Claude Desktop (`.mcpb` extension): no Node.js, Git or scripts needed on the PC.
  8. ## Requirements
  9. - Macola 10 with the **REST API** installed (built against Macola 10.7; check `http://<server>/Macola/api/docs/index`).
  10. - A Windows 10 (1803+) or Windows 11 PC joined to the same domain as the Macola server. The built-in `curl.exe` does the sign-in.
  11. - Each user needs Macola rights for what they look up or change (see *Troubleshooting*).
  12. ## Install (Claude Desktop)
  13. 1. Download `macola.mcpb` from [Releases](../../releases), or build it yourself (below).
  14. 2. Double-click it (or Claude Desktop → Settings → Extensions → Install Extension).
  15. 3. Enter your **Macola server name**, e.g. `ERPSERVER` (it becomes `http://ERPSERVER/Macola/api`). Use the server's **name**, not its IP address; Kerberos needs the name. A full address such as `https://erp.example.local/Macola/api` also works.
  16. 4. Leave **Read-only** on until you're comfortable.
  17. ## Install (any MCP client, manual)
  18. ```bash
  19. git clone <this repo> && cd macola-mcp
  20. npm install && npm run build
  21. ```
  22. Then add it to your client's config, for example Claude Desktop's `%APPDATA%\Claude\claude_desktop_config.json`:
  23. ```json
  24. {
  25. "mcpServers": {
  26. "macola": {
  27. "command": "node",
  28. "args": ["C:\\path\\to\\macola-mcp\\dist\\index.js"],
  29. "env": {
  30. "MACOLA_SERVER": "YOUR-MACOLA-SERVER",
  31. "MACOLA_AUTH": "windows",
  32. "MACOLA_READONLY": "true"
  33. }
  34. }
  35. }
  36. }
  37. ```
  38. ### Other MCP clients
  39. It runs as a **local** (stdio) MCP server, so it works with any client that can start one. It does **not** work with the ChatGPT app or website: those only connect to MCP servers hosted on the internet, and this one runs on the user's PC so it can sign in as that Windows user.
  40. **OpenAI Codex CLI**: `%USERPROFILE%\.codex\config.toml`
  41. ```toml
  42. [mcp_servers.macola]
  43. command = "node"
  44. args = ["C:\\path\\to\\macola-mcp\\dist\\index.js"]
  45. env = { MACOLA_SERVER = "YOUR-MACOLA-SERVER", MACOLA_AUTH = "windows", MACOLA_READONLY = "true" }
  46. ```
  47. **VS Code (GitHub Copilot agent mode)**: `.vscode/mcp.json` in your workspace (or run "MCP: Add Server")
  48. ```json
  49. {
  50. "servers": {
  51. "macola": {
  52. "type": "stdio",
  53. "command": "node",
  54. "args": ["C:\\path\\to\\macola-mcp\\dist\\index.js"],
  55. "env": { "MACOLA_SERVER": "YOUR-MACOLA-SERVER", "MACOLA_AUTH": "windows", "MACOLA_READONLY": "true" }
  56. }
  57. }
  58. }
  59. ```
  60. **Cursor / Windsurf / Claude Code**: same `mcpServers` block as the Claude Desktop example above (Cursor: `%USERPROFILE%\.cursor\mcp.json`; Claude Code: `claude mcp add macola -e MACOLA_SERVER=YOUR-MACOLA-SERVER -e MACOLA_READONLY=true -- node C:\path\to\macola-mcp\dist\index.js`).
  61. ### Settings
  62. | Variable | Meaning |
  63. |---|---|
  64. | `MACOLA_SERVER` | **Required.** Your Macola server's name, e.g. `ERPSERVER` (becomes `http://ERPSERVER/Macola/api`) |
  65. | `MACOLA_BASE_URL` | Instead of `MACOLA_SERVER`: the full API address, for non-standard setups (HTTPS, other path or port) |
  66. | `MACOLA_AUTH` | `windows` (default): sign in as the current Windows user. `basic`: fixed account from `MACOLA_USERNAME` / `MACOLA_PASSWORD` (avoid if you can) |
  67. | `MACOLA_READONLY` | `true`: only read tools are offered (61 of 88). Unset or `false`: all tools, including create/update/delete |
  68. | `MACOLA_CURL` | Optional path to a `curl.exe` with SSPI. Default: `%windir%\System32\curl.exe`, then Git for Windows' curl |
  69. ## What it covers
  70. Addresses, contacts, customer orders and order lines (including credit-hold removal and create-from-master), customer items, comment codes, inventory items, locations, bins, kits, serial/lots, in-transit, feature options, product categories, substitute items, inventory transactions, warehouse locations, purchase orders and lines, GL accounts, cost centers and units, pricing, divisions, receivable terms, projects, job titles, titles, tax codes and schedules, shop floor orders, standard routings, and ForecastPro export/import.
  71. Every "find" tool accepts the API's common query options (`pageSize`, `page`, `skip`, `fields`, `order`, ...), and any property name works as a filter.
  72. ## Troubleshooting
  73. | Symptom | Cause / fix |
  74. |---|---|
  75. | `401` "Windows sign-in was not accepted" | Use the server **name** in `MACOLA_SERVER` (not an IP), and run on a domain-joined PC signed in with a domain account |
  76. | `403` "Access Denied. Insufficient rights" | The signed-in user has no Macola rights for that resource. Grant them in Macola |
  77. | Reading contacts works, but **saving a contact gives a bare 500** | The Macola API forwards contact saves to Synergy as the user, and the update (HTTP MERGE) needs **write permission on Synergy's `services\Exact.Entity.REST.svc` file** (ASP.NET file authorization, 401.3 behind the scenes). Grant the user, or better an AD group, **Modify** on that one file. No restart needed |
  78. | 500 when filtering by `Account` | `Account` filters need the account's GUID, not the customer number |
  79. | 500 with `totalCount` on CustomerItem / ProductCategory | An API quirk; those tools drop `totalCount` |
  80. ## Known limitations
  81. - `forecast_pro_import` has not been tested against a live system.
  82. - Windows only (Windows sign-in relies on SSPI). `MACOLA_AUTH=basic` works anywhere Node runs.
  83. ## Build the desktop extension
  84. ```powershell
  85. pwsh .\build-extension.ps1 # -> release\macola.mcpb
  86. ```
  87. ## Contributing
  88. Issues and pull requests are welcome, especially reports of which tools work on other Macola versions. Please never include customer data, server names or credentials in issues, logs or screenshots.
  89. ## License
  90. [MIT](LICENSE). Provided as is, without warranty: test with read-only mode first, and review what Claude proposes before allowing changes.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.