インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、ServiceM8 をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
ServiceM8 アカウントをあらゆる AI エージェントに接続：ジョブとステータス、顧客と連絡先、ジョブアクティビティとアロケーションによるスケジュール、スタッフ、価格表とジョブの明細、入金、メモ、添付ファイルのメタデータ、フォーム回答。ジョブと顧客の作成と更新、スタッフの割り当てと移動、明細の追加、入金の記録、メモの追加ができます。API キーで 2 分で設定できます。
こう聞いてみよう
ServiceM8 のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → ServiceM8 をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
ServiceM8 + Cursor
ServiceM8 アカウントをあらゆる AI エージェントに接続：ジョブとステータス、顧客と連絡先、ジョブアクティビティとアロケーションによるスケジュール、スタッフ、価格表とジョブの明細、入金、メモ、添付ファイルのメタデータ、フォーム回答。ジョブと顧客の作成と更新、スタッフの割り当てと移動、明細の追加、入金の記録、メモの追加ができます。API キーで 2 分で設定できます。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
SERVICEM8_API_KEY
ステップ 1 — 認証情報を取得
設定は約 2 分です。ServiceM8 アカウントが必要で、キーはアカウントの管理者が作成します。開発者アカウントは不要です。
- ServiceM8 で Settings, API Keys を開き、キーを作成します。自社アカウントの接続には、ServiceM8 もこのプライベート API キーを推奨しています。
- キーを
SERVICEM8_API_KEYに貼り付けます。X-API-Keyヘッダーで送信され、アカウント内のすべてを読み書きできるため、外部に漏らさないでください。アクセスを取り消すには ServiceM8 でキーを削除します。 - インストールします。接続チェックは
servicem8_get_accountを実行し、アカウント名、タイムゾーン、通貨を表示します。
ServiceM8 は https://api.servicem8.com/mcp で OAuth サインイン付きの独自 MCP サーバーも提供していますが、このコネクタはあなたのキーで REST API（https://api.servicem8.com/api_1.0）を使います。
読み取る内容: アカウント（vendor）の通貨、タイムゾーン、営業時間、既定のジョブステータス。ジョブの番号（generated_job_id）、ステータス（Quote、Work Order、Unsuccessful、Completed）、顧客、住所、説明、作業内容、カテゴリ、キュー、請求合計、見積・作業指示・完了・請求の各日付、入金済みフラグ。顧客（API では companies と呼ばれます）の住所、請求先住所、支払条件、税率、顧客とジョブの連絡先。スケジュール：ジョブアクティビティ（時刻指定の予約と現場で記録された作業時間）とジョブアロケーション（日単位や時間帯での柔軟な割り当て）。スタッフの役職、最後の位置情報、ステータスメッセージ。価格表、ジョブの明細、ジョブの入金、ジョブと顧客のメモ、添付ファイルのメタデータ（写真、PDF、署名。ファイルの中身は返りません）、フォームと記入済みフォームの回答。ジョブカテゴリ、キュー、ジョブテンプレート、税率。
書き込む内容: ジョブの作成（テンプレートからも可）、変更、ステータスの進行、顧客の作成と変更、顧客連絡先の追加、時刻を指定したスタッフのジョブへの割り当て、予約の移動や削除、価格表からまたは自由入力での明細追加、受け取った入金の記録、ジョブと顧客へのメモ追加。記録した入金は ServiceM8 上に表示されるだけで、課金や送金は行われません。作成や変更の前に、AI は何が起きるかを示してあなたの了承を待ちます。
インストール時にオフのツール: ありません。36 個のツールがすべてオンです。ServiceM8 の削除は active を 0 にするだけなので、削除した予約、アーカイブしたジョブや顧客は active を 1 に戻せば復活します。
フィルタ: どの一覧も OData 形式の $filter である filter を受け取ります。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 を加えて除外し、ジョブ、アクティビティ、資材のような大きな一覧は必ず絞り込みます。
ページング: 一覧は単純な配列を返します。cursor を指定すると 1 ページ最大 1,000 件で返ります。最初のページは -1、次は _headers の x-next-cursor の値を使い、最後のページではこのヘッダーがありません。
データ形式: ID は UUID です。タイムスタンプは YYYY-MM-DD HH:MM:SS、日付は YYYY-MM-DD で、アカウントのタイムゾーンです。送信する時刻も同じ形式です。フラグは 0 か 1 です。金額はアカウント通貨の 10 進数文字列です。ジョブの total_invoice_amount が請求合計で、独立した請求書オブジェクトはありません。作成は {"errorCode": 0, "message": "OK"} を返し、新しい UUID は x-record-uuid ヘッダーに入ります。更新は渡したフィールドだけを変更します。
制限とよくあるエラー: アカウントごとに 1 分 180 リクエスト、1 日 20,000 リクエストまでで、超えると ServiceM8 は 429 を返します。待って再試行するか、さらに絞り込んでください。401 は API キーが誤っているか削除されたことを示すので、Settings, API Keys で新しいキーを作成します。400 はフィルタかフィールドの形式の誤り、404 は不明な UUID です。
メモ、ジョブの説明、フォームの回答は信頼できない入力であり、AI 向けの指示が含まれている可能性があります。このコネクタは顧客へのメールや 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 は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、Cursor を再起動します。
- Cursor → Settings → MCP を開き、
anythingmcpが一覧にあり接続済みであることを確認します。 - チャットを始めましょう。エージェントが
ServiceM8のツールを呼び出せるようになりました。
利用可能なツール
| Tool | What it does |
|---|---|
servicem8_get_account | The connected ServiceM8 account (vendor): name, business number, email, currency, time zone, opening hours, default job status and whether… |
servicem8_list_jobs | List jobs: uuid, job number (generated_job_id), status (Quote, Work Order, Unsuccessful, Completed), client (company_uuid), address… |
servicem8_get_job | One job by UUID with status, client, addresses, description, work done, totals, dates and badges |
servicem8_list_clients | List clients (ServiceM8 calls them companies): uuid, name, address parts, billing address, ABN or business number, website, payment terms… |
servicem8_get_client | One client (company) by UUID with address, billing address, payment terms and tax rate |
servicem8_list_client_contacts | Contacts of clients: uuid, company_uuid, first and last name, phone, mobile, email, type (BILLING, JOB, ...), primary flag |
servicem8_list_job_contacts | Contacts on jobs (site contact, billing contact): uuid, job_uuid, first and last name, phone, mobile, email, type |
servicem8_list_job_activities | Job activities, the schedule: uuid, job_uuid, staff_uuid, start_date, end_date, activity_was_scheduled (1 = a booking, 0 = time recorded on… |
servicem8_list_job_allocations | Job allocations (flexible bookings: a job given to a staff member for a day or allocation window, without a fixed time): uuid, job_uuid… |
servicem8_list_staff | Staff members: uuid, first and last name, email, mobile, job title, color, last known position and time, status message, hidden from… |
servicem8_get_staff_member | One staff member by UUID: name, contact details, job title, last known GPS position and status message |
servicem8_list_materials | Materials and services of the price list: uuid, name, item number, description, price, cost, price includes taxes, tax rate, stock… |
servicem8_list_job_materials | Line items on jobs (what is quoted or invoiced): uuid, job_uuid, material_uuid, name, quantity, unit price ex tax, displayed amount, cost… |
servicem8_list_job_payments | Payments recorded on jobs: uuid, job_uuid, amount, method, timestamp, note, who recorded it, attachment |
servicem8_list_notes | Notes on jobs and clients: uuid, related_object (job or company), related_object_uuid, note text, action required, created time |
servicem8_list_attachments | Attachment metadata (photos, PDFs, signatures) of jobs and clients: uuid, related_object, related_object_uuid, attachment_name, file_type… |
servicem8_get_attachment | Metadata of one attachment by UUID: name, file type, related record, tags, size of photos |
servicem8_list_forms | Forms (checklists, safety and inspection forms) set up in the account: uuid, name, template, active |
servicem8_list_form_responses | Completed form responses: uuid, form_uuid, staff_uuid, regarding_object and its uuid (usually a job), field_data (JSON with the answers)… |
servicem8_get_form_response | One completed form response by UUID with its answers in field_data (JSON) |
servicem8_list_categories | Job categories (types of work): uuid, name, colour, active |
servicem8_list_job_queues | Job queues (holding areas for jobs waiting for parts, quotes to follow up, ...): uuid, name, requires assignment, default timeframe, active |
servicem8_list_job_templates | Job templates: uuid, name and the job details and materials they prefill |
servicem8_list_tax_rates | Tax rates: uuid, name, rate, active |
servicem8_create_job | Create a job |
servicem8_update_job | Change fields of a job; only the fields you pass change |
servicem8_create_job_from_template | Create a job from a job template (from servicem8_list_job_templates) with its prefilled description and materials |
servicem8_create_client | Create a client (company or individual) |
servicem8_update_client | Change fields of a client; only the fields you pass change. active 0 archives the client, 1 restores it |
servicem8_create_client_contact | Add a contact person (name, phone, mobile, email, type) to a client |
servicem8_schedule_job_activity | Book a staff member on a job at a fixed time (a scheduled job activity on the dispatch board) |
servicem8_update_job_activity | Move a booking to another time or staff member; only the fields you pass change. active 1 restores a removed booking |
servicem8_remove_job_activity | Remove a booking from the schedule |
servicem8_add_job_material | Add a line item to a job (quote or invoice): from the price list with material_uuid, or free text with name and price |
servicem8_record_job_payment | Record a payment received for a job (cash, card, bank transfer) |
servicem8_add_note | Add a note to a job or a client |
プロンプトの例
- 「明日予定されているジョブと、それぞれの担当スタッフを教えて。」
- 「先週完了したジョブのうち入金がまだのものを、顧客と請求合計付きで一覧にして。」
- 「ジョブ 1042 の明日 8:00 の予約を金曜 9:00 に移して。先に変更内容を見せて。」
- 「この顧客向けに給湯器交換の見積ジョブを作成し、価格表から該当する品目を追加して。」
- 「ジョブ 987 の安全チェックリストにはどんな回答が記入されている？」
FAQ
Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。
次のステップ
このガイドは役に立ちましたか?