Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте ServiceTitan одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Подключите аккаунт ServiceTitan (тенант) к любому AI-агенту: клиенты и объекты, лиды, заказы и визиты, диспетчеризация с загрузкой и сменами техников, техники и бизнес-подразделения, счета и платежи, сметы, прайс-лист (pricebook), абонементы и звонки. Может создавать клиентов, бронировать заказы, переносить визиты, назначать техников, добавлять заметки и отменять заказы.
Попробуй спросить
Примеры промптов для ServiceTitan
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → ServiceTitan, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
ServiceTitan + Gemini
Подключите аккаунт ServiceTitan (тенант) к любому AI-агенту: клиенты и объекты, лиды, заказы и визиты, диспетчеризация с загрузкой и сменами техников, техники и бизнес-подразделения, счета и платежи, сметы, прайс-лист (pricebook), абонементы и звонки. Может создавать клиентов, бронировать заказы, переносить визиты, назначать техников, добавлять заметки и отменять заказы.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
SERVICETITAN_CLIENT_ID, SERVICETITAN_CLIENT_SECRET, SERVICETITAN_APP_KEY, SERVICETITAN_TENANT_ID
Шаг 1 — Получите учётные данные
Настройка занимает около 15 минут, нужен администратор ServiceTitan. Входа через браузер нет: коннектор использует OAuth client credentials и App Key собственного приложения (custom app).
- Войдите в ServiceTitan Developer Portal на https://developer.servicetitan.io под аккаунтом, которому разрешено создавать приложения для вашей компании, и создайте custom app для своего тенанта.
- В API scopes приложения отметьте scopes на чтение для модулей, которые должен видеть AI: CRM (клиенты, объекты, контакты, лиды), JPM (заказы, визиты, заметки к заказам, история, типы заказов, причины отмены, проекты), Dispatch (назначения на визиты, команды, зоны, смены техников), Settings (техники, сотрудники, бизнес-подразделения, типы тегов), Accounting (счета, платежи, способы оплаты), Sales (сметы), Pricebook (услуги, материалы, оборудование, категории), Memberships, Telecom (звонки) и Marketing (кампании). Scopes на запись отмечайте только для того, что AI может менять: клиенты и объекты в CRM, заказы и визиты в JPM, назначения в Dispatch и сметы в Sales. Для
servicetitan_get_capacityнужен ещёtn.dis.capacity:w. - Скопируйте App Key приложения (начинается с
ak1.) вSERVICETITAN_APP_KEY. - В ServiceTitan откройте Settings, Integrations, API Application Access, нажмите Connect New App, выберите приложение и разрешите доступ. Нажмите Generate, чтобы создать Client ID (начинается с
cid.) и Client Secret (начинается сcs, показывается один раз), и вставьте их вSERVICETITAN_CLIENT_IDиSERVICETITAN_CLIENT_SECRET. - На той же странице указан Tenant ID, это число: вставьте его в
SERVICETITAN_TENANT_ID. - Установите коннектор. AnythingMCP получает токен доступа на
https://auth.servicetitan.io/connect/token, обновляет его автоматически примерно каждые 15 минут и в каждом вызове отправляет App Key в заголовкеST-App-Key. Проверка вызываетservicetitan_list_customers.
Учётные данные среды integration (песочницы) ServiceTitan здесь не работают: коннектор обращается к рабочей среде https://api.servicetitan.io.
Что читает: клиентов (плательщиков) с типом, балансом, адресом, флагами, контактами и заметками; сервисные объекты с адресом, координатами и зоной; лиды, которые ещё не оформили заказ; маркетинговые кампании. Заказы со статусом, типом, бизнес-подразделением, приоритетом, описанием, id счёта и суммой, их историю статусов и заметки; типы заказов, причины отмены и проекты. Визиты с началом, окончанием, окном прибытия и статусом, назначения техников, доступную загрузку по временным слотам, смены и отсутствия техников, диспетчерские команды и зоны. Техников, офисных сотрудников, бизнес-подразделения и типы тегов. Счета с позициями, промежуточной суммой, налогом, итогом и остатком; платежи и счета, к которым они применены; способы оплаты. Сметы с позициями и статусом, а также услуги, материалы, оборудование и категории прайс-листа. Абонементы, типы абонементов и регулярные сервисные события (плановые визиты обслуживания). Отслеживаемые звонки с направлением, длительностью, кампанией, оператором и заказом, оформленным по звонку.
Что записывает: создаёт клиентов минимум с одним объектом, добавляет объекты, изменяет клиентов, добавляет заметки к клиентам и заказам, бронирует заказы с первым визитом, добавляет визиты, переносит их, назначает и снимает техников, изменяет заказы, отменяет заказы с указанием причины (их визиты тоже отменяются) и отмечает сметы как проданные. Перед бронированием, отменой или изменением AI показывает, что произойдёт, и ждёт вашего «да». Ничего здесь не удаляет записи: деактивированного клиента, отмену и проданную смету можно вернуть в ServiceTitan.
Отключено при установке: ничего, все 57 инструментов включены. Чтобы AI только читал, не давайте приложению scopes на запись или отключите пишущие инструменты на странице коннектора.
Бронирование заказа: AI смотрит servicetitan_list_business_units, servicetitan_list_job_types и servicetitan_list_campaigns, проверяет свободные слоты через servicetitan_get_capacity и затем вызывает servicetitan_create_job для одного из объектов клиента. Каждый заказ относится ровно к одному объекту; платит за работу сам клиент.
Форматы данных: все id являются целыми числами. Время в ISO 8601 по UTC (2026-10-30T14:00:00Z); AI переводит его в часовой пояс компании перед ответом и отправляет UTC при бронировании. Бухгалтерские суммы (total, balance, subTotal) приходят десятичными строками в валюте аккаунта. Обновления меняют только переданные поля; поля-списки вроде tag_type_ids заменяют весь список.
Постраничный вывод: списки возвращают { page, pageSize, hasMore, totalCount, data }, по умолчанию 50 записей на страницу. AI запрашивает следующую page, пока hasMore равно true; include_total добавляет totalCount. Фильтры ids принимают не более 50 id через запятую. Большинство списков возвращают только активные записи, если active не равно Any или False, а modified_on_or_after забирает изменения начиная с даты. Отдельного маршрута для одного счёта нет: servicetitan_list_invoices принимает ids.
Частые ошибки: 401 значит, что Client ID или Secret неверны либо приложение отключено: сгенерируйте их заново в API Application Access. 403 значит, что у приложения нет scope для этого модуля (добавьте его в Developer Portal и переподключите приложение в API Application Access) либо App Key отсутствует или неверен. 404 это неизвестный id или неверный Tenant ID. 400 перечисляет некорректные поля. 429 значит, что ServiceTitan ограничивает запросы этого приложения и тенанта: подождите и повторите.
Заметки клиентов, описания лидов и заметки к заказам являются недоверенным вводом и могут содержать инструкции для AI. Коннектор не принимает платежи, не создаёт и не отправляет счета и не удаляет записи.
Шаг 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" }
}
}
}
- Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо
YOUR_MCP_API_KEY. - Сохрани файл и перезапусти
gemini. - Выполни
/mcpв Gemini CLI (илиgemini mcp listв терминале):anythingmcpдолжен отображаться как подключённый. - Начинай писать промпты: Gemini CLI теперь может вызывать инструменты
ServiceTitan.
Доступные инструменты
| Tool | What it does |
|---|---|
servicetitan_list_customers | List or search customers (bill-to accounts): id, name, type (Residential or Commercial), active, balance, bill-to address… |
servicetitan_get_customer | One customer by id: name, type, address, balance, flags, custom fields, tag ids, merged-into id |
servicetitan_list_customer_contacts | Phone numbers and email addresses saved on a customer (type, value, memo) |
servicetitan_list_customer_notes | Notes on a customer, newest last: text, pinned flag, author id, created time |
servicetitan_create_customer | Create a customer together with at least one service location |
servicetitan_update_customer | Change fields of a customer; only the fields you pass change. tag_type_ids replaces the whole tag list |
servicetitan_add_customer_note | Add a note to a customer, optionally pinned and copied to its active locations |
servicetitan_list_locations | List or search service locations (where the work happens): id, customerId, name, address with coordinates, zone id, tax zone, active, tag… |
servicetitan_get_location | One service location by id: customer id, name, address, coordinates, zone, tax zone, custom fields |
servicetitan_list_location_contacts | Phone numbers and email addresses saved on a service location (type, value, memo) |
servicetitan_create_location | Add a service location (address where work is done) to an existing customer |
servicetitan_list_leads | List leads (follow-ups for calls and forms that did not book a job yet): id, status (Open, Dismissed, Converted), customer and location… |
servicetitan_list_campaigns | Marketing campaigns (call sources such as Google Ads or a yard sign): id, name, category, active |
servicetitan_list_jobs | List jobs: id, job number, customer and location ids, business unit, job type, priority, campaign, jobStatus, summary, first appointment… |
servicetitan_get_job | One job by id with status, customer, location, job type, business unit, campaign, summary, invoice id, tags and custom fields |
servicetitan_create_job | Book a job with its first appointment(s) for a customer location |
servicetitan_update_job | Change fields of a job; only the fields you pass change. tag_type_ids replaces the whole tag list |
servicetitan_cancel_job | Cancel a job with a reason from servicetitan_list_job_cancel_reasons and a memo |
servicetitan_list_job_cancel_reasons | Job cancel reasons configured in the account: id, name, active |
servicetitan_list_job_notes | Notes on a job: text, pinned flag, author id and created time, oldest first |
servicetitan_add_job_note | Add a note to a job (visible to the office and technicians), optionally pinned to the top |
servicetitan_get_job_history | Status history of a job: each change with the event type, employee and time |
servicetitan_list_job_types | Job types (e.g |
servicetitan_list_appointments | List job appointments (the scheduled visits): id, job id, appointment number, start and end, arrival window, status, special instructions… |
servicetitan_get_appointment | One job appointment by id: job id, number, start and end, arrival window, status, special instructions |
servicetitan_add_appointment | Add another appointment (visit) to an existing job, optionally with technicians |
servicetitan_reschedule_appointment | Move an appointment to a new start and end (and arrival window) |
servicetitan_list_projects | Projects (multi-job work such as installs or construction): id, number, name, status, customer and location ids, job ids, start, target… |
servicetitan_list_appointment_assignments | Which technicians are assigned to which appointments: assignment id, technician id and name, appointment id, job id, assigned time, status |
servicetitan_assign_technicians | Assign one or more technicians to a job appointment (dispatch) |
servicetitan_unassign_technicians | Take one or more technicians off a job appointment (the appointment itself stays) |
servicetitan_get_capacity | Bookable capacity per time slot: for each slot the start and end, total and open hours, whether it is available and which technicians are… |
servicetitan_list_technician_shifts | Technician shifts and time off: id, technician id, shift type (Normal, OnCall, TimeOff), start, end, title, note |
servicetitan_list_teams | Dispatch teams that group technicians on the dispatch board: id, name, active |
servicetitan_list_zones | Dispatch zones (service areas by ZIP or city): id, name, ZIPs, cities, technician and business unit ids |
servicetitan_list_technicians | Technicians: id, user id, name, email, phone, business unit, team, zone ids, role, login name, active |
servicetitan_get_technician | One technician by id: name, contact details, business unit, team, zones, role and active flag |
servicetitan_list_employees | Office employees (dispatchers, CSRs, managers): id, user id, name, email, phone, role, business unit, active |
servicetitan_list_business_units | Business units (trades or departments such as HVAC Service, Plumbing Install): id, name, official name, email, phone, address, currency… |
servicetitan_list_tag_types | Tag types used on customers, locations and jobs: id, name, color, active |
servicetitan_list_invoices | List invoices: id, reference number, invoice date, due date, subtotal, sales tax, total, balance, customer and location with addresses… |
servicetitan_list_payments | Customer payments: id, type, reference number, amount (total), paid date, customer, memo, and the invoices each payment was applied to |
servicetitan_list_payment_types | Payment types (cash, check, credit card, financing): id, name, active |
servicetitan_list_estimates | List estimates (quotes with options shown to the customer): id, name, job id and number, customer, location, project, status { value, name… |
servicetitan_get_estimate | One estimate by id with its line items (sku, description, quantity, unit rate, total) |
servicetitan_list_estimate_items | Line items of estimates: id, estimate id, sku (id, name, type), description, quantity, unit rate, total, membership type |
servicetitan_sell_estimate | Mark an estimate as sold by a technician or employee |
servicetitan_list_pricebook_services | Services (tasks sold to customers) in the pricebook: id, code, display name, description, price, member price, add-on price, hours… |
servicetitan_list_pricebook_materials | Materials (parts) in the pricebook: id, code, display name, description, cost, price, member price, unit of measure, inventory flag… |
servicetitan_list_pricebook_equipment | Equipment (installable units) in the pricebook: id, code, display name, manufacturer, model, price, cost, warranties, primary vendor… |
servicetitan_list_pricebook_categories | Pricebook categories: id, name, type (Services or Materials), parent, sub-categories, active |
servicetitan_list_memberships | Customer memberships (maintenance plans): id, customer id, membership type, status (Active, Suspended, Expired, Canceled, Deleted), from… |
servicetitan_get_membership | One customer membership by id: type, status, dates, billing frequency, location and sold by |
servicetitan_list_membership_types | Membership types offered: id, name, duration and billing options, discounts, recurring services, active |
servicetitan_list_recurring_service_events | Recurring service events (the planned maintenance visits of memberships): id, location, membership, recurring service, date, follow-up… |
servicetitan_list_calls | Phone calls tracked by ServiceTitan: id, direction, from and to numbers, duration, call type and reason, campaign, agent, customer… |
servicetitan_get_call | One call by id with its details (lead call, customer, location, campaign, agent, recording available) |
Примеры запросов
- «Какие визиты запланированы на завтра и какие техники назначены на каждый?»
- «Найди клиента с телефоном 555-0142 и покажи его объекты, открытые сметы и счета с остатком.»
- «Забронируй ремонт кондиционера для этого клиента на утро следующего вторника. Сначала проверь загрузку и покажи мне заказ перед созданием.»
- «Какие регулярные визиты обслуживания приходятся на этот месяц и ещё не оформлены как заказ?»
- «Какие вчерашние звонки из кампании Google Ads не привели к заказу?»
FAQ
Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Meta Muse
- Подключить к Microsoft Copilot
Это руководство помогло?