Caddey

Connecting your AI agent

Learn how to connect your AI agent to Caddey using OAuth for secure access to tools and toolboxes.

Connecting your AI agent to Caddey lets it discover, search, and execute tools from your connected toolboxes securely. This guide explains how to create an OAuth client that represents your AI agent and configure its access to toolboxes.

Step 1: Navigate to the Clients section

  1. Log in to your Caddey account.
  2. Open the Caddey dashboard.
  3. Select the Clients tab from the sidebar menu.

Step 2: Create a new OAuth client

  1. Click "Add client"
    In the Clients section, click the Add client button to begin.

  2. Provide client details

    • Enter a name for your AI agent (e.g., "My ChatGPT Assistant").
    • Optionally, add a brief description to explain its purpose.
    • Choose Confidential as the client type for secure OAuth authentication.

  3. Save the client Once you've entered the details, save the client. You'll receive a Client ID and Client Secret that represent your AI agent.

Important: Most AI agent integrations (like ChatGPT, Copilot, etc.) require a client secret for OAuth authentication, so you must use a Confidential client type for secure authentication.

Step 3: Note your OAuth configuration

  • Client ID: This identifies your AI agent to Caddey's OAuth system.
  • Client Secret: This authenticates your AI agent securely.
  • Authorization URL: https://auth.caddey.ai/realms/caddey/protocol/openid-connect/auth
  • Token URL: https://auth.caddey.ai/realms/caddey/protocol/openid-connect/token
  • Important: Keep your Client ID and Client Secret secure, as both will be needed to integrate your AI agent.

Step 4: Connect toolboxes to the client

  1. Within the client settings, click Add Toolbox.
  2. Select from the list of available toolboxes that you want your AI agent to access.
  3. Save your selections to grant the client access to the chosen toolboxes.

Step 5: Integrate your AI agent

These guides provide detailed instructions on setting up OAuth authentication or MCP integration for your AI agent.

Tips for managing OAuth clients

  • Keep your Client ID and Client Secret secure: Treat both your Client ID and Client Secret like passwords and regenerate them if compromised.
  • Organize clients logically: Name clients clearly to make management easier (e.g., "Production ChatGPT", "Dev Assistant").
  • Update toolbox connections as needed: You can add or remove toolboxes from a client at any time based on your workflow needs.

Need assistance? Visit the Support Section.

Building a toolboxChatGPT