ConnectWise Manage MCP Server

AI 어시스턴트가 ConnectWise Manage에서 직접 작업할 수 있게 하세요. 티켓 검색, 시간 기록, 회사 및 연락처 조회, 프로젝트 관리 — CWM 인터페이스를 클릭하는 대신 자연어 대화를 통해 처리합니다.

이것은 ConnectWise Manage를 사용하는 업체가 의존하는 일상 운영을 다루는 51가지 도구를 Claude(또는 모든 MCP 호환 AI)에 제공하는 Model Context Protocol (MCP) 서버입니다. 클라우드 호스팅 및 자체 호스팅 CWM 인스턴스 모두에서 작동합니다 — 서버 주소만 지정하면 됩니다.

MSP Claude Plugins 생태계의 일부 — Autotask, Datto RMM, IT Glue, HaloPSA, NinjaOne, Huntress 등을 포함하여 성장 중인 MSP 스택용 AI 통합 제품군입니다. MSP가 MSP를 위해 만들었습니다.

원클릭 배포

레지스트리 인증 참고: 이 서버는 공개 npm 패키지만 사용하므로 Cloudflare 및 DigitalOcean 클라우드 빌더가 종속성을 익명으로 설치합니다 — 원클릭 배포에 토큰이 필요하지 않습니다. (향후 릴리스에서 비공개 @wyre-ai/* 종속성을 추가하는 경우, 빌드 변수로 read:packages 권한이 있는 GitHub PAT를 제공해야 합니다 — Cloudflare Workers의 경우 NODE_AUTH_TOKEN, DigitalOcean의 경우 빌드 시 GITHUB_TOKEN 시크릿.)

게시된 패키지 설치: 릴리스된 패키지는 GitHub Packages npm 레지스트리에 게시되며, 모든 설치 시 인증이 필요합니다(공개 패키지의 경우에도). 설치하려면 read:packages 권한이 있는 GitHub PAT로 npm을 npm.pkg.github.com에 인증하세요:

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

Entra ID OAuth 2.1과 함께 Azure Container Apps에 배포하려면 AZURE_ACA_DEPLOYMENT.md를 참조하세요.

Related MCP server: Autotask MCP Server

설정

환경 변수

API 기본 URL (CW_MANAGE_URL)

자체 호스팅 인스턴스의 경우 CW_MANAGE_URL을 서버의 기본 URL로 설정합니다. 서버는 URL에 해당 경로가 이미 포함되어 있지 않으면 /v4_6_release/apis/3.0을 자동으로 추가합니다.

자체 호스팅 인스턴스가 자체 서명 인증서를 사용하는 경우 CW_MANAGE_REJECT_UNAUTHORIZED=false도 설정합니다.

API 키 얻기

1. ConnectWise Manage 인스턴스에 로그인합니다

2. 시스템 > 멤버 > API 멤버로 이동합니다

3. 적절한 권한으로 새 API 멤버를 만듭니다

4. 멤버의 API 키를 생성합니다

5. ConnectWise Developer Portal에서 클라이언트 ID를 가져옵니다

사용 가능한 도구

대화형 티켓 카드 (MCP 앱)

cw_get_ticket은 MCP 앱 호스트(Claude Desktop/웹)에서 대화형 카드로 렌더링되며, 카드 내 "메모 추가" 왕복 작업은 cw_add_ticket_note를 통해 항상 내부 전용(internalAnalysisFlag) 메모로 게시됩니다. 다른 호스트에서는 일반 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"
      }
    }
  }
}

자체 호스팅 인스턴스의 경우:

{
  "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. 풀 리퀘스트를 엽니다

라이선스

Apache-2.0

WYRE Technology 제작 — MSP Claude Plugins 생태계의 일부