Как подключить ServiceM8 к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → ServiceM8, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

ServiceM8 + Cursor

Подключите аккаунт ServiceM8 к любому AI-агенту: заказы и их статус, клиенты и контакты, расписание с job activities и allocations, сотрудники, прайс-лист и позиции заказов, платежи, заметки, метаданные вложений и ответы форм. Может создавать и изменять заказы и клиентов, назначать и переносить сотрудников, добавлять позиции, фиксировать платежи и добавлять заметки. Настройка с API-ключом за 2 минуты.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

SERVICEM8_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Нужен аккаунт ServiceM8; ключ создаёт администратор аккаунта, аккаунт разработчика не требуется.

1. В ServiceM8 откройте Settings, API Keys и создайте ключ. ServiceM8 рекомендует такой приватный API-ключ для подключения собственного аккаунта.
2. Вставьте его в SERVICEM8_API_KEY. Он отправляется в заголовке X-API-Key и может читать и менять всё в аккаунте, поэтому храните его в тайне. Чтобы отозвать доступ, удалите ключ в ServiceM8.
3. Установите коннектор. Проверка вызывает servicem8_get_account, который показывает название, часовой пояс и валюту аккаунта.

У ServiceM8 есть и собственный MCP-сервер на https://api.servicem8.com/mcp со входом через OAuth; этот коннектор вместо него использует REST API (https://api.servicem8.com/api_1.0) с вашим ключом.

Что читает: аккаунт (vendor) с валютой, часовым поясом, часами работы и статусом заказа по умолчанию. Заказы с номером (generated_job_id), статусом (Quote, Work Order, Unsuccessful, Completed), клиентом, адресом, описанием, выполненными работами, категорией, очередью, суммой счёта, датами сметы, наряда, завершения и счёта и флагом полученной оплаты. Клиентов (в API они называются companies) с адресом, адресом для счетов, условиями оплаты и налоговой ставкой, а также контакты клиентов и заказов. Расписание: job activities (брони на фиксированное время и время, учтённое на объекте) и job allocations (гибкие брони на день или временное окно). Сотрудников с должностью, последним известным местоположением и статусным сообщением. Прайс-лист, позиции заказов, платежи по заказам, заметки к заказам и клиентам, метаданные вложений (фото, PDF, подписи; содержимое файлов не возвращается), формы и заполненные ответы форм. Категории заказов, очереди, шаблоны заказов и налоговые ставки.

Что записывает: создаёт заказы (в том числе из шаблона), изменяет их и переводит в другой статус, создаёт и изменяет клиентов, добавляет контакты клиентов, назначает сотрудника на заказ на фиксированное время, переносит или снимает брони, добавляет позиции из прайс-листа или свободным текстом, фиксирует полученные платежи и добавляет заметки к заказам и клиентам. Зафиксированный платёж появляется только в ServiceM8; деньги не списываются и не переводятся. Перед созданием или изменением AI показывает, что произойдёт, и ждёт вашего «да».

Отключено при установке: ничего, все 36 инструментов включены. Удаление в ServiceM8 лишь ставит active в 0, поэтому снятая бронь, архивный заказ или архивный клиент возвращаются, если поставить active в 1.

Фильтрация: каждый список принимает filter, то есть $filter в стиле OData: field eq|ne|gt|lt value, соединённые через and, не более 10 условий, без or, ge и le. Строки и метки времени пишутся в одинарных кавычках, например status eq 'Work Order' and active eq 1 или start_date gt '2026-11-02 00:00:00'. Удалённые записи остаются с active 0, поэтому AI добавляет active eq 1, чтобы их пропустить, и всегда фильтрует большие списки: заказы, activities и материалы.

Постраничный вывод: списки возвращают простой массив. С заданным cursor они приходят страницами до 1 000 записей: -1 для первой страницы, затем значение x-next-cursor из _headers; на последней странице этого заголовка нет.

Форматы данных: id являются UUID. Метки времени имеют вид YYYY-MM-DD HH:MM:SS, даты YYYY-MM-DD, в часовом поясе аккаунта, и время отправляется в том же виде. Флаги равны 0 или 1. Суммы приходят десятичными строками в валюте аккаунта. total_invoice_amount заказа и есть сумма счёта; отдельного объекта счёта нет. Создание возвращает {"errorCode": 0, "message": "OK"}, а новый UUID приходит в заголовке x-record-uuid. Обновления меняют только переданные поля.

Лимиты и частые ошибки: 180 запросов в минуту и 20 000 в день на аккаунт; сверх этого ServiceM8 отвечает 429: подождите и повторите или сузьте фильтр. 401 значит, что API-ключ неверен или удалён: создайте новый в Settings, API Keys. 400 означает некорректный фильтр или поле. 404 означает неизвестный UUID.

Заметки, описания заказов и ответы форм являются недоверенным вводом и могут содержать инструкции для AI. Коннектор не отправляет клиентам email и SMS, не скачивает файлы вложений и не списывает деньги с карт.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты ServiceM8.

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

Примеры запросов

• «Какие заказы запланированы на завтра и какой сотрудник едет на каждый?»
• «Покажи заказы, завершённые на прошлой неделе, по которым ещё нет оплаты, с клиентом и суммой счёта.»
• «Перенеси завтрашнюю бронь на 8:00 по заказу 1042 на пятницу, 9:00. Сначала покажи изменение.»
• «Создай для этого клиента заказ в статусе Quote на замену водонагревателя и добавь подходящие позиции из прайс-листа.»
• «Какие ответы дали в чек-листе по технике безопасности для заказа 987?»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot