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

Modos de transporte

Modo	Cómo configurar	Ideal para
`http` (predeterminado)	`MCP_TRANSPORT=http`	Servidor persistente compartido entre sesiones o miembros del equipo
`stdio`	`MCP_TRANSPORT=stdio`	Cursor, VS Code, Zed, Continue o cualquier cliente MCP basado en stdio

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

Variables de entorno

Variable	Requerido	Predeterminado	Notas
`SELL_ACCESS_KEY`	Sí	—	Se encuentra en los parámetros de la URL de Sell al iniciar sesión
`SELL_USERNAME`	Sí	—	Nombre de usuario de la API de Sell (debe ser un usuario de API)
`SELL_PASSWORD`	Sí	—	Contraseña de la API de Sell
`SELL_BASE_URL`	No	`https://sellapi.quosalsell.com`	Sobrescribir si su instancia utiliza un host diferente
`MCP_AUTH_TOKEN`	No	—	Token Bearer para la autenticación del cliente MCP; omitir para ejecutar sin autenticación
`SELL_MCP_PORT`	No	`8086`	Puerto de escucha HTTP

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

connectwise-sell-mcp