MCP 経由で SAP SuccessFactors を Gemini に接続する方法

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

SAP SuccessFactors + Gemini

SAP SuccessFactors Employee Central を OData API で読み取ります。従業員、職務情報、個人、会社、部門、ポジション、休暇に対応し、ほかのエンティティ向けの汎用 OData ツールも備えています。OAuth 2.0 SAML bearer、読み取り専用です。

前提条件

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

SF_API_URL, SF_COMPANY_ID, SF_CLIENT_ID, SF_SAML_ASSERTION

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

1. SuccessFactors で Admin Center → Manage OAuth2 Client Applications → Register Client Application を開きます。そこで X.509 証明書を生成し（または自分の証明書をアップロードし）、秘密鍵をダウンロードして、登録後に表示される API Key を SF_CLIENT_ID にコピーします。
2. SAP のオフライン SAML アサーション生成ツール（SAP Note 3031657）で、API ユーザーの SAML アサーションを生成します。トークン URL は <api-server>/oauth/token、クライアント ID には API キー、そして API ユーザー、秘密鍵を指定し、expireInMinutes にはアサーションを使える期間を設定します。base64 のアサーションを SF_SAML_ASSERTION に貼り付けます。
3. SF_API_URL に、データセンターの OData API サーバーを /odata/v2 なしで設定します。例: https://api4.successfactors.com、https://api012.successfactors.eu。SAP の List of SAP SuccessFactors API Servers に記載されており、ログイン URL のホストと一致します。
4. SF_COMPANY_ID に会社 ID を設定します。右上の自分の名前 → Show version information に表示され、ログイン URL にも company= として含まれています。
5. API ユーザーに Employee Central API の権限（Role-Based Permissions → Employee Central API: OData API access）と、AI に見せたいエンティティとフィールドの読み取り権限を付与します。
6. コネクターをインストールします。まず API 呼び出しを消費しない sap_successfactors_guide から始め、次に sap_successfactors_list_users を実行します。従業員の一覧が表示されれば接続は成功しています。

トークン: コネクターはアサーションを有効期間 24 時間のアクセストークンと交換し、アサーションが有効な間は自動的に更新します。アサーションの期限が切れたら、新しく生成して SF_SAML_ASSERTION に貼り付けてください。SAP はこれらの API の HTTP Basic 認証を 2026 年 11 月 20 日に廃止するため、提供していません。

読み取り専用です: AI はデータを読み取るだけで、SuccessFactors の内容は何も変更しません。すべての呼び出しはアサーションで指定した API ユーザーとして実行されるため、AI に見える範囲は SuccessFactors のロールベース権限で決まります。

読み取れるデータ: userId 付きの従業員プロファイル、職務情報（会社、部門、ポジション、上長、雇用ステータス）、個人情報、メールアドレス、電話番号を含む個人レコード、法人、部門、欠員と FTE を含むポジション、休暇申請です。ほかのエンティティについては、sap_successfactors_get_entity_metadata がフィールドを一覧にし、汎用 OData ツールがデータを読み取ります。

有効日付: 職務情報、会社、部門、ポジションは、今日時点で有効なレコードを返します。履歴が必要な場合は、日付または期間を指定して依頼してください。

制限: 1 ページは最大 1000 行で、AI は大きな一覧をフィルターで絞り込みます。SAP はテナントごとに API の大量利用を制限するため、AI は全ユーザーを何度も読み込む代わりに最終更新日で絞り込みます。

知っておくと便利なこと: 無効なユーザーは、ステータスを指定して依頼した場合にだけ表示されます。選択リストのフィールドは、AI がラベルを展開しない限りコードで返ります。

このコネクターは、採用、職務データや給与データの変更、休暇の承認、SuccessFactors のエンティティへの書き込みは行いません。

ステップ 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 は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が SAP SuccessFactors のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「部門ごとの在籍従業員数と、各部門の責任者を教えてください。」
• 「来週不在になるのは誰ですか。まだ承認待ちの休暇申請はどれですか。」
• 「欠員のあるポジションを、会社、部門、FTE と一緒に一覧にしてください。」
• 「従業員 10234 の過去 2 年間の職務履歴として、部門、ポジション、上長の変更を見せてください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

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