Unify and manage your data

Configure Claude to connect with Reltio AgentFlow MCP Server

Learn how to configure the Claude desktop application to securely connect to the Reltio AgentFlow MCP Server so that Claude can access governed, context aware data.

Prerequisites

Before you begin, make sure you have:

  • The MCP feature enabled in the physical configuration of your tenant. Contact Reltio Support if you need help enabling the MCP feature.
  • One of the following roles in your tenant:
    • ROLE_EXECUTE_MCP, or
    • ROLE_ADMIN_MCP
  • The AgentFlow MCP server endpoint,
  • Claude desktop app (version 0.7.0 or later),
  • Permission to access and edit Claude's configuration file on your local machine,
  • Node.js installed.
To configure Claude to connect to Reltio AgentFlow MCP Server:
  1. Locate the configuration file for Claude desktop based on your OS:
    Operating systemConfiguration file path
    Windows%APPDATA%\Claude\claude_desktop_config.json
    macOS~/Library/Application Support/Claude/claude_desktop_config.json
    Linux~/.config/Claude/claude_desktop_config.json
  2. Open or create the configuration file in a JSON-capable text editor with the following base structure:
    
    {
      "mcpServers": {}
    }
                
  3. Add the Reltio AgentFlow MCP Server connection under the mcpServers object.
    AgentFlow MCP via npx
    {
      "mcpServers": {
        "reltio-mcp-server": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://<reltio-namespace>.reltio.com/ai/tools/mcp/",
            "9696",
            "--header",
            "Authorization:${AUTH_HEADER}"
          ],
          "env": {
            "AUTH_HEADER": "Bearer <YOUR_AUTH_TOKEN>"
          }
        }
      }
    }
    
    • Replace <reltio-namespace> with the namespace of your tenant (for example, test). This ensures the MCP connection targets the correct tenant-specific endpoint.
    • Replace <YOUR_AUTH_TOKEN> with a valid authentication token for that tenant. This token authorizes the agent or tool to access the MCP server securely..
    Note:
    • The MCP server listens on port 9696.
    • The npx command fetches and runs the MCP tool automatically.
  4. Save your configuration file.
  5. Validate the JSON file syntax using a validator tool or command-line utility:
    • Windows PowerShell
      
      Get-Content "$env:APPDATA\Claude\claude_desktop_config.json" | ConvertFrom-Json
                           
    • macOS/Linux
      
      python -m json.tool ~/Library/Application\ Support/Claude/claude_desktop_config.json
                           
  6. Restart the Claude desktop application.
    1. Completely exit Claude, ensuring no background processes are running.
    2. Reopen Claude to apply your configuration.
Result

After restart, Claude should connect to the configured Reltio AgentFlow MCP Server. Confirm connectivity by:

  • Checking for the server name in the Claude interface
  • Running a tool or request that invokes the server
  • Using these log locations to troubleshoot errors:
    Operating systemLog location
    Windows%APPDATA%\Claude\logs\
    macOS~/Library/Logs/Claude/
Troubleshooting

Use this section to identify and resolve common issues that can prevent Claude from connecting to the Reltio AgentFlow MCP Server or executing tools correctly.

Bearer token expires and Claude fails to connect
Cause - the configuration uses a Reltio bearer token, which expires after a set duration. When the token becomes invalid, authentication requests to the MCP server will fail with a 403 Forbidden error.
Resolution - generate a new bearer token for your tenant, update the value in the AUTH_HEADER environment variable in the Claude configuration file, and restart the Claude desktop application to apply the changes.
Customer IP not allowlisted for AgentFlow MCP Server access
Cause - Reltio currently applies IP filtering to all MCP environments as a security measure. If your organization has not yet purchased an AgentFlow MCP Server access, your IP address will not be allowlisted. This results in a 403 Forbidden error when trying to connect, even with valid credentials and tokens.
Resolution - Upon AgentFlow MCP Server access activation, Reltio will allowlist your organization's gateway IP addresses to enable secure access without requiring a VPN. If you're a licensed customer and still encountering access issues, contact Reltio Support to ensure your IPs have been allowlisted.