使用说明
Vorp MCP服务器
Vorp 集团商业代理商的模型上下文协议 （MCP） 服务器。
Integra com CRM公司 e 谷歌表格 在SDR，BDR和Closers漏斗中进行完整的潜在客户管理。
🎯 功能
- 线索管理创建、搜索、更新和跨阶段移动潜在客户
- 联系人管理列出和更新联系人（电子邮件，电话）
- 原生和自定义字段完全支持 Kommo 字段
- 事件表安排后指标（会议、提案、销售）
- 多用户支持通过Bearer令牌的多个账户
🔧 可用工具
搜索和查询
| 工具 | 描述 |
|---|---|
vorp_buscar_lead 按名称全局搜索所有线索 |
|
vorp_buscar_lead_por_id |
带有价值的线索的完整细节 |
vorp_buscar_por_telefone 通过电话搜索 lead |
|
vorp_listar_leads_funil |
列出特定漏斗的线索 |
vorp_listar_etapas_funil |
列出漏斗的步骤（获取status_id） |
vorp_listar_campos_customizados 自定义字段列表（获取field_id和enum_id） |
|
vorp_listar_vendedores 用户/供应商列表（获取 user_id） |
|
vorp_listar_contatos CRM联系人列表 |
|
vorp_historico_lead Lead的事件时间表 |
动作
| 工具 | 描述 |
|---|---|
vorp_criar_lead 创建一个新的联系人。 |
|
vorp_atualizar_lead |
更新本地和自定义字段 |
vorp_atualizar_contato |
更新联系人的电子邮件/电话号码 |
vorp_mover_lead |
在漏斗阶段之间移动 lead |
vorp_adicionar_nota |
添加注释/观察到一个线索 |
vorp_criar_tarefa 为 lead 创建任务/提醒 |
事件日历 （排程后指标）
| 工具 | 描述 |
|---|---|
vorp_planilha_listar_eventos |
列出有过滤器的事件 |
vorp_planilha_eventos_lead |
特定线索的事件 |
vorp_planilha_metricas 统一度量 |
|
vorp_planilha_buscar_evento |
按ID搜索事件 |
📊 价值领域
该系统使用两种类型的值：
| 字段 | 描述 | 起源 |
|---|---|---|
valor_venda |
在关闭行为中支付的价值 | 原生字段 price |
valor_contrato |
合约总价值 （ARR） | 自定义字段 1024619 |
🚀 安装
npm install
npm run build
⚡ 执行
# Desenvolvimento
npm run dev
# Produção
npm start
服务器从端口启动 3000 默认 。
🐳 码头工人
# Build
docker build -t vorp-mcp .
# Run
docker run -p 3000:3000 vorp-mcp
# Com docker-compose
docker-compose up -d
🔐 认证
服务器使用以下格式的 Bearer Token 身份验证：
Authorization: Bearer {senha}|{subdomain}|{kommoToken}
senhaMCP 密码subdomainKommo 账户子域（ 例如“ vorp ”）kommoTokenKommo API 访问令牌
📁 项目结构
├── src/
│ ├── server.ts # Servidor principal + handlers MCP
│ ├── schemas.ts # Schemas Zod de validação
│ ├── constants.ts # Constantes (funis, etapas, config)
│ ├── kommo/
│ │ ├── client.ts # Cliente HTTP para Kommo API
│ │ └── types.ts # Tipos TypeScript
│ └── sheets/
│ ├── client.ts # Cliente Google Sheets API
│ └── types.ts # Tipos da planilha
├── Dockerfile
├── docker-compose.yml
├── package.json
├── tsconfig.json
├── prompt-system.md # Prompt completo do agente
└── prompt-system-compact.md # Prompt compacto
📝 代理提示
代理人必须遵循以下主要规则：
- 使用发现工具： 总是咨询
vorp_listar_etapas_funilevorp_listar_campos_customizados更新前 - 执行复合命令如果用户提供了足够的信息，一次性运行
- 批量确认动作： 只对影响多个潜在客户的操作请求确认
查看配置代理的提示文件 ：
prompt-system.md完整版本，带示例prompt-system-compact.md- 用于生产的紧凑型版本
📄 许可证
麻省理工学院-沃尔普集团