Overview

The Platform MCP Server can be integrated with both Claude Code and Claude Desktop.

Claude Code is an agentic command line tool that enables developers to delegate coding tasks using natural language prompts.
Claude Desktop is the desktop application that supports conversational brainstorming and queries using the Claude AI assistant.

Although Claude Code is a distinct application from Claude Desktop, a single desktop application may display both a Code tab (Claude Code) and Chat tab (Claude Desktop). Each application connects to the Platform MCP Server independently and must be configured separately; configuring one does not configure the other.

Claude Code

Claude Code can connect to the Platform MCP through MCP to Platform API documentation, tenant data, developer resources on the Intelligent Risk Platform, and Platform MCP tools.

Model Context Protocol (MCP) secures access to MCP Server data resources and operations by defining the scope of MCP client privileges. The scope of MCP Server authorization defines the access rights that are granted to MCP clients.

The Platform MCP Server can be configured with a local (per-directory) or project scope. The user (machine-wide) scope is not supported. The Platform MCP Server supports two scopes: local and project. The user scope is not supported.

Scope	Description	File Location
`local`	A project-specific configuration stored locally that is generally not under version control.	`./claude.json`
`project`	A shared configuration under version control that is shared with everyone with access to a repository.	`<project-dir>/.mcp.json`
`user`	Not supported.	N/A

Configure Claude Code with Local Scope

To configure integration with local scope:

Navigate to the project's root directory.

In the CLI terminal, run the command:


claude mcp add --transport http --scope local irp-integration-mcp \
  https://api-use1.rms.com/platform/integration/v1/mcp \
  --header "Authorization: YOUR_IRP_API_KEY"

The --scope flag is optional and can be omitted if local is specified.

This command writes the Platform MCP Server URL and client credentials to the Claude Code configuration file. The name and location of the Claude Code configuration file depends on whether the scope of the configuration is set to local or project.

If the scope is set to local, the claude.json will look something like the following example. Note that the default scope is not written to the file:

{
  "projects": {
    "/absolute/path/to/current/directory": {
      "mcpServers": {
        "irp-integration-mcp": {
          "type": "http",
          "url": "https://api-use1.rms.com/platform/integration/v1/mcp",
          "headers": {
            "Authorization": "YOUR_IRP_API_KEY"
          }
        }
      }
    }
  }
}

The project directory (/absolute/path/to/directory) is captured automatically when from the current directory.

Configure Claude Code with Project Scope

To configure with project scope:

Navigate to the project's root directory.

In the CLI terminal, run the command:


claude mcp add --transport http --scope project irp-integration-mcp \
  https://api-use1.rms.com/platform/integration/v1/mcp \
  --header "Authorization: YOUR_IRP_API_KEY"

If the scope is set to project, the configuration is written to an .mcp.json file that is stored in the <project-dir>/.mcp.json.

{
  "mcpServers": {
    "irp-integration-mcp": {
      "type": "http",
      "url": "https://api-use1.rms.com/platform/integration/v1/mcp",
      "headers": {
        "Authorization": "${IRP_API_KEY}"
      }
    }
  }
}

Validate Claude Code Connection

To validate connection:

$ claude mcp list
irp-integration-mcp: https://api-euw1.rms-ppe.com/platform/integration/v1/mcp (HTTP) - ✔ Connected

$ claude mcp get irp-integration-mcp

irp-integration-mcp:
  Scope: Local config (private to you in this project)
  Status: ✔ Connected
  Type: http
  URL: https://api-euw1.rms-ppe.com/platform/integration/v1/mcp
  Headers:
    Authorization: ${IRP_API_KEY}

To remove this server, run: claude mcp remove irp-integration-mcp -s local

Claude Desktop

Claude Desktop is a separate product from Claude Code. Like Claude Code, Claude Desktop supports Platform MCP Server integration and can access all Platform MCP Server tools including execute-api.

Configure Claude Desktop

Unlike Claude Code, Claude Desktop does not natively support connecting to remote MCP Servers. mcp-remote is an open-source utility (distributed as an npm package) that allows Claude Desktop to connect to a remote MCP server such as the Platform MCP Server. The mcp-remote package enables the Claude Desktop to access the Platform MCP Server's endpoint. To learn more, see https://www.npmjs.com/package/mcp-remote.

To configure Platform MCP Server integration:

Confirm that the host (MacOS or Windows) machine has Node.js version 18.0 or later installed. If Node.js is missing or is available only in an older version, you must install Node and ensure that version 18 or later is available. For step-by-step instructions, see https://nodejs.org/en/download.
Select Settings > Developer > Edit Config.

The claude_desktop_config.json is displayed.
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add irp-integration-mcp server entry in the claude_desktop_config.json.

The object enables the MCP host to download and run the mcp-remote package.
```
{
  "mcpServers": {
    "irp-integration-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api-use1.rms.com/platform/integration/v1/mcp",
        "--header",
        "Authorization: YOUR_IRP_API_KEY"
      ]
    }
  }
}
```
The configuration defines parameters that enable the Claude Desktop to download and run the mcp-remote package using the npx package runner. The mcp-remote package creates the bridge that enables the Claude Desktop to connect to the specified MCP Server using the specified API key. The -y flag ensures that the installation of the mcp-remote package is automatically accepted.
Restart Claude Desktop.