FieldRoutes MCP Server
Claude용 FieldRoutes MCP Server
Claude를 FieldRoutes 계정에 연결하여 고객 검색, 경로 확인, 약속 보기, 서비스 기록 조회 등을 대화 중에 직접 수행할 수 있습니다.
포함된 도구
도구 | 기능 |
| 이름, 전화번호, 이메일 또는 주소로 고객 찾기 |
| ID로 고객의 전체 세부 정보 |
| 고객의 과거 및 미해결 서비스 티켓 |
| 단일 서비스 티켓의 전체 세부 정보 |
| 날짜, 고객, 경로 또는 기술자별 예약된 약속 |
| 특정 날짜에 실행 중인 경로 |
| 특정 경로의 모든 경유지 |
| 고객의 정기 서비스 플랜 |
| 직원/기술자 목록 및 ID |
| 고객의 송장 및 잔액 |
Related MCP server: ServiceTitan MCP Server
설정
1. 이 프로젝트 복사 및 의존성 설치
npm install2. 자격 증명 구성
cp .env.example .env.env 파일을 열고 다음을 입력하세요:
FR_AUTH_KEY— FieldRoutes에서: Admin → API → Manage KeysFR_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을 방문하여 가입하세요 (무료)
New Project → Deploy from GitHub repo를 클릭하세요
GitHub 계정을 연결하고 이 코드를 새 리포지토리로 푸시하세요
Railway가 Node.js를 감지하고 자동으로 배포합니다
Railway에서 프로젝트 → Variables로 이동하여 다음을 추가하세요:
FR_AUTH_KEYFR_AUTH_TOKENFR_SUBDOMAIN
Railway가
https://fieldroutes-mcp-production.up.railway.app같은 공개 URL을 제공합니다
Render에 배포 (대안 — 무료)
render.com을 방문하여 가입하세요
New → Web Service를 클릭하세요
GitHub 리포지토리를 연결하세요
Build Command를
npm install && npm run build로 설정하세요Start Command를
npm start로 설정하세요환경 아래에
FR_AUTH_KEY,FR_AUTH_TOKEN,FR_SUBDOMAIN을 추가하세요배포 — Render가
https://fieldroutes-mcp.onrender.com같은 URL을 제공합니다
Claude에 연결
Claude 데스크톱 앱에서 Settings → Connectors로 이동하세요
Add custom connector를 클릭하세요
배포된 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