ServiceTitan MCP服务器
ServiceTitan现场服务管理平台的完整模型上下文协议(MCP)服务器 108工具 和 15个React应用.
特性
🔧 工具(共108件)
作业管理(8个工具)
servicetitan_list_jobs-列出带有筛选器的作业servicetitan_get_job-获取作业详细信息servicetitan_create_job-创建新作业servicetitan_update_job-更新作业详细信息servicetitan_complete_job-标记作业完成servicetitan_cancel_job-取消作业servicetitan_list_job_appointments-列出工作预约servicetitan_get_job_history-获取工作历史记录
客户管理(9个工具)
servicetitan_list_customers-列出客户servicetitan_get_customer-获取客户详细信息servicetitan_create_customer-创建新客户servicetitan_update_customer-更新客户servicetitan_deactivate_customer-停用客户servicetitan_get_customer_balance-获取账户余额servicetitan_list_customer_contacts-列出客户联系人servicetitan_create_customer_contact-创建联系人servicetitan_list_customer_locations-列出客户位置
估算管理(8个工具)
servicetitan_list_estimates-列出估计数servicetitan_get_estimate-获取估算详细信息servicetitan_create_estimate-创建新估算servicetitan_update_estimate-更新估算servicetitan_mark_estimate_sold-将估价标记为已售出servicetitan_dismiss_estimate-驳回估价servicetitan_get_estimate_items-获取估算行项目servicetitan_add_estimate_item-添加行项目
发票和付款(10个工具)
servicetitan_list_invoices-列出发票servicetitan_get_invoice-获取发票详细信息servicetitan_create_invoice-创建新发票servicetitan_update_invoice-更新发票servicetitan_post_invoice-邮寄发票servicetitan_void_invoice-无效发票servicetitan_get_invoice_items-获取发票项目servicetitan_add_invoice_item-添加发票项目servicetitan_list_invoice_payments-列出付款servicetitan_create_payment-记录付款
调度(8个工具)
servicetitan_list_appointments-列出约会servicetitan_get_appointment-获取预约详情servicetitan_create_appointment-安排预约servicetitan_update_appointment-更新预约servicetitan_assign_technician-指派技术人员servicetitan_cancel_appointment-取消预约servicetitan_list_dispatch_zones-列出调度区域servicetitan_get_dispatch_board-获取调度板视图
技术人员(8个工具)
servicetitan_list_technicians-列出技术人员servicetitan_get_technician-获取技术人员详细信息servicetitan_create_technician-创建技术人员servicetitan_update_technician-更新技术人员servicetitan_deactivate_technician-停用技术人员servicetitan_get_technician_schedule-获取日程安排servicetitan_get_technician_shifts-获得轮班servicetitan_create_technician_shift-创建班次
设备管理(6个工具)
servicetitan_list_equipment-列出设备servicetitan_get_equipment-获取设备详细信息servicetitan_create_equipment-注册新设备servicetitan_update_equipment-更新设备servicetitan_deactivate_equipment-停用设备servicetitan_get_equipment_history-获取服务历史记录
会员资格(7工具)
servicetitan_list_memberships-列出成员资格servicetitan_get_membership-获取会员详细信息servicetitan_create_membership-创建会员资格servicetitan_cancel_membership-取消会员资格servicetitan_renew_membership-续订会员资格servicetitan_list_membership_types-列出成员类型servicetitan_get_membership_type-获取会员类型
库存管理(7个工具)
servicetitan_list_inventory_items-列出库存项目servicetitan_get_inventory_item-获取商品详细信息servicetitan_create_inventory_item-创建商品/SKUservicetitan_update_inventory_item-更新项目servicetitan_deactivate_inventory_item-停用项目servicetitan_get_inventory_levels-获取库存水平servicetitan_adjust_inventory-调整库存
位置(6个工具)
servicetitan_list_locations-列出地点servicetitan_get_location-获取位置详细信息servicetitan_create_location-创建服务地点servicetitan_update_location-更新位置servicetitan_deactivate_location-停用位置servicetitan_list_location_equipment-列出定位设备
营销和线索(10个工具)
servicetitan_list_campaigns-列出活动servicetitan_get_campaign-获取活动详细信息servicetitan_create_campaign-创建活动servicetitan_update_campaign-更新活动servicetitan_list_leads-列出潜在客户servicetitan_get_lead-获取潜在客户详细信息servicetitan_create_lead-创建潜在客户servicetitan_convert_lead-将潜在客户转化为客户servicetitan_list_call_tracking-列表呼叫跟踪servicetitan_get_lead_sources_report-获取潜在客户来源报告
报告和分析(9个工具)
servicetitan_get_revenue_report-收入报告servicetitan_get_technician_performance-技术人员绩效servicetitan_get_job_costing_report-作业成本报告servicetitan_get_sales_report-销售报告servicetitan_get_customer_acquisition_report-客户获取servicetitan_get_ar_aging_report-AR账龄报告servicetitan_get_membership_revenue_report-会员收入servicetitan_get_job_type_analysis-工作类型分析servicetitan_get_dispatch_metrics-调度指标
标签(7工具)
servicetitan_list_tag_types-列出标签类型servicetitan_create_tag_type-创建标记类型servicetitan_add_job_tag-添加作业标签servicetitan_remove_job_tag-删除作业标签servicetitan_list_job_tags-列出工作标签servicetitan_add_customer_tag-添加客户标签servicetitan_remove_customer_tag-删除客户标签
工资单(5个工具)
servicetitan_list_payroll_records-列出工资记录servicetitan_get_technician_timesheet-获取时间表servicetitan_get_technician_commissions-获得佣金servicetitan_get_payroll_summary-获取工资汇总servicetitan_export_payroll-导出工资数据
🎨 React应用程序(共15个)
- 招聘板 -通过筛选查看和管理所有服务作业
- 作业详细信息 -完整的工作信息和预约
- 客户仪表盘 -管理客户账户和活动
- 客户详细信息 -完整的客户资料,包括位置和联系人
- 调度板 -每日技术人员时间表和任务
- 估算生成器 -创建和跟踪估算和报价
- 发票仪表板 -管理发票和跟踪付款
- 技术人员时间表 -查看技术人员的可用性和班次
- 设备跟踪器 -监控客户设备和保修
- 会员经理 -管理定期服务成员资格
- 营销仪表板 -跟踪活动和潜在客户开发
- 库存管理员 -跟踪材料和库存水平
- 工资单概述 -跟踪技术人员工资和佣金
- 报告仪表板 -财务报告和分析
- 位置图 -服务地点目录
所有应用程序功能:
- 🌑 深色主题已针对可读性进行了优化
- 📱 响应式设计
- ⚡ 通过MCP工具实时获取数据
- 🎯 直观的过滤和搜索
安装
cd /Users/jakeshore/.clawdbot/workspace/mcpengine-repo/servers/servicetitan
npm install
cd src/ui/react-app && npm install && cd ../../..配置
创建一个 .env 文件:
SERVICETITAN_CLIENT_ID=your_client_id_here
SERVICETITAN_CLIENT_SECRET=your_client_secret_here
SERVICETITAN_TENANT_ID=your_tenant_id_here
SERVICETITAN_APP_KEY=your_app_key_here获取ServiceTitan API凭据
- 登录您的ServiceTitan帐户
- 前往设置→ 集成→ API应用程序管理
- 创建新的API应用程序
- 复制您的客户端ID、客户端密码、租户ID和应用程序密钥
- 根据需要配置OAuth2作用域
构建
npm run build这将:
- 编译TypeScript服务器代码
- 构建所有15个React应用程序
- 使主入口点可执行
用法
作为MCP服务器
添加到MCP客户端配置中:
{
"mcpServers": {
"servicetitan": {
"command": "node",
"args": ["/path/to/servers/servicetitan/dist/main.js"],
"env": {
"SERVICETITAN_CLIENT_ID": "your_client_id",
"SERVICETITAN_CLIENT_SECRET": "your_client_secret",
"SERVICETITAN_TENANT_ID": "your_tenant_id",
"SERVICETITAN_APP_KEY": "your_app_key"
}
}
}
}直接使用
npm start发展
# Watch TypeScript compilation
npm run watch
# Run in development mode
npm run dev
# Build React apps only
npm run build:apps建筑
servicetitan/
├── src/
│ ├── clients/
│ │ └── servicetitan.ts # API client with OAuth2
│ ├── types/
│ │ └── index.ts # TypeScript interfaces
│ ├── tools/ # 14 tool modules
│ │ ├── jobs-tools.ts
│ │ ├── customers-tools.ts
│ │ ├── estimates-tools.ts
│ │ ├── invoices-tools.ts
│ │ ├── dispatching-tools.ts
│ │ ├── technicians-tools.ts
│ │ ├── equipment-tools.ts
│ │ ├── memberships-tools.ts
│ │ ├── inventory-tools.ts
│ │ ├── locations-tools.ts
│ │ ├── marketing-tools.ts
│ │ ├── reporting-tools.ts
│ │ ├── tags-tools.ts
│ │ └── payroll-tools.ts
│ ├── ui/
│ │ └── react-app/ # 15 React applications
│ │ └── src/
│ │ ├── apps/
│ │ ├── components/
│ │ ├── hooks/
│ │ └── styles/
│ ├── server.ts # MCP server setup
│ └── main.ts # Entry point
├── package.json
├── tsconfig.json
└── README.mdAPI覆盖范围
此MCP服务器涵盖所有主要的ServiceTitan API v2端点:
- ✅ 工作管理(JPM)
- ✅ 客户关系管理(CRM)
- ✅ 销售和估算
- ✅ 会计和发票
- ✅ 调度与调度
- ✅ 技术人员管理
- ✅ 设备跟踪
- ✅ 会员资格和经常性收入
- ✅ 库存和材料
- ✅ 营销和潜在客户开发
- ✅ 报告和分析
- ✅ 工资和佣金
- ✅ 设置和配置
许可证
麻省理工学院
作者
MCP发动机-BusyBee3333
链接
-
