ConnectWise Manage MCP Server

Deja que tu asistente de IA trabaje directamente con ConnectWise Manage. Busca tickets, registra tiempo, consulta empresas y contactos, gestiona proyectos — mediante conversación natural en lugar de hacer clic en la interfaz de CWM.

Este es un servidor de Model Context Protocol (MCP) que ofrece a Claude (o a cualquier IA compatible con MCP) 51 herramientas que cubren las operaciones diarias de las que dependen los negocios que usan ConnectWise Manage. Funciona con instancias de CWM tanto en la nube como autohospedadas: solo tienes que apuntarlo a tu servidor.

Parte del ecosistema de MSP Claude Plugins — un conjunto creciente de integraciones de IA para el stack de MSP que incluye Autotask, Datto RMM, IT Glue, HaloPSA, NinjaOne, Huntress y más. Creado por MSPs, para MSPs.

Despliegue en un clic

Nota sobre la autenticación del registro: Este servidor depende únicamente de paquetes npm públicos, por lo que los servicios de compilación en la nube de Cloudflare y DigitalOcean instalan sus dependencias de forma anónima — no se necesita ningún token para el despliegue en un clic. (Si una futura versión añade una dependencia privada @wyre-ai/*, deberías proporcionar un PAT de GitHub con read:packages como variable de compilación — NODE_AUTH_TOKEN para Cloudflare Workers, o un secreto GITHUB_TOKEN en el momento de la compilación para DigitalOcean.)

Instalación del paquete publicado: El paquete publicado está disponible en el registro npm de GitHub Packages, que requiere autenticación en cada instalación (incluso para paquetes públicos). Para instalarlo, autentica npm en npm.pkg.github.com con un PAT de GitHub que tenga read:packages:

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

Para desplegar en Azure Container Apps con Entra ID OAuth 2.1, consulta AZURE_ACA_DEPLOYMENT.md.

Related MCP server: Autotask MCP Server

Configuración

Variables de entorno

URL base de la API (CW_MANAGE_URL)

Para instancias autohospedadas, define CW_MANAGE_URL como la URL base de tu servidor. El servidor añade automáticamente /v4_6_release/apis/3.0 a menos que la URL ya contenga esa ruta.

Si tu instancia autohospedada utiliza un certificado autofirmado, establece también CW_MANAGE_REJECT_UNAUTHORIZED=false.

Obtención de tus claves de API

1. Inicia sesión en tu instancia de ConnectWise Manage

2. Ve a System > Members > API Members

3. Crea un nuevo miembro de API con los permisos adecuados

4. Genera claves de API para el miembro

5. Obtén tu ID de cliente desde el ConnectWise Developer Portal

Herramientas disponibles

Tarjeta de ticket interactiva (MCP Apps)

cw_get_ticket se representa como una tarjeta interactiva en los hosts de MCP Apps (Claude Desktop/web), con un flujo de ida y vuelta de "Añadir nota" dentro de la tarjeta mediante cw_add_ticket_note que siempre publica notas solo internas (internalAnalysisFlag); el comportamiento de JSON plano no cambia en otros hosts. La tarjeta es neutra por defecto y se puede personalizar con la marca mediante la inyección de window.__BRAND__ o las variables de entorno MCP_BRAND_* (MCP_BRAND_NAME, MCP_BRAND_LOGO_URL, MCP_BRAND_PRIMARY_COLOR, MCP_BRAND_ACCENT_COLOR, MCP_BRAND_BG, MCP_BRAND_TEXT) — no requiere reconstrucción.

Tickets

• cw_search_tickets — Buscar tickets de servicio con condiciones

• cw_get_ticket — Obtener un ticket por ID

• cw_create_ticket — Crear un nuevo ticket de servicio

• cw_update_ticket — Actualizar un ticket (JSON Patch)

• cw_get_ticket_notes — Obtener todas las notas de un ticket (incluidas las notas de tickets hijos)

• cw_add_ticket_note — Añadir una nota a un ticket (discusión, interna o resolución)

Empresas

• cw_search_companies — Buscar empresas

• cw_get_company — Obtener una empresa por ID

• cw_create_company — Crear una nueva empresa

• cw_update_company — Actualizar una empresa (JSON Patch)

Contactos

• cw_search_contacts — Buscar contactos

• cw_get_contact — Obtener un contacto por ID

• cw_create_contact — Crear un nuevo contacto

Proyectos

• cw_search_projects — Buscar proyectos

• cw_get_project — Obtener un proyecto por ID

• cw_create_project — Crear un nuevo proyecto

• cw_search_project_tickets — Buscar tickets de un proyecto

• cw_get_project_ticket — Obtener un ticket de proyecto específico por ID

• cw_get_project_ticket_notes — Obtener todas las notas de un ticket de proyecto (incluidas las notas de tickets hijos)

• cw_add_project_ticket_note — Añadir una nota a un ticket de proyecto (discusión, interna o resolución)

Registros de tiempo

• cw_search_time_entries — Buscar registros de tiempo

• cw_get_time_entry — Obtener un registro de tiempo por ID

• cw_create_time_entry — Crear un nuevo registro de tiempo

Miembros

• cw_search_members — Buscar miembros/técnicos

• cw_get_member — Obtener un miembro por ID

Elementos de configuración

• cw_search_configurations — Buscar elementos de configuración (activos)

• cw_get_configuration — Obtener un elemento de configuración por ID

Datos de referencia de servicio

• cw_list_boards — Listar tableros de servicio

• cw_list_priorities — Listar prioridades de tickets

• cw_list_statuses — Listar estados de un tablero

Actividades

• cw_search_activities — Buscar actividades

• cw_get_activity — Obtener una actividad por ID

• cw_create_activity — Crear una nueva actividad

Acuerdos

• cw_search_agreements — Buscar acuerdos

• cw_get_agreement — Obtener un acuerdo por ID

• cw_get_agreement_additions — Obtener las adiciones (líneas de detalle) de un acuerdo

Facturas

• cw_search_invoices — Buscar facturas

• cw_get_invoice — Obtener una factura por ID

Oportunidades

• cw_search_opportunities — Buscar oportunidades

• cw_get_opportunity — Obtener una oportunidad por ID

• cw_search_opportunity_forecasts — Buscar líneas de previsión de oportunidades

• cw_search_opportunity_notes — Buscar notas de una oportunidad

• cw_search_sales_stages — Listar etapas del pipeline de ventas

Catálogo (productos)

• cw_search_catalog_items — Buscar artículos del catálogo de productos

• cw_get_catalog_item — Obtener un artículo del catálogo por ID

• cw_create_catalog_item — Crear un nuevo artículo del catálogo

• cw_update_catalog_item — Actualizar un artículo del catálogo (JSON Patch)

• cw_list_catalog_categories — Listar categorías del catálogo

• cw_list_catalog_subcategories — Listar subcategorías del catálogo

• cw_list_manufacturers — Listar fabricantes

Salud

• cw_test_connection — Probar la conexión (consulta /system/info)

Uso

Con Claude Desktop

Añade lo siguiente a tu claude_desktop_config.json:

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

Para una instancia autohospedada:

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

Con Docker

docker compose up -d

Transporte HTTP (modo gateway)

Ejecuta con transporte HTTP para despliegues de gateway multitenant:

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

Pasa las credenciales en cada solicitud mediante cabeceras: X-CW-Company-Id, X-CW-Public-Key, X-CW-Private-Key, X-CW-Client-Id y, opcionalmente, X-CW-URL.

Desarrollo

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

# Type check
npm run typecheck

# Run tests
npm test

Contribuciones

1. Haz un fork del repositorio

2. Crea una rama de funcionalidad (git checkout -b feature/amazing-feature)

3. Haz commit de tus cambios (git commit -m 'Add amazing feature')

4. Haz push de la rama (git push origin feature/amazing-feature)

5. Abre un Pull Request

Licencia

Apache-2.0

Creado por WYRE Technology — parte del ecosistema de MSP Claude Plugins.