Next TokenParallel World

← ラボ / Claude Code ガイド / 連携台帳

Gusto・給与・労務・海外　公式サイト
米国向けの給与・人事サービス。開発者向けには、アプリに給与機能を組み込む Embedded Payroll API と、共通顧客向けの App Integrations が案内されている。自社のGustoアカウント向けに公式MCPとCLIも出ている。

Claude Codeに、どこまで権限を渡せるか

読み取り専用で渡せるか 未確認
【MCP】専用の読み取り専用モードは公式に記載なし。認可時に『データ種別（data categories）』を選べる（公式: 「each connection is limited to only the data categories you explicitly grant during setup」）が、種別ごとに読み取りだけを選べるかは書かれていない。【API】スコープが resource:read / resource:write に分かれ、read のみのスコープを割り当てられる（公式 api-fundamentals）。https://docs.gusto.com/app-integrations/docs/mcp
権限（スコープ）を選べるか あり
【MCP】認可時にデータ種別と会社を選ぶ。get_token_info で有効なスコープを確認、変更は切断→再接続（公式）。【API】スコープは『employees:read』形式の resource:action。write は「Create, edit, or delete a resource」。GET /v1/token_info でトークンのスコープを確認。本番ではスコープ外は403、デモ環境（api.gusto-demo.com）は既定でスコープ未適用。
危険な操作の既定
【MCP】給与の確定を含むツールがある。run_payroll の公式説明は「Calculate and submit an existing unprocessed payroll.」、update_payroll は「Update an unprocessed payroll's hours, earnings, PTO, memos, or payment methods for up to 100 employees per call.」。確認は『クライアント側の確認プロンプト』が前提: 「You should always be prompted to confirm any tool call before it is executed」「it is critical that you don't enable any automatic tool execution features in your client」。製品ページは「approving a run always stays a human decision」「you approve every write」。MCPサーバー側で run_payroll だけを無効にする設定の記載はない。create_company は confirmed:false で確認してから confirmed:true の2段階。【CLI】agent mode の書き込みは confirmation_required（終了コード8）で止まり、承認後に --confirm で再実行。--dry-run あり。gusto payroll run/submit コマンドはなく『エージェントはこのツールでお金を動かせない』（AGENTS.md）。
削除ができるか できる
【API】write スコープは「Create, edit, or delete」。リファレンスにオンボーディング中従業員の削除、給与の取り消し（cancel）がある。【MCP】72ツール名に delete 名のものはないが、manage_company_members・update_payroll など変更系はある（公式は分類を明記せず）。【CLI】従業員の退職登録・取消はできる（agent modeで確認ゲート付き）。
取り消し方（キー・接続）
【MCP】「Revoke access at any time by disconnecting the MCP server」。スコープ変更は切断→再接続。接続できるのは Gusto アカウントの global/full admin（docs）、製品ページは full and primary admins。【CLI】gusto auth logout。【API】専用の取り消しエンドポイントは未確認。新しいアクセストークンを使うと以前の refresh token が失効する。

根拠のページ

つなぎ方（公式の資料にある範囲）

公式MCP あり

Gusto MCP Server（自分のGustoアカウントのデータを自然言語で扱う）。72ツール: 会社・オンボーディング、銀行連携、税・法人設立、レポート、給与、従業員・組織、業務委託、勤怠、給与スケジュール、ユーティリティ。公式のツール一覧の説明は、run_payroll =「Calculate and submit an existing unprocessed payroll.」（既存の未処理の給与を計算して提出）、update_payroll =「Update an unprocessed payroll's hours, earnings, PTO, memos, or payment methods for up to 100 employees per call.」。ほかの書き込み・実行系ツール名に create_company、manage_company_members、record_time、file_ein、pay_ein_filing、file_scorp_election、connect_bank_via_plaid、create_reports、accept_reasonable_salary、acknowledge_scorp_recommendation、create_secure_gusto_session、manage_account がある（読み取り／書き込みの分類は公式ページに明記されていない）。確認はクライアント側の確認プロンプトが前提で、公式ドキュメントに「You should always be prompted to confirm any tool call before it is executed」「it is critical that you don't enable any automatic tool execution features in your client」と書かれている。MCPサーバー側で run_payroll を無効にしたり読み取り専用にしたりする設定は、読んだページに記載がない。公式の製品ページには『Running payroll is one of the things you can do today through the Gusto MCP server』『approving a run always stays a human decision』『you confirm before anything submits』『it can't push a change through on its own』とある（CLIでは給与の確定ができない点と対照的）。別に、API開発向けの Embedded Dev Assistant MCP（https://embedded-payroll.readme.io/mcp、Beta）もあり、こちらはAPIリファレンス検索・ドキュメント検索・コード生成用で、実データへのアクセスの有無は書かれていない。

