Connect AI client to MCP server

Connect to the MCP server from known AI clients: Claude Desktop, VS Code and IntelliJ with GitHub Copilot, and Cursor.

In this topic:

Connect an AI client

Perform the following steps to add the OpenText Core Software Delivery Platform MCP to an AI client.

To connect an AI client:

1. Add the MCP configuration to your client. Do one of the following:

   • Select the OpenText Core Software Delivery Platform MCP from your organization's approved MCP registry.

   • Manually add a record to your tool's configuration or MCP JSON file. See the JSON structure for your client in the sections below.

2. When prompted, enter the appropriate client_id for your tool from the following table:

   Tool	Client ID
   GitHub Copilot Intellij	copilot_sdp
   GitHub Copilot VS Code	copilot_sdp_vs
   Claude Desktop	sdp_claude

Manually add an MCP record

If your organization does not maintain an MCP registry, you need to manually add a JSON entry for OpenText Core Software Delivery Platform MCP to your tool's configuration file. Follow the instructions for your tool in the below sections.

General notes:

• Refer to the respective tool's documentation to locate the tool's MCP JSON configuration file.

• Replace https://myoctane.company.com/mcp with your actual base URL and /mcp suffix.

  For cloud tenants, the possible addresses are:

  • https://almoctane-ams.saas.microfocus.com/mcp

  • https://almoctane-apj.saas.microfocus.com/mcp

  • https://almoctane-eur.saas.microfocus.com/mcp

  Use the server that your tenant is hosted on.

• Replace <server-name> with a descriptive label for this server (for example, octane). The name appears in the client's MCP server list and must be unique among your configured servers.

• Replace <client_id> with your OAuth client ID.

• If you are using API key authentication, the entry should include also an authorization header with the API access token. Replace <your-token> with your API access token.

  Avoid embedding API tokens as plain text in configuration files. Where the AI client supports it, use an environment variable or a client-managed input variable instead.

• If you are using OAuth authentication, the JSON entry does not need a headers section.

Claude desktop

{
    "mcpServers": {
        "<server-name>": {
            "command": "npx.cmd",
            "args": [
                "-y",
                "mcp-remote",
                "https://myoctane.company.com/mcp",
                "--static-oauth-client-info",
                "{\"client_id\": \"<client_id>\"}"
            ]
        }
    }
}

{
    "mcpServers": {
        "<server-name>": {
            "command": "npx.cmd",
            "args": [
                "-y",
                "mcp-remote",
                "https://myoctane.company.com/mcp",
                "--header",
                "Authorization: Bearer <your-token>"
            ]
        }
    }
}

VS Code and IntelliJ with GitHub Copilot

{
    "servers": {
        "<server-name>": {
            "type": "http",
            "url": "https://myoctane.company.com/mcp"
        }
    }
}

{
    "servers": {
        "<server-name>": {
            "type": "http",
            "url": "https://myoctane.company.com/mcp",
            "headers": {
                "Authorization": "Bearer <your-token-or-variable>"
            }
        }
    }
}

Cursor

{
  "mcpServers": {
    "<server-name>": {
      "url": "https://myoctane.company.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "<server-name>": {
      "url": "https://myoctane.company.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Tips and tricks

Use the following tips and tricks when working with the MCP.

Set a default workspace in your agent instructions

Add context information to your agent instructions file to skip discovery calls in every session:

## OpenText SDP (SDM) MCP
When connected to opentext-sdm MCP:
- **MUST** use workspace ID = <your-workspace-id>
- **MUST** use sharedSpaceId = <your-shared-space-id>
- **MUST** use base URL = "https://myoctane.company.com"

Use natural language for filtering

The get_entities tool supports rich filtering. Describe what you need in natural language and let the AI client translate it to the correct filter syntax using get_filter_metadata first.