Skip to content

Connecting to Claude.ai

This guide covers adding an AgentCube connector to Claude.ai as an MCP connector.

Add the Connector

  1. Go to Claude.ai and click the Customize icon in the bottom-left sidebar
  2. Select Connectors
  3. Click the + button and choose Add custom connector
  4. Enter:
    • Connector name: A descriptive name (e.g., AgentCube-Essbase or AgentCube-Planning)
    • Remote MCP server URL: Your connector's MCP endpoint 
      https://{connector_hostname}/mcp

Basic Auth Mode

  1. Leave the Advanced settings (OAuth Client ID and Secret) empty
  2. Click Add

The connector accepts unauthenticated connections in basic auth mode — no additional configuration is needed.

SSO (OIDC) Mode

  1. Leave OAuth Client ID and OAuth Client Secret blank — the connector handles Dynamic Client Registration automatically
  2. Click Add
  3. On first tool use, a browser popup will appear for SSO login. Authenticate with your corporate credentials.

Dynamic Client Registration

AgentCube supports OAuth 2.0 Dynamic Client Registration. Claude.ai automatically registers itself as a client — you do not need to manually configure OAuth credentials in Claude.

Verify the Connection

After adding the connector:

  1. Start a new conversation (connectors added mid-conversation may not activate)
  2. Ask a question that triggers a tool call, for example:
    • "Test the Essbase connection"
    • "Test the EPM Planning connection"
    • "List all applications"
  3. The AI should return data from your environment

Troubleshooting

Issue Resolution
Connector tools don't appear Start a new conversation — connectors added mid-chat may not be active until the next conversation
SSO popup doesn't appear Ensure OIDC_BASE_URL matches the connector's public URL exactly
Authentication fails Verify your identity provider configuration — see SSO Setup
Tools return errors Check the connector health endpoint: https://{connector_hostname}/health