ServiceTitan MCP Server

ServiceTitan MCP服务器

面向家庭服务承包商的ServiceTitan人工智能原生接口

MCP（模型上下文协议）服务器，使人工智能助手可以直接访问ServiceTitan——领先的现场服务管理平台。专为暖通空调、管道、电气和其他家庭服务承包商而设计，他们希望自己的人工智能能够管理工作、查找客户、安排预约、派遣技术人员和跟踪发票。

🛠️ 可用工具

🚀 快速开始

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}
• 令牌在到期前被缓存并自动刷新

所需的环境变量

📦 使用的ServiceTitan API模块

🧪 发展

# 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部署、按事件计费、市场列表

📄 许可证

麻省理工学院