MCP 経由で Gusto を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Gusto をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Gusto + Cursor

AI に Gusto の給与計算と人事データを読み取らせます。会社とその拠点、管理者、職務と給与額を含む従業員、業務委託者、部署、給与支払スケジュールと給与計算期間、合計額付きの処理済み給与計算、業務委託者への支払い、休暇ポリシーと休暇申請、支給項目、福利厚生を参照できます。給与計算は読み取り専用で、変更できるのは部署の作成と名前の変更だけです。Gusto の OAuth でサインインし、demo と本番の両方に対応しています。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

GUSTO_CLIENT_ID, GUSTO_CLIENT_SECRET, GUSTO_API_URL

ステップ 1 — 認証情報を取得

1. Gusto Developer Portal（https://dev.gusto.com）で無料アカウントを作成し、アプリケーションを作成します。新しいアプリケーションは demo 環境で始まり、テスト用の会社を対象に動作します。
2. アプリケーションの設定で、リダイレクト URI https://cloud.anythingmcp.com/api/mcp-oauth/callback を追加します（AnythingMCP をセルフホストしている場合は <your AnythingMCP URL>/api/mcp-oauth/callback）。demo アプリケーションのリダイレクト URI はポータルで編集できます。本番アプリケーションの場合は、依頼すると Gusto が変更します。
3. アプリケーションの Client ID と Secret を GUSTO_CLIENT_ID と GUSTO_CLIENT_SECRET にコピーします。
4. GUSTO_API_URL を、demo アプリケーションでは https://api.gusto-demo.com に、Gusto がアプリケーションを本番用に承認した後は https://api.gusto.com に設定します。キーはそれぞれの環境でしか使えません。
5. まず試す場合は、Developer Portal で demo company を作成します。サンプルの従業員、業務委託者、給与計算データが最初から入っています。
6. コネクターをインストールし、Authorize with Provider をクリックして、プライマリ管理者またはフルアクセス管理者として Gusto にサインインします。接続する会社を Gusto が尋ねます。1 回の認可で対象になるのは 1 社だけなので、2 社目にはコネクターをもう一度インストールしてください。
7. gusto_get_token_info を実行します。ほかのツールが対象とする会社と、アプリケーションが読み取れる範囲が表示されます。

給与計算は読み取り専用です: AI は、従業員ごとの合計額、税金、控除を含む給与計算、給与支払スケジュール、給与計算期間、業務委託者への支払いを読み取れます。ただし、給与計算の準備、計算、送信、取り消し、業務委託者への支払い、従業員の追加や退職処理、給与の変更はできません。AI が行える変更は、部署の作成（gusto_create_department）と部署名の変更（gusto_update_department、インストール時は無効）だけで、どちらも実行前に確認を求めます。

読み取れるデータ: 会社とその拠点、管理者、職務、給与額、雇用履歴を含む従業員、業務委託者、部署、残高付きの休暇ポリシー、休暇申請、支給項目、会社の福利厚生です。給与計算の一覧は、既定で過去 6 か月間に処理された通常の給与計算を返し、1 回のリクエストで最大 1 年分まで取得できます。

権限は Gusto が決めます: サインイン時にスコープを選ぶことはありません。スコープは Gusto がアプリケーションに割り当てます。demo 環境では幅広く、本番では Gusto の審査後に割り当てられます。給与額には compensations:read スコープが、健康情報を含む福利厚生には :phi スコープが必要です。アプリケーションのスコープ外の呼び出しには 403 が返ります。

トークン: アクセストークンの有効期間は 2 時間で、自動的に更新されます。Gusto は更新のたびにリフレッシュトークンを置き換えるため、同じ認可を別のツールで同時に使わないでください。どちらか一方で再サインインが必要になります。

よくあるエラー: 401 は認可が取り消されたことを意味します。もう一度 Authorize with Provider をクリックしてください。403: アプリケーションにそのスコープがないか、認可した会社とは別の会社です。406: コネクターが送る API バージョンが、アプリケーションで許可された範囲外です（最小バージョンは Developer Portal で確認できます）。429: 1 分間に 200 件を超えるリクエストです。1 分待ってください。

このコネクターは、給与計算の実行、業務委託者への支払い、入社手続きや退職処理、給与や福利厚生の変更、税務書類や文書の読み取りは行いません。Gusto Embedded は別の製品で、対象外です。

ステップ 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" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Gusto のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「直近に処理した給与計算をまとめてください。従業員ごとの総支給額、税金、差引支給額を出してください。」
• 「来週休むのは誰ですか。まだ承認待ちの休暇申請はどれですか。」
• 「契約中の業務委託者を一覧にして、今四半期にそれぞれへ支払った金額を示してください。」
• 「部署ごとの従業員数と、過去 90 日間に入社した人を教えてください。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続