SAP SuccessFactors について
SuccessFactors Toolkitは、SAP SuccessFactors APIのトラブルシューティング、データ抽出、連携開発向けのセルフホスト可能なツールキットです。REST APIとMCPを通じてCompound Employee SOAPやODataを扱い、PIIのトークン化にも対応します。
主な機能
- 01SOAPによるCompound Employee照会
- 02OData v2・v4クエリ対応
- 03APIデータの抽出と絞り込み
- 04REST APIとMCPの提供
- 05PIIのトークン化とエクスポート
活用シーン
- 01SuccessFactors API呼び出しの調査
- 02連携開発向けの従業員データ抽出
- 03AIエージェントによるSuccessFactorsデータ照会
MCP 対応
このツールキットはMCPサーバーを提供し、SuccessFactorsのCompound EmployeeおよびODataの照会機能をAIエージェントに公開します。データ処理とエクスポートにも対応し、機微データにはローカルDockerでの運用を推奨しています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
SuccessFactors Toolkit
SAP SuccessFactors API のトラブルシューティング、ペイロードの抽出、統合開発のためのセルフホスト可能なツールキットです。REST API と MCP(Model Context Protocol)サーバーとして公開されています。
| API | プロトコル | エンドポイントのプレフィックス |
|---|---|---|
| EC SFAPI — Compound Employee | SOAP 1.1 | /api/sfapi/ce/ |
| OData | REST (v2, v4) | /api/odata/ |
OData v4 では、v4 サービスとして公開されている SuccessFactors API(たとえば、Calibration や Continuous Feedback)を利用できます。Employee Central と Onboarding のデータは引き続き v2 を使用します。詳しくはOData APIをご覧ください。
これは独立したプロジェクトであり、SAP SE とは提携しておらず、同社から承認を受けているものでもありません。 SAP および SuccessFactors は SAP SE の商標です。
まずはこちら:Docker MCP → 認証情報 → 質問 → エクスポート
データセキュリティ:ローカルでのデプロイを推奨します。 機密性の高い SuccessFactors の従業員データや認証情報を扱う場合は、オンラインの AI プラットフォームやサードパーティがホストする MCP サービスではなく、MCP サーバーをローカルの Docker で実行し、ローカルの AI エージェントを使用することを推奨します。認証情報やエクスポートデータはご自身のマシン内に保管し、秘密鍵や従業員のペイロードをオンラインプラットフォームにアップロードしないでください。
ローカルの AI エージェントが、必ずしもローカルモデルを使用するとは限りません。 クラウドモデルを呼び出す場合、そのモデルに渡されるプロンプト、ツールの応答、プレビュー、ファイルの内容がマシンの外部に送信される可能性があります。人事データを管理下の環境内にとどめる必要がある場合は、ローカルでホストしたモデルとローカルのファイル処理ツールを使用し、エージェントが外部へデータを送信する際の取り扱いを確認してください。ローカルの Docker を使うだけでは、これを保証できません。このツールキットは、データの照会時に設定済みの SuccessFactors テナントへ接続します。
機能コンサルタントや業務の主要ユーザーは、業務ユーザーガイドまたは英語/中国語版 HTMLから始めてください。IT 担当者に、Docker Compose の初回セットアップと、承認済みの接続ファイルの提供を依頼してください。その後、次の手順に進みます。
- Docker Desktop または IT 管理の Docker サービスが起動していることを確認し、ローカルの AI アプリケーションを開きます。
- 接続ファイルが
sf-toolkit/credentials/systemsにあり、SuccessFactors システムごとにフォルダーが分かれていることを IT 担当者に確認します。 - 使用する SuccessFactors システムを確認し、必要な従業員、日付、情報を指定します。
sf-toolkit/data/mcpにある結果を確認します。ファイルを扱える AI アプリケーションに CSV やその他の対応形式への変換を依頼するか、承認済みのフォルダーにコピーします。
このガイドには、業務に関する質問の例、完了確認、トラブルシューティング、管理者向けの展開可能な初回設定手順が含まれています。元の OData の結果は JSON、Compound Employee の結果は XML です。CSV への変換には、AI アプリケーション内のローカルファイルツールが必要です。
ドキュメント
| ページ | 内容 |
|---|---|
| REST API | フェイルクローズ方式のセットアップ、インストールと実行、チートシート、応答形式 |
| SuccessFactors への接続 | キーペアの生成、システムファイル(SYSTEMS_DIR/<name>/<name>.json)、環境変数、システム管理 |
| EC SFAPI (SOAP) | Compound Employee の単一検索、構造化フィルタークエリ、ページネーション、既知の落とし穴 |
| OData API | execute / extract / extract-by-filter-in、OData v4 サービス、リクエストごとの接続の上書き、既知の API の落とし穴 |
| MCP サーバー | AI エージェント向けツール、ペイロードの処理、エクスポート形式、PII のトークン化、プラグイン |
| 開発 | ローカル開発環境のセットアップ、リンティング、テスト、リリースプロセス |
データの取り扱い
合成データの例とテスト用フィクスチャを使用してください。認証情報、証明書、テナントのエクスポートデータ、従業員のペイロード、生成された結果を Git に含めないでください。
.gitignore と scripts/check_repository.py は基本的な防止策であり、秘密情報や個人データを完全に検出するスキャナーではありません。デプロイに関するガイダンスと脆弱性の報告方法については、SECURITY.md を参照してください。
ライセンス
Apache License 2.0。Copyright 2026 Justin Gong。サードパーティおよび移行されたコードの帰属については、NOTICE を参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。