home / mcp / sap successfactors mcp server

SAP SuccessFactors MCP Server

This read-only MCP Server allows you to connect to SAP SuccessFactors data from Claude Desktop through CData JDBC Drivers. For full CRUD support, check out the first managed MCP platform: CData Connect AI (https://www.cdata.com/ai/).

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cdatasoftware-sap-successfactors-mcp-server-by-cdata": {
      "command": "java",
      "args": [
        "-jar",
        "/PATH/TO/CDataMCP-jar-with-dependencies.jar",
        "/PATH/TO/sap-successfactors.prp"
      ]
    }
  }
}

You run a local, read-only MCP server that exposes SAP SuccessFactors data through a simple MCP interface. It connects to SAP SuccessFactors via the CData JDBC Driver, letting you ask natural language questions and retrieve live data without writing SQL. This server is designed for quick, local querying by large language models and similar clients.

How to use

You connect to the SAP SuccessFactors MCP server from an MCP client (for example Claude Desktop) by running the MCP server locally and then directing the client to the server’s MCP endpoint. Use the built-in tools to read data from the SAP SuccessFactors sources. You can ask questions like how many records exist for a given period, or which fields are available in a specific data set. The tools handle listing tables, listing columns for a table, and running read-only queries against the data source.

Once the server is running, simply ask your AI client a question about the data. The client will use the available MCP tools behind the scenes to fetch tables, columns, or the results of a query, returning the information in a user-friendly format.

How to install

Prerequisites: Java (JDK) installed on your machine. Maven is used to build the MCP server artifact.

Step 1: Build the MCP server artifact.

mvn clean install

Step 2: Download and install the CData JDBC Driver for SAP SuccessFactors from the official source, and license it using the driver’s license command. Follow the standard licensing steps for your OS and place the driver jar in your expected driver path.

Step 3: Create a JDBC connection file for SAP SuccessFactors (sap-successfactors.prp) with your connection details. Use the JDBC Connection String utility to test and obtain the final connection string, then copy it into the sap-successfactors.prp configuration.

Step 4: Prepare the MCP configuration file sap-successfactors.prp with your JDBC connection details and driver information. Example structure:

Prefix=sapsuccessfactors
ServerName=CDataSAPSuccessFactors
ServerVersion=1.0
DriverPath=/path/to/cdata.jdbc.sapsuccessfactors.jar
DriverClass=cdata.jdbc.sapsuccessfactors.SAPSuccessFactorsDriver
JdbcUrl=jdbc:sapsuccessfactors:InitiateOAuth=GETANDREFRESH;
Tables=

Running the server

Run the MCP server on the same machine as the client. The server runs via a stdio configuration, so it communicates with the client on the same host.

java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/sap-successfactors.prp

Configuration and environment

The server uses the provided sap-successfactors.prp file to connect to SAP SuccessFactors through the CData JDBC Driver. Ensure the JDBC driver path, driver class, and JDBC URL match your installation. If your data source requires OAuth, complete authentication in your browser during the connection setup.

Troubleshooting

If the server does not appear in your MCP client, fully quit and restart the client to refresh the MCP server list. Verify that the sap-successfactors.prp file is accessible and that the JDBC Driver is licensed and reachable. If data retrieval fails, double-check the connection string in the prp file and test the connection using the JDBC driver’s utility. For ongoing issues, contact CData Support or join the CData Community for guidance.

Tools and endpoints

The MCP server exposes standard read tools for working with the SAP SuccessFactors data source. Use these tools to discover available data and run queries through the MCP client.

Available tools

sap_successfactors_get_tables

Retrieves a list of tables available in the SAP SuccessFactors data source. The output is returned in CSV format with column headers as the first line.

sap_successfactors_get_columns

Retrieves a list of columns for a specified table. The output is returned in CSV format with column headers as the first line.

sap_successfactors_run_query

Executes a SQL SELECT query against the SAP SuccessFactors data source and returns the results.