ServiceTitan MCP服务器
面向家庭服务承包商的ServiceTitan人工智能原生接口
MCP（模型上下文协议）服务器，使人工智能助手可以直接访问ServiceTitan——领先的现场服务管理平台。专为暖通空调、管道、电气和其他家庭服务承包商而设计，他们希望自己的人工智能能够管理工作、查找客户、安排预约、派遣技术人员和跟踪发票。
🛠️ 可用工具
| 工具 | 说明 |
|---|---|
search_customers | 按姓名、电话、电子邮件或地址搜索客户 |
get_customer | 获取完整的客户详细信息，包括联系人和服务历史记录 |
list_jobs | 列出带有状态、日期范围、客户或技术人员筛选器的作业 |
get_job | 获取完整的工作详细信息，包括笔记和分配的技术 |
create_job | 为客户创建新作业 |
get_available_appointments | 查找日期范围内的可用预约时段 |
schedule_appointment | 安排或重新安排工作预约 |
list_technicians | 列出当前状态和时间表的在职技术人员 |
dispatch_technician | 指派一名技术人员进行工作预约 |
get_invoice | 获取包含行项目和付款状态的发票详细信息 |
list_unpaid_invoices | 列出未付/逾期发票，以便后续收款 |
🚀 快速开始
1.获取ServiceTitan API证书
- 去 ServiceTitan开发者门户
- 在中创建应用程序 我的应用 得到你的 应用程序密钥
- 让您的ServiceTitan管理员生成 客户端ID 和 客户端密钥 为了您的环境
- 注意你的 租户ID 来自ServiceTitan设置
2.配置环境
cp .env.example .env
# Edit .env with your credentials:
# ST_CLIENT_ID=your_client_id
# ST_CLIENT_SECRET=your_client_secret
# ST_APP_KEY=your_app_key
# ST_TENANT_ID=your_tenant_id
# ST_ENVIRONMENT=production # or "integration" for sandbox3.安装并运行
# Install
pip install -e .
# Run the MCP server
servicetitan-mcp
# Or run directly
python -m servicetitan_mcp.server4.连接到您的AI
添加到您的MCP客户端配置中（例如，Claude Desktop）：
{
"mcpServers": {
"servicetitan": {
"command": "servicetitan-mcp",
"env": {
"ST_CLIENT_ID": "your_client_id",
"ST_CLIENT_SECRET": "your_client_secret",
"ST_APP_KEY": "your_app_key",
"ST_TENANT_ID": "your_tenant_id",
"ST_ENVIRONMENT": "production"
}
}
}
}🔐 认证
服务Titan使用 OAuth2客户端凭据 授予：
- 身份验证端点:
https://auth.servicetitan.io/connect/token（生产）或https://auth-integration.servicetitan.io/connect/token（沙盒） - API基地:
https://api.servicetitan.io（生产）或https://api-integration.servicetitan.io（沙盒） - 必需的标头:
Authorization: Bearer {token}+ST-App-Key: {app_key} - 令牌在到期前被缓存并自动刷新
所需的环境变量
| 变量 | 描述 |
|---|---|
ST_CLIENT_ID | OAuth2客户端ID |
ST_CLIENT_SECRET | OAuth2客户端密码 |
ST_APP_KEY | ServiceTitan应用程序密钥 |
ST_TENANT_ID | 您的服务Titan租户ID |
ST_ENVIRONMENT | production 或 integration （默认值： production) |
📦 使用的ServiceTitan API模块
| 模块 | 基本路径 | 实体 |
|---|---|---|
| 客户关系管理 | /crm/v2/tenant/{id}/ | 客户、联系人、地点、预订 |
| 工作计划 | /jpm/v2/tenant/{id}/ | 工作、任命、工作类型 |
| 派遣 | /dispatch/v2/tenant/{id}/ | 技术人员轮班、任命分配 |
| 会计 | /accounting/v2/tenant/{id}/ | 发票、付款 |
| 设置 | /settings/v2/tenant/{id}/ | 技术人员、员工、业务部门 |
🧪 发展
# Install with dev dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Lint
ruff check src/ tests/☁️ 部署
Apify市场
即将到来的第3天——在Apify上按事件计费
这 apify_actor/ 目录包含Apify平台的部署脚手架。
mcp.so
即将上市 mcp.so
史密瑟里
即将上市 史密斯艾
📋 路线图
- \[x\] 第1天核心脚手架——涵盖承包商工作流程循环的11个工具
- \[ \] 第2天：根据ServiceTitan沙盒进行验证，修复端点路径，添加集成测试
- \[ \] 第3天：优化Actor部署、按事件计费、市场列表
📄 许可证
麻省理工学院