Skip to main content
Glama
FieldRoutes MCP Server

FieldRoutes MCP Server

by glbryce7795

FieldRoutes MCP 服务器(适用于 Claude)

将 Claude 连接到您的 FieldRoutes 账户,以便您可以直接在对话中查找客户、查看路线、预约、获取服务历史记录等。


包含的工具

工具

功能说明

search_customers

按姓名、电话、电子邮件或地址查找客户

get_customer

按 ID 获取客户的完整详细信息

get_service_history

获取客户过去和未完成的服务工单

get_ticket

获取单个服务工单的完整详细信息

get_appointments

按日期、客户、路线或技术人员查询已安排的预约

get_routes

查询特定日期正在运行的路线

get_route_details

获取特定路线上的所有站点

get_subscriptions

获取客户的定期服务计划

get_employees

获取员工/技术人员列表及其 ID

get_invoices

获取客户的发票和余额


Related MCP server: ServiceTitan MCP Server

设置

1. 复制此项目并安装依赖项

npm install

2. 配置您的凭据

cp .env.example .env

打开 .env 并填写:

  • FR_AUTH_KEY — 来自 FieldRoutes:管理 → API → 管理密钥

  • FR_AUTH_TOKEN — 相同位置

  • FR_SUBDOMAIN — 您的 URL 中 .pestroutes.com 之前的部分(例如 crownpest)

3. 构建并在本地运行以进行测试

npm run build
npm start

您应该看到:

FieldRoutes MCP server running on port 3000
MCP endpoint: http://localhost:3000/mcp

部署到 Railway(推荐 — 提供免费套餐)

  1. 前往 railway.app 并注册(免费)

  2. 点击 新建项目 → 从 GitHub 仓库部署

  3. 连接您的 GitHub 账户并将此代码推送到一个新仓库

  4. Railway 将自动检测 Node.js 并部署

  5. 在 Railway 中,转到您的项目 → 变量 并添加:

    • FR_AUTH_KEY

    • FR_AUTH_TOKEN

    • FR_SUBDOMAIN

  6. Railway 将为您提供一个公共 URL,例如 https://fieldroutes-mcp-production.up.railway.app


部署到 Render(备选方案 — 同样免费)

  1. 前往 render.com 并注册

  2. 点击 新建 → Web 服务

  3. 连接您的 GitHub 仓库

  4. 设置 构建命令:npm install && npm run build

  5. 设置 启动命令:npm start

  6. 在 环境 下,添加 FR_AUTH_KEY、FR_AUTH_TOKEN、FR_SUBDOMAIN

  7. 部署 — Render 会为您提供一个 URL,例如 https://fieldroutes-mcp.onrender.com


连接到 Claude

  1. 在 Claude 桌面应用中,转到 设置 → 连接器

  2. 点击 添加自定义连接器

  3. 输入您部署的 URL + /mcp:

    https://your-app.up.railway.app/mcp
  4. 保存 — Claude 现在可以使用所有 10 个 FieldRoutes 工具


根据您的 FieldRoutes 文档验证端点

此服务器中的 API 路径(customer/search、appointment/search 等)遵循标准的 FieldRoutes REST 模式。如果任何路径返回 404,请检查您特定租户的 API 文档,网址为:

https://YOUR_SUBDOMAIN.pestroutes.com/api/docs

或联系 FieldRoutes 支持以确认您账户层级的确切路径。


安全说明

  • 您的 API 凭据仅存储在环境变量中 — 绝不会提交到代码中

  • 服务器不需要自身的身份验证(Claude 是唯一的调用者)

  • 为了增加安全性,您可以添加 API_SECRET 环境变量,并在传入请求中将其作为 Bearer 令牌进行验证

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude Desktop to query ServiceTitan data about technician jobs and business performance via natural language, while protecting customer personal information.
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants like Claude to read and optionally write data in FieldRoutes (formerly PestRoutes) using plain English, with read-only mode by default and granular safety profiles.
      39
      MIT