AI导哈

服务Titan MCP服务器

一个为家庭服务承包商提供的AI原生接口，直接访问ServiceTitan平台，用于管理工作、查找客户、安排预约、调度技术人员和跟踪发票。

  • by cahlan
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 cahlan/servicetitan-mcp

使用说明

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证书

  1. 去 ServiceTitan开发者门户
  2. 在中创建应用程序 我的应用 得到你的 应用程序密钥
  3. 让您的ServiceTitan管理员生成 客户端ID 和 客户端密钥 为了您的环境
  4. 注意你的 租户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 sandbox

3.安装并运行

# Install
pip install -e .

# Run the MCP server
servicetitan-mcp

# Or run directly
python -m servicetitan_mcp.server

4.连接到您的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部署、按事件计费、市场列表

📄 许可证

麻省理工学院

相关 MCP