ConnectWise Manage MCP Server

Lassen Sie Ihren KI-Assistenten direkt mit ConnectWise Manage arbeiten. Tickets suchen, Zeit erfassen, Firmen und Kontakte nachschlagen, Projekte verwalten — durch natürliche Konversation statt durch Klickken durch die CWM-Oberfläche.

Dies ist ein Model Context Protocol (MCP)-Server, der Claude (oder jeder MCP-kompatiblen KI) 51 Tools bereitstellt, die die täglichen Abläufe abdecken, auf die ConnectWise-Manage-Shops angewiesen sind. Funktioniert sowohl mit cloud-gehosteten als auch selbst gehosteten CWM-Instanzen — weisen Sie ihn einfach auf Ihren Server.

Teil des MSP Claude Plugins-Ökosystems — eine wachsende Suite von KI-Integrationen für den MSP-Stack, darunter Autotask, Datto RMM, IT Glue, HaloPSA, NinjaOne, Huntress und weitere. Von MSPs für MSPs entwickelt.

Ein-Klick-Bereitstellung

Hinweis zur Registry-Authentifizierung: Dieser Server ist nur von öffentlichen npm-Paketen abhängig, daher installieren die Cloud-Builder von Cloudflare und DigitalOcean seine Abhängigkeiten anonym — für die Bereitstellung mit einem Klick ist kein Token erforderlich. (Falls eine zukünftige Version eine private @wyre-ai/*-Abhängigkeit hinzufügt, würden Sie ein GitHub-PAT mit read:packages als Build-Variable angeben — NODE_AUTH_TOKEN für Cloudflare Workers, ein GITHUB_TOKEN-Secret zur Buildzeit für DigitalOcean.)

Installieren des veröffentlichten Pakets: Das veröffentlichte Paket wird in der npm-Registry von GitHub Packages veröffentlicht, die bei jeder Installation eine Authentifizierung erfordert (auch bei öffentlichen Paketen). Um es zu installieren, authentifizieren Sie npm gegenüber npm.pkg.github.com mit einem GitHub-PAT, das read:packages besitzt:

export NODE_AUTH_TOKEN=$(gh auth token)
npm install @wyre-ai/connectwise-manage-mcp

Informationen zur Bereitstellung in Azure Container Apps mit Entra ID OAuth 2.1 finden Sie unter AZURE_ACA_DEPLOYMENT.md.

Related MCP server: ConnectWise Manage MCP Server

Konfiguration

Umgebungsvariablen

API-Basis-URL (CW_MANAGE_URL)

Setzen Sie für selbst gehostete Instanzen CW_MANAGE_URL auf die Basis-URL Ihres Servers. Der Server hängt automatisch /v4_6_release/apis/3.0 an, sofern die URL diesen Pfad nicht bereits enthält.

Falls Ihre selbst gehostete Instanz ein selbstsigniertes Zertifikat verwendet, setzen Sie zusätzlich CW_MANAGE_REJECT_UNAUTHORIZED=false.

So erhalten Sie Ihre API-Schlüssel

1. Melden Sie sich bei Ihrer ConnectWise-Manage-Instanz an.

2. Navigieren Sie zu System > Members > API Members.

3. Erstellen Sie ein neues API-Mitglied mit den entsprechenden Berechtigungen.

4. Generieren Sie API-Schlüssel für das Mitglied.

5. Holen Sie sich Ihre Client-ID vom ConnectWise Developer Portal.

Verfügbare Tools

Interaktive Ticket-Karte (MCP-Apps)

cw_get_ticket wird in MCP-Apps-Hosts (Claude Desktop/Web) als interaktive Karte gerendert, mit einem „Add note"-Roundtrip in der Karte über cw_add_ticket_note, wobei immer nur interne (internalAnalysisFlag) Notizen gepostet werden; das Verhalten bei reinem JSON bleibt in anderen Hosts unverändert. Die Karte ist standardmäßig neutral und kann über window.__BRAND__-Injektion oder MCP_BRAND_*-Umgebungsvariablen (MCP_BRAND_NAME, MCP_BRAND_LOGO_URL, MCP_BRAND_PRIMARY_COLOR, MCP_BRAND_ACCENT_COLOR, MCP_BRAND_BG, MCP_BRAND_TEXT) mit einem Branding versehen werden — kein Rebuild erforderlich.

Tickets

• cw_search_tickets — Service-Tickets mit Bedingungen durchsuchen

• cw_get_ticket — Ticket anhand der ID abrufen

• cw_create_ticket — Neues Service-Ticket erstellen

• cw_update_ticket — Ticket aktualisieren (JSON Patch)

• cw_get_ticket_notes — Alle Notizen zu einem Ticket abrufen (einschließlich Notizen zu Untertickets)

• cw_add_ticket_note — Notiz zu einem Ticket hinzufügen (Diskussion, intern oder Lösung)

Firmen

• cw_search_companies — Firmen durchsuchen

• cw_get_company — Firma anhand der ID abrufen

• cw_create_company — Neue Firma erstellen

• cw_update_company — Firma aktualisieren (JSON Patch)

Kontakte

• cw_search_contacts — Kontakte durchsuchen

• cw_get_contact — Kontakt anhand der ID abrufen

• cw_create_contact — Neuen Kontakt erstellen

Projekte

• cw_search_projects — Projekte durchsuchen

• cw_get_project — Projekt anhand der ID abrufen

• cw_create_project — Neues Projekt erstellen

• cw_search_project_tickets — Tickets in einem Projekt durchsuchen

• cw_get_project_ticket — Bestimmtes Projekt-Ticket anhand der ID abrufen

• cw_get_project_ticket_notes — Alle Notizen zu einem Projekt-Ticket abrufen (einschließlich Notizen zu Untertickets)

• cw_add_project_ticket_note — Notiz zu einem Projekt-Ticket hinzufügen (Diskussion, intern oder Lösung)

Zeiteinträge

• cw_search_time_entries — Zeiteinträge durchsuchen

• cw_get_time_entry — Zeiteintrag anhand der ID abrufen

• cw_create_time_entry — Neuen Zeiteintrag erstellen

Mitglieder

• cw_search_members — Mitglieder/Techniker durchsuchen

• cw_get_member — Mitglied anhand der ID abrufen

Konfigurationselemente

• cw_search_configurations — Konfigurationselemente (Assets) durchsuchen

• cw_get_configuration — Konfigurationselement anhand der ID abrufen

Service-Referenzdaten

• cw_list_boards — Service-Boards auflisten

• cw_list_priorities — Ticket-Prioritäten auflisten

• cw_list_statuses — Status für ein Board auflisten

Aktivitäten

• cw_search_activities — Aktivitäten durchsuchen

• cw_get_activity — Aktivität anhand der ID abrufen

• cw_create_activity — Neue Aktivität erstellen

Vereinbarungen

• cw_search_agreements — Vereinbarungen durchsuchen

• cw_get_agreement — Vereinbarung anhand der ID abrufen

• cw_get_agreement_additions — Zusätze (Positionen) einer Vereinbarung abrufen

Rechnungen

• cw_search_invoices — Rechnungen durchsuchen

• cw_get_invoice — Rechnung anhand der ID abrufen

Verkaufschancen

• cw_search_opportunities — Verkaufschancen durchsuchen

• cw_get_opportunity — Verkaufschance anhand der ID abrufen

• cw_search_opportunity_forecasts — Forecast-Zeilen einer Verkaufschance durchsuchen

• cw_search_opportunity_notes — Notizen zu einer Verkaufschance durchsuchen

• cw_search_sales_stages — Verkaufspipeline-Stufen auflisten

Katalog (Produkte)

• cw_search_catalog_items — Produktkatalogeinträge durchsuchen

• cw_get_catalog_item — Katalogeintrag anhand der ID abrufen

• cw_create_catalog_item — Neuen Katalogeintrag erstellen

• cw_update_catalog_item — Katalogeintrag aktualisieren (JSON Patch)

• cw_list_catalog_categories — Katalogkategorien auflisten

• cw_list_catalog_subcategories — Katalogunterkategorien auflisten

• cw_list_manufacturers — Hersteller auflisten

Status

• cw_test_connection — Verbindung testen (ruft /system/info auf)

Verwendung

Mit Claude Desktop

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "connectwise-manage": {
      "command": "npx",
      "args": ["@wyre-ai/connectwise-manage-mcp"],
      "env": {
        "CW_MANAGE_COMPANY_ID": "your-company-id",
        "CW_MANAGE_PUBLIC_KEY": "your-public-key",
        "CW_MANAGE_PRIVATE_KEY": "your-private-key",
        "CW_MANAGE_CLIENT_ID": "your-client-id"
      }
    }
  }
}

Für eine selbst gehostete Instanz:

{
  "mcpServers": {
    "connectwise-manage": {
      "command": "npx",
      "args": ["@wyre-ai/connectwise-manage-mcp"],
      "env": {
        "CW_MANAGE_URL": "https://cwm.yourcompany.com",
        "CW_MANAGE_COMPANY_ID": "your-company-id",
        "CW_MANAGE_PUBLIC_KEY": "your-public-key",
        "CW_MANAGE_PRIVATE_KEY": "your-private-key",
        "CW_MANAGE_CLIENT_ID": "your-client-id",
        "CW_MANAGE_REJECT_UNAUTHORIZED": "false"
      }
    }
  }
}

Mit Docker

docker compose up -d

HTTP-Transport (Gateway-Modus)

Führen Sie den Server mit HTTP-Transport für Multi-Tenant-Gateway-Bereitstellungen aus:

MCP_TRANSPORT=http AUTH_MODE=gateway node dist/index.js

Übergeben Sie die Anmeldedaten pro Anfrage über Header: X-CW-Company-Id, X-CW-Public-Key, X-CW-Private-Key, X-CW-Client-Id und optional X-CW-URL.

Entwicklung

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

# Type check
npm run typecheck

# Run tests
npm test

Mitwirken

1. Forken Sie das Repository.

2. Erstellen Sie einen Feature-Branch (git checkout -b feature/amazing-feature).

3. Committen Sie Ihre Änderungen (git commit -m 'Add amazing feature').

4. Pushen Sie den Branch (git push origin feature/amazing-feature).

5. Öffnen Sie einen Pull Request.

Lizenz

Apache-2.0

Entwickelt von WYRE Technology — Teil des MSP Claude Plugins-Ökosystems.