FieldRoutes MCP Server
FieldRoutes MCP Server for Claude
FieldRoutes アカウントと Claude を連携し、会話の中で直接顧客の検索、ルートの確認、予定の表示、サービス履歴の取得などが行えるようになります。
含まれるツール
ツール | 機能 |
| 名前、電話番号、メール、住所で顧客を検索 |
| 顧客 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/mcpRailway にデプロイ(推奨 — 無料枠あり)
railway.app にアクセスしてサインアップ(無料)
新規プロジェクト → GitHub リポジトリからデプロイ をクリック
GitHub アカウントを接続し、このコードを新しいリポジトリにプッシュ
Railway が Node.js を検出し、自動的にデプロイ
Railway でプロジェクト → 変数 に移動し、以下を追加:
FR_AUTH_KEYFR_AUTH_TOKENFR_SUBDOMAIN
Railway が
https://fieldroutes-mcp-production.up.railway.appのような公開 URL を提供
Render にデプロイ(代替 — こちらも無料)
render.com にアクセスしてサインアップ
新規 → Web サービス をクリック
GitHub リポジトリを接続
ビルドコマンド:
npm install && npm run build開始コマンド:
npm start環境 で
FR_AUTH_KEY、FR_AUTH_TOKEN、FR_SUBDOMAINを追加デプロイ — Render が
https://fieldroutes-mcp.onrender.comのような URL を提供
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環境変数を追加し、受信リクエストでベアラートークンとして検証することもできます
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