使用说明
提交MCP服务器
通过自然语言与Claude、Cursor或任何兼容MCP的AI客户端管理销售佣金、补偿计划、SPIFF和交易。
这 提交MCP服务器 连接 长官 --您的销售佣金管理平台——通过 模型上下文协议（MCP）.让你的人工智能完全通过对话记录交易、模拟佣金、构建薪酬计划和管理SPIFF。
✨ 你能做什么
"Show me all pending deals this quarter"
"Create a new comp plan with 10% new business rate and a $500K quarterly quota"
"What would Sarah's commission be if she closes a $75K enterprise deal today?"
"Launch a SPIFF: $500 per new business deal closed in February"
"Approve deal ID abc123 and show me the commission breakdown"
"Show me our top commission earners this month"
🚀 快速开始
1.获取API密钥
- 登录 app.getcommish.io
- 首选 管理员→ 设置→ API密钥
- 点击 生成新密钥
- 复制你的密钥——它以开头
cm_live_或cm_test_
2.配置您的AI客户端
克劳德桌面版
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：
{
"mcpServers": {
"commish": {
"command": "npx",
"args": ["-y", "commish-mcp-server"],
"env": {
"COMMISH_API_KEY": "cm_live_your_key_here"
}
}
}
}
克劳德代码（CLI）
claude mcp add commish \
-e COMMISH_API_KEY=cm_live_your_key_here \
-- npx -y commish-mcp-server
或添加到您的项目 .mcp.json:
{
"mcpServers": {
"commish": {
"command": "npx",
"args": ["-y", "commish-mcp-server"],
"env": {
"COMMISH_API_KEY": "cm_live_your_key_here"
}
}
}
}
光标
打开 光标设置→ MCP 并添加：
{
"commish": {
"command": "npx",
"args": ["-y", "commish-mcp-server"],
"env": {
"COMMISH_API_KEY": "cm_live_your_key_here"
}
}
}
风帆/Codeium
{
"mcpServers": {
"commish": {
"command": "npx",
"args": ["-y", "commish-mcp-server"],
"env": {
"COMMISH_API_KEY": "cm_live_your_key_here"
}
}
}
}
3.试试看
配置后，询问您的AI：
- “目前有哪些交易有待批准？”
- “达成交易：Acme Corp，12万美元ARR，新业务，今天结束”
- “显示我们当前的薪酬计划”
- “如果我本季度再完成两笔5万美元的交易，我的佣金是多少？”
- “启动SPIFF，3月份达成的每笔企业交易1000美元”
🛠 全部28个工具
📊 优惠（6工具）
| 工具 | 说明 |
|---|---|
list_deals |
按状态（待定/批准/拒绝）或代表列出和筛选交易 |
get_deal |
获取单一交易的完整细节 |
create_deal |
使用ARR、交易类型、代表分配和注释记录新交易 |
update_deal |
更新交易详情（ARR、代表、成交日期、交易类型） |
approve_deal |
批准待处理交易并触发佣金计算 |
reject_deal |
以可选理由拒绝未决交易 |
📋 计算计划（6个工具）
| 工具 | 说明 |
|---|---|
list_comp_plans |
列出所有薪酬计划 |
get_comp_plan |
获取完整的薪酬计划详细信息，包括费率、配额、加速器 |
create_comp_plan |
创建一个包含费率、配额、加速器、减速器和上限的新计划 |
update_comp_plan |
更新现有计划的任何方面 |
assign_comp_plan |
为一个或多个代表分配一个计划，并注明生效日期 |
clone_comp_plan |
使用新名称克隆现有计划 |
👥 用户（5工具）
| 工具 | 说明 |
|---|---|
list_users |
列出所有具有角色和薪酬计划分配的团队成员 |
get_user |
获取单个用户的个人资料 |
get_user_commissions |
获取代表的完整佣金历史记录 |
create_user |
为新代表提供角色和薪酬计划 |
update_user |
更新用户信息、角色、薪酬计划或停用 |
💰 佣金（3种工具）
| 工具 | 说明 |
|---|---|
list_commissions |
列出整个团队的所有佣金记录 |
get_commission_summary |
全组织汇总：按代表细分、按期间细分的总计 |
simulate_commission |
假设分析：在不创建记录的情况下计算假设佣金 |
🏆 SPIFF（5个工具）
| 工具 | 说明 |
|---|---|
list_spiffs |
列出所有SPIFF节目及其状态和排行榜 |
get_spiff |
获取完整的SPIFF详细信息和当前排名 |
create_spiff |
启动新的激励计划（每笔交易、扁平、分层或团队池） |
update_spiff |
更新或暂停活动的SPIFF |
delete_spiff |
删除草稿或暂停的SPIFF |
🔗 Webhooks（3个工具）
| 工具 | 说明 |
|---|---|
list_webhooks |
列出所有已配置的webhook端点 |
create_webhook |
订阅端点以处理、委托或SPIFF事件 |
delete_webhook |
删除webhook订阅 |
⚙️ 环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
COMMISH_API_KEY |
✅ 是 | - | 您的委员会API密钥(cm_live_... 或 cm_test_...) |
COMMISH_API_URL |
❌ 没有 | https://app.getcommish.io/api/v1 |
覆盖自托管或临时环境 |
🔄 速率限制
API委员会强制执行 每分钟100个请求 根据API密钥。MCP服务器通过指数回退自动处理速率限制响应，最多可重试3次，延迟为1秒、2秒和4秒。
如果你达到了限制，服务器将返回一条友好的消息：
“超出速率限制（100个请求/分钟）。请稍候。”
🔒 安全
- API密钥是通过环境变量传递的-从不进行硬编码
- 所有请求都使用带有承载令牌身份验证的HTTPS
- 测试密钥(
cm_test_)可用于开发而不影响生产数据 - Webhook端点必须使用HTTPS
🏗 本地开发
# Clone the repo
git clone https://github.com/commish-io/commish-mcp-server
cd commish-mcp-server
# Install dependencies
npm install
# Build
npm run build
# Run locally
COMMISH_API_KEY=cm_test_your_key node dist/index.js
# Watch mode for development
npm run dev
📦 出版
npm run build
npm publish
🤝 贡献
欢迎拉取请求！请先打开一个问题来讨论重大更改。
- 分叉回购
- 创建要素分支：
git checkout -b feat/my-feature - 提交您的更改：
git commit -m 'feat: add my feature' - 推：
git push origin feat/my-feature - 打开拉取请求
📄 许可证
MIT© 长官
看 许可证 全文。
