mcpField
S
SAP SuccessFactors

SAP SuccessFactors

ローカル
github.comビジネス・マーケティング45 日前に更新

SAP SuccessFactors について

SuccessFactors Toolkitは、SAP SuccessFactors APIのトラブルシューティング、データ抽出、連携開発向けのセルフホスト可能なツールキットです。REST APIとMCPを通じてCompound Employee SOAPやODataを扱い、PIIのトークン化にも対応します。

主な機能

  1. 01SOAPによるCompound Employee照会
  2. 02OData v2・v4クエリ対応
  3. 03APIデータの抽出と絞り込み
  4. 04REST APIとMCPの提供
  5. 05PIIのトークン化とエクスポート

活用シーン

  1. 01SuccessFactors API呼び出しの調査
  2. 02連携開発向けの従業員データ抽出
  3. 03AIエージェントによるSuccessFactorsデータ照会

MCP 対応

このツールキットはMCPサーバーを提供し、SuccessFactorsのCompound EmployeeおよびODataの照会機能をAIエージェントに公開します。データ処理とエクスポートにも対応し、機微データにはローカルDockerでの運用を推奨しています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"wudaoyou-successfactors-toolkit": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/wudaoyou/successfactors-toolkit:v0.7.0"
]
}
}
}
起動コマンドdocker run -i --rm docker.io/wudaoyou/successfactors-toolkit:v0.7.0

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocidocker.io/wudaoyou/successfactors-toolkit:v0.7.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

SuccessFactors Toolkit

CI License Python

SAP SuccessFactors API のトラブルシューティング、ペイロードの抽出、統合開発のためのセルフホスト可能なツールキットです。REST API と MCP(Model Context Protocol)サーバーとして公開されています。

APIプロトコルエンドポイントのプレフィックス
EC SFAPI — Compound EmployeeSOAP 1.1/api/sfapi/ce/
ODataREST (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 の初回セットアップと、承認済みの接続ファイルの提供を依頼してください。その後、次の手順に進みます。

  1. Docker Desktop または IT 管理の Docker サービスが起動していることを確認し、ローカルの AI アプリケーションを開きます。
  2. 接続ファイルが sf-toolkit/credentials/systems にあり、SuccessFactors システムごとにフォルダーが分かれていることを IT 担当者に確認します。
  3. 使用する SuccessFactors システムを確認し、必要な従業員、日付、情報を指定します。
  4. 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 APIexecute / 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 を参照してください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。