FieldRoutes MCP Server
FieldRoutes MCP 服务器(适用于 Claude)
将 Claude 连接到您的 FieldRoutes 账户,以便您可以直接在对话中查找客户、查看路线、预约、获取服务历史记录等。
包含的工具
工具 | 功能说明 |
| 按姓名、电话、电子邮件或地址查找客户 |
| 按 ID 获取客户的完整详细信息 |
| 获取客户过去和未完成的服务工单 |
| 获取单个服务工单的完整详细信息 |
| 按日期、客户、路线或技术人员查询已安排的预约 |
| 查询特定日期正在运行的路线 |
| 获取特定路线上的所有站点 |
| 获取客户的定期服务计划 |
| 获取员工/技术人员列表及其 ID |
| 获取客户的发票和余额 |
Related MCP server: ServiceTitan MCP Server
设置
1. 复制此项目并安装依赖项
npm install2. 配置您的凭据
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(推荐 — 提供免费套餐)
前往 railway.app 并注册(免费)
点击 新建项目 → 从 GitHub 仓库部署
连接您的 GitHub 账户并将此代码推送到一个新仓库
Railway 将自动检测 Node.js 并部署
在 Railway 中,转到您的项目 → 变量 并添加:
FR_AUTH_KEYFR_AUTH_TOKENFR_SUBDOMAIN
Railway 将为您提供一个公共 URL,例如
https://fieldroutes-mcp-production.up.railway.app
部署到 Render(备选方案 — 同样免费)
前往 render.com 并注册
点击 新建 → Web 服务
连接您的 GitHub 仓库
设置 构建命令:
npm install && npm run build设置 启动命令:
npm start在 环境 下,添加
FR_AUTH_KEY、FR_AUTH_TOKEN、FR_SUBDOMAIN部署 — Render 会为您提供一个 URL,例如
https://fieldroutes-mcp.onrender.com
连接到 Claude
在 Claude 桌面应用中,转到 设置 → 连接器
点击 添加自定义连接器
输入您部署的 URL +
/mcp:https://your-app.up.railway.app/mcp保存 — 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…
This server cannot be deployed
Maintenance
Related MCP Connectors
FieldRoutes MCP server for ChatGPT, Claude and any AI agent: schedule appointment, reschedule appointment, list customers, list unpaid tickets and add customer note in your own FieldRoutes account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to FieldRoutes yourself; Cotlet does not store your password and you need no FieldRoutes API key. About the official FieldRoutes API: FieldRoutes has a documented API, but keys come only through FieldRoutes support for each office, and the free tier allows 50 read requests a day per office (checked 8 Nov 2026). Webhooks need the Premium tier. Setup and FAQ: https://cotlet.dev/integrations/fieldroutes-api-mcp-server
Field operations on a deterministic solver — run jobs, crews & fleet from Claude or ChatGPT.
Read FieldPulse customers, jobs, estimates, invoices, assets and projects; create and update jobs.
Connect Claude to Fathom meeting recordings, transcripts, and summaries
Related MCP Servers
- FlicenseCqualityDmaintenanceConnects Claude to ServiceTitan via API, providing 60 tools across CRM, Jobs, Accounting, and more for business management.601-
- FlicenseNot gradedqualityDmaintenanceEnables Claude Desktop to query ServiceTitan data about technician jobs and business performance via natural language, while protecting customer personal information.-
- AlicenseAqualityDmaintenanceEnables 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.39MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying and creating clients, service orders, collaborators, service requests, equipment, and other resources from the Field Control API directly in conversations with Claude.ISC