ClaudeとGustoを連携する方法 — 給与実行までできる米国給与SaaS連携

Gustoは米国拠点の給与・人事データをClaudeで扱えるコネクタ

Gustoは米国の中小企業向け給与計算SaaSです。Anthropicのコネクタディレクトリには「Anthropic verified」の表示で登録されており、カテゴリはFinancial services、開発元はGusto自身です。ディレクトリへの追加は2026年2月で、サインインが必須です。サードパーティ製の非公式ツールではありません。

説明文は「給与・人事データについて自然言語で質問し、レポートやグラフを作る」というもので、「Eligible customers can also run payroll in Claude」と続きます。読み取りだけでなく、対象になった顧客は給与実行までClaudeから進められるコネクタです。

米国に拠点を持ち、現地の給与処理をGustoで行っている日本企業にも関係します。本社の人事・経理担当者が、米国拠点の給与状況を日本語の会話で問い合わせられるのがこのコネクタの使いどころです。

国内拠点の給与はfreeeとの連携やマネーフォワードとの連携の領分で、米国拠点の給与の受け皿がGusto連携です。コネクタ全般の追加方法はClaude Connectorsの一覧と追加方法にあります。

Claudeに頼めること

Gustoの公式ガイドは、質問とその裏で呼ばれるツールを組にして例示しています。

• 会社名と所在地を聞くと get_company
• 部門ごとの人数を聞くと list_employees と list_departments
• 直近の給与の総支給額を聞くと list_payrolls
• 特定日以降の入社者、報酬の上位・下位の社員、業務委託先の一覧も、同じ読み取りツールで答えます

グラフや表の作成はClaude側の仕事です。「直近6回の給与を項目ごとに分解して」と頼めば、取得した数値が会話の中で表やグラフになります。

一度接続すれば、会話ごとにGustoを名指しする必要はありません。「部門ごとの人数を出して」と聞くだけで、Claudeが内容から判断してGustoを呼びます。他のコネクタも多数つないでいるなら、Connectorsメニューの「Tool access」を使います。既定の「Auto」で足りますが、有効なコネクタが10本以上なら「On demand」に切り替えると会話に余裕が出ます。

連携前に確認すること

連携できるのは、Gustoでglobal/full admin(全権限の管理者)権限を持つアカウントです。Gustoの公式ガイドがこれを前提に挙げており、管理者権限のある会社が1社もないアカウントでは、認証後に「No companies available」が出ます。

ディレクトリの説明は、給与実行を「Eligible customers」に限っています。対象の条件はディレクトリのページに書かれていないので、給与実行ツールを使いたい場合は、対象かどうかをGustoのサポートで確かめてください。

Team・Enterpriseの組織では、OwnerまたはPrimary Ownerがコネクタを有効化しないとメンバーは使えません。有効化しても自動で使えるようにはならず、各メンバーが自分のGustoアカウントで認証します。

Team・Enterpriseのプランでは、Enterprise-managed authというベータ機能もあります。組織全体で一度コネクタを認可すれば、メンバーは初回ログイン時にその認可を引き継ぎます。

Enterpriseでは、検証済みドメインのサービスを組織外のClaudeアカウントにつなげない設定も持てます。給与データを個人アカウントから引き出す経路を管理者側で塞げます。Team・Enterpriseのコネクタはプライベートプロジェクトでしか使えず、同期済みの内容を含むチャットは共有できません。

Gustoコネクタを追加する手順

手順

claude.aiまたはClaude Desktopでつなぐ

1. 1

   コネクタ一覧を開く

   Customize → Connectorsを開き、「+」を押します。チャット画面左下の「+」から選ぶ方法もあります。

2. 2

   Gustoを選ぶ

   カテゴリ(Financial services)から探すか、検索窓にGustoと入力します。

3. 3

   Gustoで認証する

   「Connect」を押し、Gustoのログイン画面で管理者アカウントにサインインします。

4. 4

   権限の範囲を選ぶ

   Gustoの公式ガイドが示す認可画面では、アクセスを許すデータの種類と、複数社ある場合は接続する会社を選びます。

5. 5

   会話で有効にする

   チャットの「+」→「Connectors」でGustoのトグルをオンにします。

モバイルアプリからのコネクタ追加は現在ベータで、デスクトップとWebが主な経路です。Team・Enterpriseの管理者が組織に配る場合は、Organization settings → Connectorsの「Browse connectors」でGustoを選び、「Add to your team」を押します。

ツール単位で権限を絞る

Ownerは、Customize → ConnectorsでGustoを選び、ツールごとに「Always allow」「Needs approval」「Blocked」を設定できます。ツールは「read-only tools」「write/delete tools」のような種類でまとめて表示され、種類単位でも個別でも選べます。設定は組織全体に効き、個々のユーザーは上書きできません。

Gustoのツールをどう分けるかを、Gustoの公式ガイドのツール説明から組んでみます。

権限設計

Gustoツールの3段階の分け方

• 常に許可: 読み取り系

  get_ や list_ で始まる参照系と、list_payroll_blockers(給与の処理を妨げている問題の一覧)、get_token_info(接続中のスコープの確認)です。

• 承認が必要: データを書き換えるもの

  update_payroll は未処理の給与の時間・手当・休暇・支払い方法を、1回で最大100人分まで書き換えます。record_time(勤怠の記録)や manage_company_members(従業員・業務委託の追加と更新)も同じ段です。

• 承認が必要、または禁止: 支払いに直結するもの

  run_payroll は未処理の給与を計算して提出します。1回の呼び出しで完了するので、常に承認を挟むのが最小限の線引きです。使わせない会社はBlockedにします。

