ConnectWise Manage MCP Server

Позвольте вашему ИИ-ассистенту работать напрямую с ConnectWise Manage. Ищите тикеты, учитывайте время, находите компании и контакты, управляйте проектами — через естественный диалог, а не через клики в интерфейсе CWM.

Это Model Context Protocol (MCP) сервер, который даёт Claude (или любому MCP-совместимому ИИ) 51 инструмент, покрывающий повседневные операции, на которые полагаются компании, использующие ConnectWise Manage. Работает с облачными и локальными (self-hosted) экземплярами CWM — просто укажите ваш сервер.

Часть экосистемы MSP Claude Plugins — растущий набор ИИ-интеграций для MSP-стека, включая Autotask, Datto RMM, IT Glue, HaloPSA, NinjaOne, Huntress и другие. Создано MSP-провайдерами для MSP-провайдеров.

Развёртывание в один клик

Примечание об аутентификации в реестре: этот сервер зависит только от публичных npm-пакетов, поэтому облачные сборщики Cloudflare и DigitalOcean устанавливают его зависимости анонимно — для развёртывания в один клик токен не требуется. (Если в будущем релизе появится приватная зависимость @wyre-ai/*, потребуется указать GitHub PAT с правом read:packages в качестве переменной сборки — NODE_AUTH_TOKEN для Cloudflare Workers и секрет GITHUB_TOKEN на время сборки для DigitalOcean.)

Установка опубликованного пакета: опубликованный пакет размещается в npm-реестре GitHub Packages, который требует аутентификации при каждой установке (даже для публичных пакетов). Чтобы установить его, аутентифицируйте npm в npm.pkg.github.com с помощью GitHub PAT, имеющего право read:packages:

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

Для развёртывания в Azure Container Apps с Entra ID OAuth 2.1 см. AZURE_ACA_DEPLOYMENT.md.

Related MCP server: Autotask MCP Server

Конфигурация

Переменные окружения

Базовый URL API (CW_MANAGE_URL)

Для локальных (self-hosted) экземпляров установите CW_MANAGE_URL в базовый URL вашего сервера. Сервер автоматически добавляет /v4_6_release/apis/3.0, если URL уже не содержит этот путь.

Если ваш локальный (self-hosted) экземпляр использует самоподписанный сертификат, также установите CW_MANAGE_REJECT_UNAUTHORIZED=false.

Получение API-ключей

1. Войдите в свой экземпляр ConnectWise Manage

2. Перейдите в System > Members > API Members

3. Создайте нового API-участника с соответствующими разрешениями

4. Сгенерируйте API-ключи для участника

5. Получите Client ID на ConnectWise Developer Portal

Доступные инструменты

Интерактивная карточка тикета (MCP Apps)

cw_get_ticket отображается в виде интерактивной карточки в хостах MCP Apps (Claude Desktop/web) с циклом «Add note» внутри карточки через cw_add_ticket_note, который всегда публикует только внутренние заметки (internalAnalysisFlag); в других хостах поведение plain-JSON не меняется. Карточка нейтральна по умолчанию и может быть забрендирована через инъекцию window.__BRAND__ или переменные окружения MCP_BRAND_* (MCP_BRAND_NAME, MCP_BRAND_LOGO_URL, MCP_BRAND_PRIMARY_COLOR, MCP_BRAND_ACCENT_COLOR, MCP_BRAND_BG, MCP_BRAND_TEXT) — пересборка не требуется.

Тикеты

• cw_search_tickets — Поиск сервисных тикетов по условиям

• cw_get_ticket — Получить тикет по ID

• cw_create_ticket — Создать новый сервисный тикет

• cw_update_ticket — Обновить тикет (JSON Patch)

• cw_get_ticket_notes — Получить все заметки тикета (включая заметки дочерних тикетов)

• cw_add_ticket_note — Добавить заметку к тикету (обсуждение, внутренняя или резолюция)

Компании

• cw_search_companies — Поиск компаний

• cw_get_company — Получить компанию по ID

• cw_create_company — Создать новую компанию

• cw_update_company — Обновить компанию (JSON Patch)

Контакты

• cw_search_contacts — Поиск контактов

• cw_get_contact — Получить контакт по ID

• cw_create_contact — Создать новый контакт

Проекты

• cw_search_projects — Поиск проектов

• cw_get_project — Получить проект по ID

• cw_create_project — Создать новый проект

• cw_search_project_tickets — Поиск тикетов в рамках проекта

• cw_get_project_ticket — Получить конкретный проектный тикет по ID

• cw_get_project_ticket_notes — Получить все заметки проектного тикета (включая заметки дочерних тикетов)

• cw_add_project_ticket_note — Добавить заметку к проектному тикету (обсуждение, внутренняя или резолюция)

Учёт времени

• cw_search_time_entries — Поиск записей времени

• cw_get_time_entry — Получить запись времени по ID

• cw_create_time_entry — Создать новую запись времени

Участники

• cw_search_members — Поиск участников/техников

• cw_get_member — Получить участника по ID

Элементы конфигурации

• cw_search_configurations — Поиск элементов конфигурации (активов)

• cw_get_configuration — Получить элемент конфигурации по ID

Справочные данные сервиса

• cw_list_boards — Список сервисных досок

• cw_list_priorities — Список приоритетов тикетов

• cw_list_statuses — Список статусов для доски

Активности

• cw_search_activities — Поиск активностей

• cw_get_activity — Получить активность по ID

• cw_create_activity — Создать новую активность

Соглашения

• cw_search_agreements — Поиск соглашений

• cw_get_agreement — Получить соглашение по ID

• cw_get_agreement_additions — Получить дополнения (строки) соглашения

Счета

• cw_search_invoices — Поиск счетов

• cw_get_invoice — Получить счёт по ID

Сделки

• cw_search_opportunities — Поиск сделок

• cw_get_opportunity — Получить сделку по ID

• cw_search_opportunity_forecasts — Поиск строк прогноза по сделке

• cw_search_opportunity_notes — Поиск заметок по сделке

• cw_search_sales_stages — Список этапов воронки продаж

Каталог (продукты)

• cw_search_catalog_items — Поиск позиций каталога продуктов

• cw_get_catalog_item — Получить позицию каталога по ID

• cw_create_catalog_item — Создать новую позицию каталога

• cw_update_catalog_item — Обновить позицию каталога (JSON Patch)

• cw_list_catalog_categories — Список категорий каталога

• cw_list_catalog_subcategories — Список подкатегорий каталога

• cw_list_manufacturers — Список производителей

Состояние

• cw_test_connection — Проверить соединение (вызывает /system/info)

Использование

С Claude Desktop

Добавьте в ваш 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"
      }
    }
  }
}

Для локального (self-hosted) экземпляра:

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

С Docker

docker compose up -d

HTTP-транспорт (шлюзовый режим)

Запустите с HTTP-транспортом для мультитенантных шлюзовых развёртываний:

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

Передавайте учётные данные в каждом запросе через заголовки: X-CW-Company-Id, X-CW-Public-Key, X-CW-Private-Key, X-CW-Client-Id и, опционально, X-CW-URL.

Разработка

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

# Type check
npm run typecheck

# Run tests
npm test

Участие в разработке

1. Сделайте форк репозитория

2. Создайте ветку для функции (git checkout -b feature/amazing-feature)

3. Зафиксируйте изменения (git commit -m 'Add amazing feature')

4. Отправьте изменения в ветку (git push origin feature/amazing-feature)

5. Откройте Pull Request

Лицензия

Apache-2.0

Создано WYRE Technology — часть экосистемы MSP Claude Plugins.