Field Control MCP Server

Удалённый MCP-сервер (Model Context Protocol), который подключает Claude к API интеграции Field Control (https://developers.fieldcontrol.com.br/), позволяя запрашивать и создавать клиентов, заказы на обслуживание, сотрудников, заявки на обслуживание, оборудование и т. д. прямо в разговоре с Claude.

Что он предоставляет

Инструменты (tools), доступные для Claude:

Related MCP server: Jobber MCP Connector

1. Получите свой API-ключ Field Control

1. Войдите в панель Field Control как администратор.

2. Перейдите в Настройки > Настройка для разработчиков (или напрямую: https://app.fieldcontrol.com.br/#/configuracoes/configuracao-para-desenvolvedores).

3. В разделе «Ключ интеграции» нажмите, чтобы создать новый ключ, дайте ему имя и нажмите Создать.

4. Сохраните этот ключ — вы будете использовать его как переменную окружения FIELD_CONTROL_API_KEY.

2. Запустите локально (необязательно, для тестирования)

npm install
FIELD_CONTROL_API_KEY="sua-chave-aqui" npm start

Сервер запускается на http://localhost:3000, с MCP-эндпоинтом на POST /mcp.

3. Разместите сервер в интернете (необходимо для доступа Claude)

Claude подключается из облака Anthropic, поэтому сервер должен быть публично доступен по HTTPS. Подойдёт любой провайдер, поддерживающий Node.js. Два простых варианта с бесплатным тарифом:

Вариант A: Render.com

1. Загрузите этот проект в репозиторий на GitHub.

2. В Render создайте Web Service, указав репозиторий.

3. Build command: npm install — Start command: npm start.

4. В разделе «Environment» добавьте переменную FIELD_CONTROL_API_KEY со своим ключом.

5. После деплоя у вас будет URL вида https://seu-app.onrender.com. MCP-эндпоинт будет https://seu-app.onrender.com/mcp.

Вариант B: Railway.app

1. Загрузите проект на GitHub.

2. В Railway: «New Project» > «Deploy from GitHub repo».

3. Добавьте переменную окружения FIELD_CONTROL_API_KEY.

4. Railway автоматически определит npm start и предоставит публичный URL.

(Любой другой хостинг для Node.js — Fly.io, Vercel с functions, собственный VPS с Nginx и т. д. — работает аналогично, если он предоставляет /mcp по HTTPS.)

4. Подключите к Claude как пользовательский коннектор

1. В Claude перейдите в Настройки > Коннекторы.

2. Нажмите +, затем Добавить пользовательский коннектор.

3. Вставьте URL вашего сервера, заканчивающийся на /mcp (например: https://seu-app.onrender.com/mcp).

4. Дайте имя (например, «Field Control») и нажмите Добавить.

Готово — в следующих разговорах Claude сможет выводить ваши заказы на обслуживание, клиентов, сотрудников и т. д., когда это поможет ответить на ваш запрос.

В тарифах Team/Enterprise владелец должен сначала включить коннектор в Настройках организации > Коннекторы > Добавить > Пользовательский > Web; затем каждый участник подключает свою учётную запись.

Безопасность

• API-ключ хранится только на сервере (переменная окружения) и никогда не передаётся Claude или браузеру.

• По умолчанию все, кто использует этот сервер, используют один и тот же API-ключ (из окружения). Если вы хотите предоставить этот коннектор нескольким людям с разными ключами, адаптируйте getApiKeyFromRequest() в src/server.js, чтобы читать ключ из заголовка каждого запроса, и пусть каждый настроит это в «Расширенных настройках» коннектора.

• Никогда не коммитьте свой API-ключ в репозиторий — всегда используйте переменные окружения хостинг-провайдера.