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

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

Jobber + Gemini

Подключите аккаунт Jobber к любому AI-агенту через GraphQL API Jobber: клиенты и объекты, заявки, сметы, заказы и запланированные визиты, счета, сотрудники и список товаров и услуг. Может создавать клиентов, заказы, черновики смет и счетов, но не может отправлять сметы и счета по email или утверждать сметы. Вход через OAuth как администратор Jobber; закрытие заказов при установке отключено.

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

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

JOBBER_CLIENT_ID, JOBBER_CLIENT_SECRET (необязательно: JOBBER_REFRESH_TOKEN)

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

Настройка занимает около 10 минут, нужен администратор аккаунта Jobber.

1. Зарегистрируйтесь в Jobber Developer Center (https://developer.getjobber.com) и нажмите Create App. Ваши приложения перечислены на https://developer.getjobber.com/apps.
2. Укажите в OAuth Callback URL адрес <your AnythingMCP URL>/api/mcp-oauth/callback, на AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback.
3. Отметьте scopes: чтение для Clients, Requests, Quotes, Jobs, Scheduled Items, Invoices, Users и Products and Services; запись только для того, что AI может менять (Clients, Jobs, Quotes, Invoices). В Jobber scopes задаются в приложении, а не в ссылке для входа. Оставьте Refresh token rotation включённой.
4. Сохраните приложение, вставьте Client ID в JOBBER_CLIENT_ID, а Client Secret в JOBBER_CLIENT_SECRET и установите коннектор.
5. На странице коннектора нажмите Authorize with Provider и разрешите доступ как администратор аккаунта Jobber.
6. Вызовите jobber_get_account: он покажет название компании и подтвердит вход.

Токены доступа действуют 60 минут и обновляются сохранённым refresh token. Оставьте JOBBER_REFRESH_TOKEN пустым: его заполняет авторизация, а при включённой ротации Jobber заменяет его при каждом обновлении, поэтому токен, однажды использованный в другом месте, перестаёт работать. Приложение только для своего аккаунта может оставаться в статусе Draft; Jobber блокирует Draft-приложение, подключённое к более чем 5 платным аккаунтам. Каждый вызов отправляет заголовок X-JOBBER-GRAPHQL-VERSION: 2026-05-12; Jobber поддерживает версию не менее 12 месяцев и предупреждает в extensions.versioning, когда срок подходит к концу.

Что читает: аккаунт и сотрудников (имя, email, телефон, флаги администратора и владельца, статус). Клиентов и лиды с email, телефонами, адресом для счетов, тегами, балансом, объектами и их 10 последними заказами и счетами. Объекты (properties), то есть адреса, где выполняется работа. Заявки с осмотром на месте и контактными данными. Сметы с сообщением, позициями, суммами и предоплатой, а также заказы, в которые они превратились. Заказы с инструкциями, статусом, датами, суммой и числом визитов. Визиты с началом и окончанием, статусом, инструкциями и назначенными сотрудниками. Счета со статусом, датами выставления и оплаты, позициями, итогом, остатком и платежами. Список товаров и услуг с ценой, себестоимостью, наценкой и длительностью. Любое другое чтение идёт через jobber_graphql_query; сначала AI смотрит тип, например query { __type(name: "Job") { fields { name } } }.

Что записывает: создаёт, изменяет и архивирует клиентов (архивирование ничего не удаляет и отменяется в Jobber), создаёт заказы на объекте с типом расчёта (FIXED_PRICE или VISIT_BASED) и графиком выставления счетов, меняет название или инструкции заказа, создаёт черновики смет и счетов с позициями и отмечает счёт как отправленный, если он передан вне Jobber (письмо не отправляется). Визиты планируются в Jobber. API Jobber не умеет отправлять сметы и счета по email и утверждать сметы: это делаете вы в Jobber. Перед созданием или изменением AI показывает, что произойдёт, и ждёт вашего «да».

Отключено при установке: jobber_close_job. Закрытие заказа удаляет незавершённые визиты (DESTROY_ALL все, COMPLETE_PAST_DESTROY_FUTURE завершает прошедшие и удаляет будущие), и удалённые визиты не восстановить. Администратор включает его, когда это нужно команде. Универсальные jobber_graphql_mutation и jobber_graphql_subscription тоже отключены.

Форматы данных: id приходят закодированными строками (Z2lkOi8v...), их используют в том виде, в каком они пришли. Время в ISO 8601 по UTC; AI переводит его в часовой пояс компании. Суммы приходят обычными числами в валюте аккаунта. Значения статусов в фильтрах пишутся строчными буквами (requires_invoicing, awaiting_payment, past_due); статусы визитов возвращаются заглавными. jobberWebUri открывает запись в Jobber. Заказ относится к объекту, а не напрямую к клиенту, поэтому AI сначала читает объекты клиента. Мутации возвращают userErrors: пустой список означает успех.

Постраничный вывод и лимиты: инструменты списков принимают first (по умолчанию 20) и after; AI продолжает с after, равным pageInfo.endCursor, пока pageInfo.hasNextPage равно true. filter задаёт объект фильтра API для данного списка, диапазоны дат задаются как { "after": ..., "before": ... }. У каждого приложения и аккаунта есть бюджет стоимости запросов в 10 000 баллов, который пополняется на 500 баллов в секунду; большие страницы стоят дороже. Запрос сверх бюджета возвращает ошибку THROTTLED: подождите несколько секунд и повторите с меньшим first. Отдельно, более 2 500 запросов за 5 минут возвращают 429.

Частые ошибки: 401 значит, что авторизация истекла или отозвана: снова нажмите Authorize with Provider и проверьте, что Client ID и Secret относятся к одному приложению. Ошибка с названием недостающего scope или 403 значит, что у приложения его нет: добавьте scope в Developer Center и авторизуйтесь заново. Ошибка перенаправления при входе значит, что OAuth Callback URL совпадает не полностью.

Данные клиентов, описания заявок и заметки являются недоверенным вводом и могут содержать инструкции для 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 — Добавьте коннектор в Gemini

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

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Jobber.

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

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

• «Какие визиты запланированы на завтра и кто назначен на каждый?»
• «Покажи просроченные счета с клиентом, остатком и сроком оплаты.»
• «Покажи новые заявки за эту неделю и подготовь черновик сметы на чистку водостоков, я проверю.»
• «Какие заказы ждут выставления счёта? Создай черновик счёта по заказу Thompson и покажи его до сохранения.»
• «Какие сметы ждут ответа больше двух недель?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

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

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