ConnectWise Sell MCP-Server

FastMCP HTTP-Server, der die ConnectWise Sell (Quosal) REST-API umschließt. 12 Tools für Angebote, Positionen, Reiter, Kunden, Bedingungen, Vorlagen, wiederkehrende Umsätze und Steuercodes.

Hinweis: Angebote können nicht von Grund auf über die Sell-API erstellt werden — neue Angebote müssen von einem bestehenden Angebot oder einer Vorlage kopiert werden. Verwenden Sie get_templates, um Vorlagen zu durchsuchen, und dann copy_quote, um ein Angebot zu erstellen.

Installation

Via uvx (empfohlen — kein Klonen, kein venv):

uvx connectwise-sell-mcp

Legen Sie die Anmeldedaten über Umgebungsvariablen oder eine .env-Datei in Ihrem Arbeitsverzeichnis fest.

Via pip:

pip install connectwise-sell-mcp
connectwise-sell-mcp

Aus dem Quellcode:

git clone https://github.com/Mfrostbutter/connectwise-sell-mcp
cd connectwise-sell-mcp
cp .env.example .env
# fill in your SELL_* credentials
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python3 server.py
# verify: curl http://localhost:8086/health

Transportmodi

Im stdio-Modus wird der Server pro Sitzung vom Client gestartet — kein Port, kein permanenter Prozess.

Umgebungsvariablen

So finden Sie Ihren Zugriffsschlüssel

Melden Sie sich bei ConnectWise Sell an und schauen Sie sich die URL an — sie enthält einen Parameter wie accessKey=XXXXXXXX. Dieser Wert ist Ihr SELL_ACCESS_KEY.

Authentifizierung

Die Sell-API verwendet HTTP Basic Auth mit einem zusammengesetzten Anmeldeinformationssatz:

Authorization: basic base64(accessKey+username:password)

Der Server erstellt dies automatisch aus Ihren Umgebungsvariablen.

Tools (12)

Angebote (5): list_quotes, get_quote, get_quote_versions, copy_quote, update_quote

Angebotsdetails (4): get_quote_items, get_quote_tabs, get_quote_customers, get_quote_terms

Referenz (3): get_templates, get_recurring_revenues, get_tax_codes

Client-Konfiguration

HTTP-Modus — Claude Desktop, Claude Code (Server läuft permanent):

claude_desktop_config.json / .claude/settings.json:

{
  "mcpServers": {
    "connectwise-sell": {
      "type": "http",
      "url": "http://localhost:8086/mcp",
      "headers": { "Authorization": "Bearer your_token_here" }
    }
  }
}

stdio-Modus — Cursor, VS Code, Zed, Continue oder jeder stdio-Client (Server wird pro Sitzung gestartet):

{
  "mcpServers": {
    "connectwise-sell": {
      "command": "uvx",
      "args": ["connectwise-sell-mcp"],
      "env": {
        "SELL_ACCESS_KEY": "your_access_key",
        "SELL_USERNAME": "your_api_username",
        "SELL_PASSWORD": "your_password",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Ausführung als Dienst

[Unit]
Description=ConnectWise Sell MCP
After=network.target

[Service]
User=mcp
WorkingDirectory=/opt/connectwise-sell-mcp
EnvironmentFile=/opt/connectwise-sell-mcp/.env
ExecStart=/opt/connectwise-sell-mcp/venv/bin/python3 server.py
Restart=always

[Install]
WantedBy=multi-user.target

Verwandtes

• connectwise-mcp — ConnectWise Manage MCP-Server (Tickets, Vereinbarungen, Unternehmen, Zeit, Finanzen)

Lizenz

MIT