分け方の目安は、Gustoが勧める運用とも合っています。Gustoの公式ガイドは、ツールの自動実行を有効にせず、すべての呼び出しを実行前に確認するよう求めています。

ディレクトリのページとGustoのガイドは、ツールの数え方が違います。ディレクトリは43個、Gustoのガイドは72個です。給与まわりも、ディレクトリには calculate_payroll と submit_payroll が別に並び、ガイドは run_payroll が計算と提出をまとめて行うと説明します。実際の設定画面に run_payroll 以外の提出系ツールが並んでいれば、それらも承認制に揃えておくと抜け道が残りません。

給与以外にも副作用のあるツールがあります。file_ein は連邦EIN(Form SS-4)の申請書類を準備して検証し、pay_ein_filing はその申請の支払い用にStripeのチェックアウトリンクを作ります。file_scorp_election はS-Corp選択(Form 2553)の書類を準備します。create_company や connect_bank_via_plaid も含めて、会社の設立や口座の接続に関わるものは、読み取り系と同じ「常に許可」には入れない運用が考えられます。

この制限はClaude側の追加の絞り込みです。Gusto本体の権限がなければ、Claudeで許可してもその操作はできません。逆に、Claudeで制限を緩めても、Gustoが許す範囲を超えて権限が広がることはありません。誰がいつどのツールを使ったかの追跡はClaudeコネクタの権限設定と監査ログ、読み取りだけに絞る設計はClaudeコネクタを読み取り専用にする方法が詳しいです。

給与データを扱うときのGusto側の注意

Gustoの公式ガイドには、給与データ特有の注意があります。

• Gustoのセッションに他のMCPサーバーを混ぜない: 混ぜると、Gustoのデータが意図せず別のサービスに送られるおそれがあるためです
• Web検索など外部へ出る機能に注意する: Gustoから取った給与情報が、検索エンジンや第三者サービスに渡る可能性があります
• 学習へのデータ提供を止める: Gustoが自社で契約するAI事業者に学習させない約束は、利用者が自分で選んだクライアント側には及びません
• 出力を鵜呑みにしない: 数値は元の給与データと突き合わせてから使います

スコープを変えたいときは、コネクタを切断して再接続し、認可画面で選び直します。接続中に実際どの範囲が許されているかは、get_token_info で確かめられます。

Claude Codeから使う場合

claude.aiアカウントでClaude Codeにログインしていれば、claude.aiで接続済みのGustoは /mcp の一覧に自動で出ます。ターミナル、VS Code、JetBrains、Agent SDKのセッションが対象です。組織側でツールが「Blocked」なら、Claudeからは使えなくなります。/mcp の一覧には残り、「disabled by your organization」と表示されます。

ターミナル、VS Code、JetBrainsで組織がツールを「Needs approval」にしている場合、Claude Codeは acceptEdits や bypassPermissions のモードでも毎回確認を求めます。「今後は確認しない」という選択肢も出ません。デスクトップアプリのローカルセッションとSSHセッションでは、この設定がClaude Codeに届かず、通常の権限ルールに従います。

次のログイン方式では、claude.aiのコネクタは読み込まれません。

• ANTHROPIC_API_KEY や ANTHROPIC_AUTH_TOKEN を使っている
• Amazon BedrockやGoogle Cloud経由のプロバイダーを使っている
• Anthropicプロファイルや連携用の変数で認証している
• claude setup-token で作った長期トークンを CLAUDE_CODE_OAUTH_TOKEN に入れている(このトークンはモデルへのリクエストにしか使えません)

/mcp にGustoが出ないときは、/status で認証方式を見て、claude.aiのアカウントでログインし直します。

時間のかかる集計では、タイムアウトの仕組みが関わります。claude.aiコネクタのツール呼び出しは、応答も進捗通知も5分間途絶えると、既定でエラーになります。メイン会話の呼び出しが2分を超えると、バックグラウンドのタスクに移ります。この自動バックグラウンド化はClaude Code v2.1.212以降の動作です。5分の待ち時間は、環境変数 CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT にミリ秒で値を入れると変えられ、0 なら無効になります。Gusto側にも、期間や人数を絞る、ページ送りを使う、全従業員を一括でなく個別に聞く、という応答を速くする案内があります。

よくあるつまずき

• 給与実行のツールが見当たらない・実行できない: 対象顧客でないか、組織のOwnerがそのツールを「Blocked」にしている。まずCustomize → Connectorsで状態を見る
• 認証後に「No companies available」と出る: 管理者権限のある会社が、接続したアカウントに無い。Gustoで全権限の管理者かを確かめる
• 「Permission denied」や「Insufficient scope」になる: コネクタを切断して再接続し、認可画面で必要なデータの種類を選び直す。Gusto側の自分のロールが、その種類のデータを見られるかも確認する
• 「Rate limit exceeded」(429)になる: レスポンスの Retry-After が示す時間だけ待つ。Gustoのガイドにはしきい値が書かれていない
• Claude Codeの /mcp に出ない: /status でログイン方式を見る。APIキー認証の間は出ない
• 組織で有効化したのに使えないメンバーがいる: 有効化と個人の認証は別の工程。本人がGustoアカウントでログインし直す
• 「Session expired」になる: 切断と再接続でOAuthをやり直す

まとめ

給与実行まで届くコネクタなので、展開前にOwnerが run_payroll 系のツールだけは承認制かBlockedにしておくと、残りは読み取りの分析として配りやすくなります。Gustoのガイドが求める「他のMCPサーバーを混ぜない」には、給与を見る会話をほかのコネクタと別に立てるのが素直な対応です。