MCP-сервер FieldRoutes для Claude

Подключает Claude к вашей учетной записи FieldRoutes, чтобы вы могли искать клиентов, проверять маршруты, просматривать визиты, получать историю обслуживания и многое другое — прямо в диалоге.

Доступные инструменты

Related MCP server: ServiceTitan MCP Server

Настройка

1. Скопируйте этот проект и установите зависимости

npm install

2. Настройте свои учетные данные

cp .env.example .env

Откройте .env и заполните:

• FR_AUTH_KEY — из FieldRoutes: Администрирование → API → Управление ключами

• FR_AUTH_TOKEN — там же

• FR_SUBDOMAIN — часть до .pestroutes.com в вашем URL (например, 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 предоставит вам публичный URL, например https://fieldroutes-mcp-production.up.railway.app

Развертывание на Render (альтернатива — также бесплатно)

1. Перейдите на render.com и зарегистрируйтесь

2. Нажмите New → Web Service

3. Подключите свой репозиторий GitHub

4. Установите Build Command: npm install && npm run build

5. Установите Start Command: npm start

6. В разделе Environment добавьте FR_AUTH_KEY, FR_AUTH_TOKEN, FR_SUBDOMAIN

7. Разверните — Render предоставит вам URL, например https://fieldroutes-mcp.onrender.com

Подключение к 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 и т.д.) следуют стандартному шаблону REST FieldRoutes. Если какой-либо из них возвращает 404, проверьте документацию API для вашего арендатора по адресу:

https://YOUR_SUBDOMAIN.pestroutes.com/api/docs

или обратитесь в службу поддержки FieldRoutes для уточнения точного пути для вашего тарифного плана.

Замечания по безопасности

• Ваши учетные данные API хранятся только в переменных окружения — никогда не фиксируются в коде

• Сервер не требует собственной аутентификации (Claude является единственным вызывающим)

• Для дополнительной безопасности вы можете добавить переменную окружения API_SECRET и проверять ее как bearer-токен во входящих запросах