ConnectWise Manage MCP Server

This is a fully structured, production-ready MCP server for ConnectWise Manage (CWM), providing dynamic access to all available API calls through a proxy-like interface.

Quick Overview

This Node.js MCP server acts as a generalized API gateway, accepting dynamic API calls to ConnectWise Manage and returning responses directly to Claude Desktop or other clients. It includes a sample MCP manifest format for ConnectWise Manage API functions.

Setup Instructions

1. Install dependencies:

   npm install
   

2. Build the project:

   npm run build
   

3. Generate or obtain the complete ConnectWise Manage API manifest file (see below)

4. Configure Claude Desktop to use the server (see below)

The MCP Manifest

This repository includes a sample MCP manifest (connectwise-mcp-manifest-sample.json) that demonstrates the format, but you'll need to generate or obtain the full manifest file for all ConnectWise API operations.

The full manifest was generated from the ConnectWise API specification and contains over 3,000 API operations. Due to its size, it's not included directly in this repository.

Obtaining the Full Manifest

You can either:

1. Generate it yourself using the ConnectWise API spec
2. Contact the repository owner for the full manifest file

After obtaining it, save it as connectwise-mcp-manifest.json in your installation directory.

Integrating with Claude Desktop

Modify your claude_desktop_config.json to include the ConnectWise MCP server:

{
  "mcpServers": {
    "connectwise": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "manifest": "path/to/connectwise-mcp-manifest.json",
      "env": {
        "CW_COMPANY_ID": "your_company_id",
        "CW_PUBLIC_KEY": "your_public_key",
        "CW_PRIVATE_KEY": "your_private_key",
        "CW_API_URL": "https://api-na.myconnectwise.net/v4_6_release/apis/3.0",
        "PORT": "3000"
      },
      "options": {
        "autoStart": true,
        "logLevel": "info"
      }
    }
  }
}

Replace the following values in the above configuration:

• path/to/dist/index.js: The actual path to your compiled server file (e.g., C:/ConnectWise-PSA-API-MCP-Server/dist/index.js)
• path/to/connectwise-mcp-manifest.json: Path to the full MCP manifest file (e.g., C:/ConnectWise-PSA-API-MCP-Server/connectwise-mcp-manifest.json)
• your_company_id: Your ConnectWise company ID
• your_public_key: Your ConnectWise public API key
• your_private_key: Your ConnectWise private API key

API Usage Examples

Request body and params directly follow ConnectWise API Documentation.

Usage with Claude Desktop

With the proper MCP manifest, Claude Desktop can understand and interact with all ConnectWise Manage endpoints through natural language.

Examples of queries you can make:

• "Get a list of all service tickets"
• "Create a new ticket for customer XYZ"
• "Find all open tickets assigned to John"
• "Get company information for client ABC Corp"

Troubleshooting

If you encounter authentication issues, double-check that:

1. Your ConnectWise credentials are correct in the Claude config file
2. Your API key has the correct permissions in ConnectWise Manage
3. Your ConnectWise instance URL is correct