Configuration

irt:
  mcp:
    connector:
      enabled: true

      issuer-uri: https://<your-host>

      dynamic-client-registration-enabled: false

      allowed-redirect-uris:
        - https://claude.ai/api/mcp/auth_callback

Configuration description

enabled

Enables or disables the whole MCP connector subsystem.

issuer-uri

The public HTTPS base URL that Claude uses to reach this instance.

This value becomes the OAuth issuer. All discovery, authorization, and token URLs advertised by the connector are built from this value, so it must match the hostname that Claude actually calls.

This property is required for dynamic client registration. The DCR registration_endpoint is advertised in discovery only when issuer-uri is set.

Example:

irt.mcp.connector.issuer-uri=https://<qa-instance-public-url>

dynamic-client-registration-enabled

Controls whether the open anonymous client registration endpoint, based on RFC 7591 /connect/register, is active and advertised in discovery.

When set to false(default case). Claude will not self-register. In this case, you must create the OAuth client manually from the OAuth Clients screen in the figaf tool.

This is the safest and default case.

When set to true, Claude can self-register automatically when you add the connector.

allowed-redirect-uris

Defines the allowed redirect URIs. Any client registration, manual or dynamic, is rejected if its redirect_uri is not included in this list.

By default, this should include Claude’s real callback URL:

https://claude.ai/api/mcp/auth_callback

Claude Connector Setup

1. Log in to your BTP instance

Log in to your BTP instance using your credentials.

2. Create an OAuth client

Go to the OAuth Clients section and create an authorization client with a client_id and client_secret.

3. Add the custom connector in Claude

Open:

https://claude.ai/customize/connectors

Click Add custom connector.

4. Enter the connector details

In the popup, enter the MCP endpoint:

https://<your-btp-host>/api/mcp

Then enter the client_id and client_secret created in step 3.

5. Verify the connector tools

After the connector is added, confirm that all expected tools are available in:

https://claude.ai/customize/connectors