Skip to main content
Glama
FieldRoutes MCP Server

FieldRoutes MCP Server

by glbryce7795

Claude용 FieldRoutes MCP Server

Claude를 FieldRoutes 계정에 연결하여 고객 검색, 경로 확인, 약속 보기, 서비스 기록 조회 등을 대화 중에 직접 수행할 수 있습니다.


포함된 도구

도구

기능

search_customers

이름, 전화번호, 이메일 또는 주소로 고객 찾기

get_customer

ID로 고객의 전체 세부 정보

get_service_history

고객의 과거 및 미해결 서비스 티켓

get_ticket

단일 서비스 티켓의 전체 세부 정보

get_appointments

날짜, 고객, 경로 또는 기술자별 예약된 약속

get_routes

특정 날짜에 실행 중인 경로

get_route_details

특정 경로의 모든 경유지

get_subscriptions

고객의 정기 서비스 플랜

get_employees

직원/기술자 목록 및 ID

get_invoices

고객의 송장 및 잔액


Related MCP server: ServiceTitan MCP Server

설정

1. 이 프로젝트 복사 및 의존성 설치

npm install

2. 자격 증명 구성

cp .env.example .env

.env 파일을 열고 다음을 입력하세요:

  • FR_AUTH_KEY — FieldRoutes에서: Admin → API → Manage Keys

  • 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. New Project → Deploy from GitHub repo를 클릭하세요

  3. GitHub 계정을 연결하고 이 코드를 새 리포지토리로 푸시하세요

  4. Railway가 Node.js를 감지하고 자동으로 배포합니다

  5. Railway에서 프로젝트 → Variables로 이동하여 다음을 추가하세요:

    • FR_AUTH_KEY

    • FR_AUTH_TOKEN

    • FR_SUBDOMAIN

  6. Railway가 https://fieldroutes-mcp-production.up.railway.app 같은 공개 URL을 제공합니다


Render에 배포 (대안 — 무료)

  1. render.com을 방문하여 가입하세요

  2. New → Web Service를 클릭하세요

  3. GitHub 리포지토리를 연결하세요

  4. Build Command를 npm install && npm run build로 설정하세요

  5. Start Command를 npm start로 설정하세요

  6. 환경 아래에 FR_AUTH_KEY, FR_AUTH_TOKEN, FR_SUBDOMAIN을 추가하세요

  7. 배포 — Render가 https://fieldroutes-mcp.onrender.com 같은 URL을 제공합니다


Claude에 연결

  1. Claude 데스크톱 앱에서 Settings → Connectors로 이동하세요

  2. Add custom connector를 클릭하세요

  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 토큰으로 검증할 수 있습니다

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude Desktop to query ServiceTitan data about technician jobs and business performance via natural language, while protecting customer personal information.
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      39
      MIT