つなぎ方（公式の記載）
公式の手順は Claude の Web アプリ: Settings → Connectors → Add custom connector に名前『Gusto』とURL https://mcp.api.gusto.com を入れ、Add → Connect → データ種別と会社を選んで Authorize。Claude専用エンドポイント https://mcp.api.gusto.com/anthropic も記載。製品ページは Claude のコネクタディレクトリ（claude.com/connectors/gusto）からの追加も案内。Claude Code での追加手順は公式ページに記載なし。

根拠のページ

公式CLI あり

gusto CLI（ベータ。GitHub: https://github.com/Gusto/gusto-cli）。自分が管理するGusto会社の従業員・タイムシート・給与スケジュール・給与ドラフトを扱う。コマンド例: auth login / whoami / logout、employee list / terminate / cancel-termination / update / update-home-address / update-work-address、timesheet create / sync、payroll prepare / calculate / update、pay-schedule create、api（生のAPI呼び出し）。公式の記載で『There is no gusto payroll run/submit』（給与の実行・確定はCLIからできない。ドラフトまで）。 公式の AGENTS.md には「There is no `gusto payroll run`/`submit`, so an agent cannot move money through this tool even with `--confirm`」とある。公式製品ページのインストールコマンドは `curl -fsSL https://cli.gusto.com/install.sh | sh`。

根拠のページ

公式API あり

Embedded Payroll API（アプリに給与機能を組み込む）と App Integrations。リファレンスに給与の計算（calculate）・確定（submit）・取り消し（cancel）、一括取り消し、従業員の退職登録、オンボーディング中従業員の削除、会社情報の更新などがある。レート制限は『200 requests per minute per user』。React SDK・API Clients（SDK）・Try it now・デモ環境（api.gusto-demo.com）がある。

根拠のページ

第三者製MCP（公式ではない） 2件

  • Savinda96/gusto-mcp（作者: GitHubユーザー Savinda96）
    書き込み・削除: READMEに書き込み・削除・給与実行の記載なし（会社単位の給与状況・従業員・給与スケジュールの取得を説明）。ソースは未確認。
    READMEは自らを「proof of concept (POC)」とし、Gustoの sandbox 環境のみ対応と説明。認証は会社単位のOAuth2トークン（環境変数 GUSTO_CLIENT_ID／GUSTO_CLIENT_SECRET／GUSTO_ACCESS_TOKEN／GUSTO_REFRESH_TOKEN／GUSTO_BASE_URL）。ライセンスの記載なし、コミット10。最終更新日はページから読み取れず。
    https://github.com/Savinda96/gusto-mcp
  • agenticledger/gusto-mcp-http（作者: GitHub組織 agenticledger（素性の記載なし））
    書き込み・削除: 未確認（READMEの本文を読めなかった）
    リポジトリの説明は「Gusto MCP Server — Streamable HTTP transport with Bearer passthrough」のみ確認。ツール一覧・ライセンスは読めていない。コミット4。
    https://github.com/agenticledger/gusto-mcp-http

第三者製のMCPは、サービスの運営元が作ったものではありません。作者と中身を確かめてから使うかどうかを決めてください。ここに載せているのは、公式のレジストリやGitHubで見つかったものを、書かれている範囲でまとめたもので、おすすめではありません。

探した場所（7件）

できる操作

読み取りでできる操作

  • 【MCP】従業員・業務委託・給与・タイムシート・職種・報酬・給与スケジュール・部署・会社情報の読み取り（認可したユーザーが見える範囲）
  • 【CLI】employee list など list 系（paginate）、processed-payroll・ledger の読み取り
  • 【API】会社・従業員・給与等の取得（scope: ◯◯:read）

書き込みでできる操作

  • 【MCP】給与の更新（update_payroll）、給与の計算と提出（run_payroll。公式のツール説明は「Calculate and submit an existing unprocessed payroll.」）、勤怠記録（record_time）、会社作成（create_company。confirmed:false → true の2段階確認）、メンバー管理、EIN申請・納付、S Corp届出、銀行連携 など（ツール名とツール説明より。公式ページは読み取り／書き込みの分類を明記していない）
  • 【CLI】従業員の更新・住所更新・退職登録・退職取消、タイムシート作成・同期、給与の準備・計算・更新（ドラフト）、給与スケジュール作成、非GETの api 呼び出し（agent modeでは確認ゲートあり）
  • 【API】給与の計算・確定、従業員・会社の更新など（scope: ◯◯:write は『Create, edit, or delete』）

管理者操作（削除・課金・設定変更など）

  • 【API】給与の確定（submit）・取り消し（cancel）、一括取り消し、従業員の退職登録、オンボーディング中従業員の削除のエンドポイントがある
  • 【MCP】run_payroll（給与の計算と提出）・manage_company_members などのツールがある。接続できるのは、MCPドキュメントでは「global/full admin permissions」、製品ページ（gusto.com/product/agents）では「full and primary admins」と書かれている（表現が出典で異なる）
  • 【CLI】給与の実行・確定はできない（『There is no gusto payroll run/submit』）

