MCP-сервер ConnectWise Sell

HTTP-сервер FastMCP, оборачивающий REST API ConnectWise Sell (Quosal). 12 инструментов для работы с коммерческими предложениями (Quotes), позициями, вкладками, клиентами, условиями, шаблонами, регулярным доходом и налоговыми кодами.

Примечание: Коммерческие предложения нельзя создать с нуля через API Sell — новые предложения должны копироваться из существующих или из шаблонов. Используйте 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 или любой MCP-клиент на базе stdio

В режиме stdio сервер запускается клиентом для каждой сессии — без порта, без постоянного процесса.

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

Переменная	Обязательно	По умолчанию	Примечания
`SELL_ACCESS_KEY`	Да	—	Находится в параметрах URL Sell при входе в систему
`SELL_USERNAME`	Да	—	Имя пользователя API Sell (должен быть API-пользователем)
`SELL_PASSWORD`	Да	—	Пароль API Sell
`SELL_BASE_URL`	Нет	`https://sellapi.quosalsell.com`	Переопределите, если ваш экземпляр использует другой хост
`MCP_AUTH_TOKEN`	Нет	—	Bearer-токен для аутентификации MCP-клиента; пропустите для запуска без аутентификации
`SELL_MCP_PORT`	Нет	`8086`	Порт для прослушивания HTTP

Как найти ваш ключ доступа (access key)

Войдите в ConnectWise Sell и посмотрите на URL — он будет содержать параметр вида accessKey=XXXXXXXX. Это значение и есть ваш SELL_ACCESS_KEY.

Аутентификация

API Sell использует HTTP Basic auth с составными учетными данными:

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

См. также

connectwise-mcp — MCP-сервер для ConnectWise Manage (заявки, соглашения, компании, время, финансы)

Лицензия

MIT

connectwise-sell-mcp