如何通过 MCP 将 SAP SuccessFactors 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → SAP SuccessFactors、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

SAP SuccessFactors + Cursor

通过 OData API 读取 SAP SuccessFactors Employee Central：员工、职位信息、人员、公司、部门、岗位和休假，另有可读取任何其他实体的通用 OData 工具。OAuth 2.0 SAML bearer，只读。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

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，client id 填 API key，再填入 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 将于 2026 年 11 月 20 日停用这些 API 的 HTTP Basic 认证，因此本连接器不提供该方式。

只读：AI 只读取数据，不会修改 SuccessFactors 中的任何内容。每次调用都以断言中指定的 API 用户身份运行，因此 AI 能看到什么由 SuccessFactors 的基于角色的权限决定。

可读取的内容：带 userId 的员工档案，职位信息（公司、部门、岗位、上级、雇佣状态），包含个人信息、电子邮件和电话的人员记录，法人实体，部门，带空缺标记和 FTE 的岗位，以及休假申请。对于其他任何实体，sap_successfactors_get_entity_metadata 会列出其字段，通用 OData 工具负责读取。

生效日期：职位信息、公司、部门和岗位返回今天有效的记录。需要历史数据时，请指定日期或日期范围。

限制：每页最多 1000 行，AI 会用筛选条件缩小大型列表。SAP 会按租户限制高强度的 API 使用，因此 AI 按最后修改日期筛选，而不是反复读取所有用户。

须知：未激活的用户只有在按状态查询时才会出现；选择列表字段返回的是代码，除非 AI 展开其标签。

本连接器不办理入职，不修改职位或薪酬数据，不审批休假，也不向任何 SuccessFactors 实体写入数据。

步骤 2 — 安装 adapter

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. 开始对话，智能体现在可以调用 SAP SuccessFactors 的工具。

可用工具

示例提示

• “我们每个部门有多少在职员工？每个部门由谁负责？”
• “下周谁不在岗？哪些休假申请还在等待审批？”
• “列出我们的空缺岗位，以及所属公司、部门和 FTE。”
• “展示员工 10234 过去两年的职位历史：部门、岗位和上级的变动。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT