Servidor MCP de ConnectWise Sell

Servidor HTTP FastMCP que envuelve la API REST de ConnectWise Sell (Quosal). 12 herramientas que cubren presupuestos, partidas, pestañas, clientes, términos, plantillas, ingresos recurrentes y códigos de impuestos.

Nota: Los presupuestos no se pueden crear desde cero a través de la API de Sell; los nuevos presupuestos deben copiarse de un presupuesto o plantilla existente. Utilice get_templates para explorar las plantillas y luego copy_quote para crear uno.

Instalación

Vía uvx (recomendado: sin clonar, sin venv):

uvx connectwise-sell-mcp

Establezca las credenciales a través de variables de entorno o un archivo .env en su directorio de trabajo.

Vía pip:

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

Desde el código fuente:

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

Related MCP server: sherweb-mcp

Modos de transporte

En el modo stdio, el servidor es generado por sesión por el cliente: sin puerto, sin proceso persistente.

Variables de entorno

Cómo encontrar su clave de acceso

Inicie sesión en ConnectWise Sell y mire la URL: contendrá un parámetro como accessKey=XXXXXXXX. Ese valor es su SELL_ACCESS_KEY.

Autenticación

La API de Sell utiliza autenticación básica HTTP con una credencial compuesta:

Authorization: basic base64(accessKey+username:password)

El servidor construye esto automáticamente a partir de sus variables de entorno.

Herramientas (12)

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

Detalle del presupuesto (4): get_quote_items, get_quote_tabs, get_quote_customers, get_quote_terms

Referencia (3): get_templates, get_recurring_revenues, get_tax_codes

Configuración del cliente

Modo HTTP — Claude Desktop, Claude Code (el servidor se ejecuta de forma persistente):

claude_desktop_config.json / .claude/settings.json:

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

Modo stdio — Cursor, VS Code, Zed, Continue o cualquier cliente stdio (el servidor se genera por sesión):

{
  "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"
      }
    }
  }
}

Ejecución como servicio

[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

Relacionado

• connectwise-mcp — Servidor MCP de ConnectWise Manage (tickets, acuerdos, empresas, tiempo, finanzas)

Licencia

MIT