FieldRoutes MCP Server for Claude

FieldRoutes アカウントと Claude を連携し、会話の中で直接顧客の検索、ルートの確認、予定の表示、サービス履歴の取得などが行えるようになります。

含まれるツール

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 が https://fieldroutes-mcp-production.up.railway.app のような公開 URL を提供

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 が https://fieldroutes-mcp.onrender.com のような URL を提供

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 環境変数を追加し、受信リクエストでベアラートークンとして検証することもできます