AI导哈

ServiceTitan API 连接工具

通过API将Claude连接到ServiceTitan，提供60多种工具，覆盖CRM、会计、调度、库存等多个业务领域，适用于所有ServiceTitan客户。

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

使用说明

ServiceTitan MCP服务器

通过API将Claude连接到ServiceTitan。60个工具，涵盖CRM、工作、会计、估算、调度、价目表、库存、会员资格、工资单、营销、报告、时间表、电信等。

为任何ServiceTitan客户构建——每个租户独立管理自己的凭据。

快速开始

# Clone and install
git clone https://github.com/glassdoc/servicetitan-mcp.git
cd servicetitan-mcp
pip install -e .

配置

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上，或 %APPDATA%\Claude\claude_desktop_config.json 在Windows上）：

{
  "mcpServers": {
    "servicetitan": {
      "command": "python",
      "args": ["-m", "servicetitan_mcp.server"],
      "env": {
        "ST_APP_KEY": "your-app-key",
        "ST_CLIENT_ID": "cid.your-client-id",
        "ST_CLIENT_SECRET": "cs1.your-client-secret",
        "ST_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

对于多个租户，添加单独的服务器条目（请参见 claude_desktop_config_example.json).

获取您的凭据

  1. 首选 设置>集成>API应用程序访问 在您的ServiceTitan租户中
  2. 找到 Claude MCP集成 应用程序并单击 连接
  3. 填写限制字段（booking_provider、gps_provider、report_category）
  4. 接受条款和条件
  5. 复制您的 客户端ID 并生成 客户端密钥
  6. 你的 租户ID 显示在任何ServiceTitan页面的右上角
  7. 这 应用程序密钥 是： wj8g1SurukhS4

可用工具（60）

客户关系管理

  • list_customers --搜索并列出客户
  • get_customer --按ID获取客户详细信息
  • list_locations --列出服务地点
  • get_location --获取位置详细信息
  • list_leads --列出潜在客户/机会
  • list_bookings --列出预订
  • list_contacts --列出客户联系人

工作计划和管理

  • list_jobs --列出带有筛选器的作业（状态、客户、日期范围）
  • get_job --获取完整的工作详细信息
  • list_appointments --按日期范围列出约会
  • list_job_types --列出配置的作业类型
  • list_projects --列出项目
  • get_project --获取项目详细信息

会计

  • list_invoices --列出发票（按作业、客户、日期筛选）
  • get_invoice --获取包含行项目的发票
  • list_payments --列出已收到的付款
  • list_payment_types --列出付款类型
  • list_inventory_bills --列出应付账款/库存账单
  • list_journal_entries --列出日记账条目
  • list_payment_terms --列出付款条件
  • list_tax_zones --列出税区

销售和估算

  • list_estimates --列出估计值（按工作、状态、销售日期筛选）
  • get_estimate --通过行项目获取估算

派遣

  • list_appointment_assignments --技术人员任命任务
  • list_technician_shifts --轮班时间表
  • list_zones --调度区域
  • list_non_job_appointments --会议、培训等。

价目表

  • list_pricebook_services --可售服务
  • list_pricebook_materials --材料
  • list_pricebook_equipment --设备
  • list_pricebook_categories --类别

库存

  • list_purchase_orders --采购订单
  • list_warehouses --仓库
  • list_inventory_vendors --供应商/供货商
  • list_trucks --车辆库存

会员资格

  • list_memberships --客户会员资格
  • list_membership_types --成员类型定义
  • list_recurring_services --经常性服务

设置

  • list_employees --员工
  • get_employee --员工详细信息
  • list_technicians --技术人员
  • list_business_units --业务部门
  • list_tag_types --标签类型
  • list_user_roles --用户角色

报告

  • list_report_categories --报告类别
  • list_reports_in_category --某一类别中的报告
  • run_report --运行动态报告

工资单

  • list_payrolls --工资单运行
  • list_employee_payrolls --员工工资明细
  • list_gross_pay_items --总付款项目

电信

  • list_calls --电话

表单

  • list_forms --表单模板
  • list_form_submissions --提交的表格

营销

  • list_campaigns --营销活动
  • list_campaign_costs --活动成本

设备、任务、时间表

  • list_installed_equipment --在指定位置安装设备
  • list_tasks --任务管理任务
  • list_activities --时间表活动
  • list_activity_categories --活动类别

高级用户

  • servicetitan_api_call -进行任意API调用（GET/POST/PATCH/PUT）

认证

使用OAuth 2.0客户端凭据流。令牌每15分钟自动刷新一次。无需用户交互。

速率限制

  • 常规API：每个租户每个应用每秒60次调用
  • 报告API：每个租户每个报告每分钟5个请求

许可证

麻省理工学院

相关 MCP