Establishing a Connection
The CData Code Assist MCP for SAP HANA XSA defines each connection to SAP HANA XSA as a named configuration that an MCP Client (such as Claude Desktop) can use when sending natural language queries.
You create and manage these configurations using the CData Code Assist MCP Configuration Tool. The tool automatically handles formatting, storage, and registration with MCP clients.
Understanding Connection Configurations
Each connection configuration is stored in a .mcp file. This file includes the details needed to initialize the connector when an MCP Client starts a session.
- On Windows, configuration files are stored in "~/AppData/Roaming/CData/SAP HANA XSA Data Provider/".
- On macOS, configuration files are stored in "~/Library/Application Support/CData/SAP HANA XSA Data Provider/".
The .mcp file is a text file that contains a list of connection properties and a timestamp. For example:
#Tue May 20 15:48:40 EDT 2025 AuthScheme=Basic User=myUser Password=myPassword Security Token=myToken
The configuration tool handles these settings automatically. Each saved configuration enables an MCP client to launch a dedicated MCP server instance with the correct connector and options. Manual file editing is not required.
SAP HANA XSA uses the OAuth authentication standard. Before connecting, it is necessary to establish an SAP HANA XSA OData Service. See Creating a Custom OAuth App for a guide.
To connect to SAP Hana XSA using password-based OAuth:
- OAuthClientId: Set this to the Client Id specified in the UAA service JSON file.
- OAuthClientSecret: Set this to the Client Secret specified in the UAA service JSON file.
- URL: Set this to the OData service endpoint.
- XSUAAURL: Set this to the UAA service url.
- User: Set your accounts username.
- Password: Set your accounts password
Once you've configured the OData Service, you can establish a connection using Custom Credentials.