制限

  • MCP: 接続できる管理者は、MCPドキュメントでは「global/full admin permissions」、製品ページでは「full and primary admins」（出典で表現が異なる）。切断は「Revoke access at any time by disconnecting the MCP server」
  • MCP: トラブルシュートに『Verify your subscription level supports MCP (Pro/Max for Claude, Pro+ for Cursor)』とある（Claude側のプランの話）
  • MCP: 単独で使い、他のMCPサーバーを同一セッションにつながない。レート制限は429、しきい値は非公開。バージョンは0.1.0
  • CLI: ベータ（Gusto CLI Beta Agreement）。OAuthコールバックは127.0.0.1のため、CLIと同じホストでサインインが必要
  • API: 200 requests/分/ユーザー。Embedded Payroll API の利用にパートナー申請・審査が必要かはページに記載なし（未確認）
  • Embedded Dev Assistant MCP は Beta。Cursor/Windsurf/Claude Desktop/VS Code の設定手順（Claude Codeは記載なし）
注意
  • MCPの run_payroll は、公式のツール説明で給与の計算と提出を行うツール。確認はクライアントの確認プロンプトに依存し、公式は自動承認（automatic tool execution）を有効にしないよう明記している。製品ページは『approving a run always stays a human decision』『you approve every write』と説明。MCPサーバー側で run_payroll だけを無効にする設定の記載は読めた範囲にない。CLIは給与の確定ができない設計（AGENTS.md）で、MCPとは異なる
  • CLIは給与の確定・実行ができない設計（ドラフトまで）。従業員の退職登録は agent mode でも確認ゲート付きで実行できる
  • 従業員の住所・報酬・税情報など個人情報が対象。公式は『クライアントのデータ学習設定をオプトアウトにする』『信頼できるクライアントだけ使う』と案内
  • APIの給与確定・取り消しは取り消せるかの条件を未確認。デモ環境（gusto-demo.com）が別にある

認証・料金・日本語・実機検証

認証方式
【MCP】OAuth 2.0 + PKCE（認可時にデータ種別と会社を選択。get_token_info で有効スコープを確認）。【CLI】gusto auth login（ブラウザOAuth、トークンは手元に保存）。--token-stdin / GUSTO_ACCESS_TOKEN での指定も可。【API】system access token（2時間で失効）と company access token（refresh tokenで更新）。
公表されている料金（2026年10月16日確認）
公式料金ページ（月額、米ドル）: Simple $49 + 1人あたり $6、Plus $80 + $12、Premium $180 + $22。月ごとの契約で、アクティブな従業員のみ課金。割引・キャンペーン価格の記載なし。MCP/CLI/APIの追加料金や対象プランは公式ページに記載なし（2026-10-16確認）。 料金ページ
日本語対応
未確認。日本語の公式ドキュメント・管理画面の有無は確認していない（開いたページはすべて英語。米国向けサービス）。
Claude Code実機検証
未検証（この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます）
確認できていない点（12件）
  • MCP 72ツールの読み取り／書き込みの公式分類（ツール名からの推測のみ。公式は未分類）
  • MCPサーバー側で run_payroll を無効にする設定や、確認が入る範囲（公式の記載はクライアントの確認プロンプトへの依存まで）
  • Claude Codeでの公式の追加手順
  • Embedded Payroll API の利用条件（パートナー申請・審査）、スコープの全一覧
  • APIの給与確定・取り消しの取り消し可否
  • API・CLIのトークン取り消し手順の詳細（MCPは切断→再接続と記載あり）
  • GitHub の gusto-cli リポジトリのREADME・最終更新日（AGENTS.mdのみ読了）
  • 日本語対応
  • 第三者製MCPの運営者・書き込み可否
  • 2026-10-17再確認で残った点: permission.read_only: 公式MCPページ（docs.gusto.com/app-integrations/docs/mcp）を再度開き、データ種別を選べるとあるが、読み取りと書き込みを分けられるか・読み取り専用の選択肢の有無は書かれていない（『ない』とも書かれていない）。
  • 2026-10-17再確認で残った点: ja: support.gusto.com のサポート連絡ページに言語の記載なし。日本語の有無は確認できず。
  • 2026-10-17再確認で残った点: MCPレジストリ（search=gusto）は取得エラー。agenticledger/gusto-mcp-http のREADME本文は取得できず。
出典（12件）

この台帳は、公式の資料を読んだ範囲のことで、動かして確かめたものではありません。確認日: 2026年10月16日。

ラボの資料は、公式の文書を読んでまとめたもので、実際に使って確かめた記録ではありません。日付や仕様は変わるので、使う前に各ページの出典で確かめてください。事実と「僕らの見立て」は、分けて書いています。