Claude with Caddey

This guide provides detailed instructions on integrating Claude with Caddey using MCP (Model Context Protocol) and OAuth. This setup enables Claude to discover and execute Caddey tools securely. This requires a Claude Pro/Max/Team/Enterprise subscription and an active Caddey OAuth client.

Prerequisites

• Claude account (Pro/Max/Team/Enterprise): Access to Claude’s Custom Connectors (MCP) feature.
• Caddey account: To create an OAuth client and connect tools.

---

Step 1: Create a Caddey OAuth Client

1. Log in to your Caddey dashboard.

2. Go to the Clients section.

3. Click Add client.

4. Enter a name (e.g., "Claude Connector") and description.

5. Select Confidential as the client type.

6. Add the following Redirect URIs:

   • https://claude.ai/api/mcp/auth_callback
   • https://claude.com/api/mcp/auth_callback

   Note: Include both domains. Claude currently uses claude.ai, but may switch to claude.com in the future.

7. Save the client.

8. Copy the Client ID and Client Secret. You will need these in Claude.

---

Step 2: Add Caddey as an MCP Connector in Claude

1. Open Claude (web or desktop).
2. Go to Settings → Connectors (sometimes listed under Integrations).
3. Click Add custom connector.

---

Step 3: Enter MCP Server Details

Fill in the connector form with the following:

• MCP URL: https://api.caddey.ai/mcp
• Auth Method: OAuth2
• Authorization URL: https://auth.caddey.ai/realms/caddey/protocol/openid-connect/auth
• Token URL: https://auth.caddey.ai/realms/caddey/protocol/openid-connect/token
• Client ID: (from Caddey)
• Client Secret: (from Caddey)
• Scope: openid profile email offline_access

Save the connector.

---

Step 4: Authenticate

1. After saving, Claude will prompt you to Connect.
2. Log in with your Caddey account and authorize access.
3. Claude will exchange the code for tokens using your Client ID and Secret.

---

Step 5: Test the Integration

1. In Claude, ask something like: “List my available Caddey tools.”
2. Claude will discover and list tools available through the MCP connection.
3. Then try executing one tool: “Run the [tool name] with these parameters…”
4. If responses come back, your integration is successful.

---

Step 6: Deploy and Use

• You can now chat with Claude and use Caddey’s MCP tools seamlessly.
• To revoke access, remove the connector in Claude or disable the client in Caddey.

---

Support