FieldRoutes MCP 服务器（适用于 Claude）

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

包含的工具

Related MCP server: Jobber MCP Connector

设置

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 令牌进行验证