Connecting to Claude.ai¶

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

Add the Connector¶

Go to Claude.ai → Settings → MCP Connectors (or Project settings for project-level connectors)
Click Add custom connector
Enter:
- Connector name: A descriptive name (e.g., Essbase or Planning)
- Remote MCP server URL: Your connector's MCP endpoint
```
https://{connector_hostname}/mcp
```

Basic Auth Mode¶

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

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

SSO (OIDC) Mode¶

Leave OAuth Client ID and OAuth Client Secret blank — the connector handles Dynamic Client Registration automatically
Click Add
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:

Start a new conversation (connectors added mid-conversation do not activate)
Ask a question that triggers a tool call, for example:
- "List all Essbase applications"
- "What plan types are available in [application name]?"
The AI should return data from your Oracle environment

Troubleshooting¶

Issue	Resolution
Connector tools don't appear	Start a new conversation — connectors added mid-chat are not 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`