Claude용 FieldRoutes MCP Server

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

포함된 도구

Related MCP server: Jobber MCP Connector

설정

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