ConnectWise Sell MCP 서버

ConnectWise Sell(Quosal) REST API를 래핑하는 FastMCP HTTP 서버입니다. 견적, 품목, 탭, 고객, 약관, 템플릿, 반복 수익 및 세금 코드를 다루는 12개의 도구를 포함합니다.

참고: Sell API를 통해 견적을 처음부터 새로 만들 수는 없습니다. 새 견적은 기존 견적이나 템플릿에서 복사해야 합니다. get_templates를 사용하여 템플릿을 탐색한 다음 copy_quote를 사용하여 생성하십시오.

설치

uvx 사용 (권장 — 클론 및 가상 환경 불필요):

uvx connectwise-sell-mcp

작업 디렉토리의 환경 변수나 .env 파일을 통해 자격 증명을 설정하십시오.

pip 사용:

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

소스에서 설치:

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

전송 모드

모드	설정 방법	용도
`http` (기본값)	`MCP_TRANSPORT=http`	세션이나 팀원 간에 공유되는 지속적인 서버
`stdio`	`MCP_TRANSPORT=stdio`	Cursor, VS Code, Zed, Continue 또는 기타 stdio 기반 MCP 클라이언트

stdio 모드에서는 서버가 클라이언트에 의해 세션별로 생성되므로 포트나 지속적인 프로세스가 필요하지 않습니다.

환경 변수

변수	필수	기본값	참고
`SELL_ACCESS_KEY`	예	—	로그인 시 Sell URL 매개변수에서 확인 가능
`SELL_USERNAME`	예	—	Sell API 사용자 이름 (API 사용자여야 함)
`SELL_PASSWORD`	예	—	Sell API 비밀번호
`SELL_BASE_URL`	아니요	`https://sellapi.quosalsell.com`	인스턴스가 다른 호스트를 사용하는 경우 재정의
`MCP_AUTH_TOKEN`	아니요	—	MCP 클라이언트 인증을 위한 Bearer 토큰; 인증 없이 실행하려면 생략
`SELL_MCP_PORT`	아니요	`8086`	HTTP 수신 포트

액세스 키 찾는 방법

ConnectWise Sell에 로그인하여 URL을 확인하십시오. accessKey=XXXXXXXX와 같은 매개변수가 포함되어 있습니다. 해당 값이 SELL_ACCESS_KEY입니다.

인증

Sell API는 복합 자격 증명을 사용하는 HTTP Basic 인증을 사용합니다:

Authorization: basic base64(accessKey+username:password)

서버는 환경 변수로부터 이를 자동으로 구성합니다.

도구 (12)

견적 (5): list_quotes, get_quote, get_quote_versions, copy_quote, update_quote

견적 상세 (4): get_quote_items, get_quote_tabs, get_quote_customers, get_quote_terms

참조 (3): get_templates, get_recurring_revenues, get_tax_codes

클라이언트 구성

HTTP 모드 — Claude Desktop, Claude Code (서버가 지속적으로 실행됨):

claude_desktop_config.json / .claude/settings.json:

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

stdio 모드 — Cursor, VS Code, Zed, Continue 또는 기타 stdio 클라이언트 (서버가 세션별로 생성됨):

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

서비스로 실행

[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

라이선스

MIT

connectwise-sell-mcp

ConnectWise Sell MCP 서버

설치

전송 모드

환경 변수

액세스 키 찾는 방법

인증

도구 (12)

클라이언트 구성

서비스로 실행

관련 항목

라이선스

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API