提交MCP服务器
通过自然语言与Claude、Cursor或任何兼容MCP的AI客户端管理销售佣金、补偿计划、SPIFF和交易。
](https://www.npmjs.com/package/commish-mcp-server)  
这 提交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© 长官
看 许可证 全文。
______________________________________________________________________
