Installation Guide

Get mendix-expert running in 5 minutes

Prerequisites

Node.js 18+ - Download
Git - Download
VS Code with Copilot, OR Claude Desktop

Step 1: Clone the Repository

# Choose where to install (anywhere you want)
cd C:\Projects

# Clone
git clone https://github.com/jordnlvr/mendix-mcp-server.git
cd mendix-mcp-server

# Install dependencies
npm install

Step 2: Test It Works

node src/index.js

You should see output about the server starting. Press Ctrl+C to stop.

Step 3: Configure Your AI Client

Option A: VS Code Copilot

Open VS Code
Press Ctrl+, to open Settings
Click the {} icon (top right) to open JSON
Add this (update the path!):

"chat.mcp.servers": {
  "mendix-expert": {
    "type": "stdio",
    "command": "node",
    "args": ["C:/Projects/mendix-mcp-server/src/index.js"]
  }
}

Restart VS Code

Option B: Claude Desktop

Open %APPDATA%\Claude\claude_desktop_config.json
Add:

{
  "mcpServers": {
    "mendix-expert": {
      "command": "node",
      "args": ["C:/Projects/mendix-mcp-server/src/index.js"]
    }
  }
}

Restart Claude Desktop

Step 4: Verify It’s Working

In VS Code Copilot Chat or Claude:

@mendix-expert What are the best practices for microflow naming?

You should get a response with Mendix-specific knowledge!

Updating

cd C:\Projects\mendix-mcp-server
git pull
npm install  # if package.json changed

Troubleshooting

“node is not recognized”

Node.js isn’t in your PATH. Either:

Restart your terminal after installing Node
Or use the full path: "C:/Program Files/nodejs/node.exe"

“ENOENT: no such file”

The path in your config is wrong. Make sure:

Use forward slashes / or escaped backslashes \\
The path points to src/index.js, not just the folder

Server not appearing in Copilot

Check the path is correct
Restart VS Code completely (not just reload)
Check VS Code Output panel for errors

Next Steps

Read the User Guide for daily usage
Check CONTRIBUTING.md to add knowledge
Visit the GitHub repo