ConnectWise Sell MCP Server

ConnectWise Sell (Quosal) REST APIをラップするFastMCP HTTPサーバー。見積もり、明細項目、タブ、顧客、条件、テンプレート、経常収益、税コードを網羅する12個のツールを提供します。

注意: Sell APIでは見積もりをゼロから作成することはできません。新しい見積もりは、既存の見積もりまたはテンプレートからコピーする必要があります。get_templatesを使用してテンプレートを閲覧し、copy_quoteを使用して作成してください。

インストール

uvx経由（推奨 — クローン不要、venv不要）:

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ベーシック認証を使用します：

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 Server

インストール

トランスポートモード

環境変数

アクセスキーの確認方法

認証

ツール (12)

クライアント設定

サービスとしての実行

関連

ライセンス

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API