Connect Claude and MCP apps

Use Settings → Integrations (Connected apps) to connect Claude Code or Claude.ai to your Ripple studio over the Model Context Protocol (MCP). Once connected, Claude can read your studio’s games, campaigns and Ripple documentation, create and edit campaign drafts for your studio, and add games to your studio from Steam, link their Twitch category, and archive or restore your games.

MCP connections are available to studio accounts on eligible studios. If MCP access is not yet enabled for your studio, Settings → Integrations displays the Soon badge with “Connecting [app] to your studio is coming soon.” for each application.

What connected apps can and cannot do

When you connect an app, Ripple displays the Requested permissions on the authorization screen and shows a short label for each granted permission in Settings → Integrations.

Requested permission (authorization screen)	Label in Settings → Integrations
Read your studio’s games, campaigns and Ripple documentation.	Read games and campaigns
Create and edit campaign drafts for your studio.	Create and edit campaign drafts
Add games to your studio from Steam, link their Twitch category, and archive or restore your games.	Add and archive games
Keep the connection active between visits, until you revoke it or its renewal expires.	Stay connected between visits

This access does not allow payments or campaign launches.

Connect Claude Code

1. Open Settings → Integrations.
2. In the Connect Claude Code card, find the Claude Code field and select Copy to copy the exact command generated by the app. It has the form:

claude mcp add --transport http ripple <Ripple MCP URL> --client-id <Client ID> --callback-port <Port>

3. Run the copied command in your terminal.
4. In Claude Code, open /mcp and authenticate in your browser.

Connect Claude.ai

1. Open Settings → Integrations.
2. In the Connect Claude card, copy the Ripple MCP URL.
3. Copy the client ID shown in the Claude.ai field (“Add a custom connector with the URL above, then enter this client ID in its advanced settings:”).
4. In Claude.ai, add a custom connector with the Ripple MCP URL, open its advanced settings, and enter the copied client ID (no client secret is used).
5. Start the connection from Claude.ai to open the Ripple authorization flow in your browser.

Authorize studio access

Any studio member can connect an application for their studio; only studio owners and admins can view and revoke other members’ connections.

1. Sign in to your Ripple studio account if prompted, including your two-factor authentication or passkey verification.
2. If your account belongs to more than one eligible studio, choose the studio to connect and select Continue to permissions. If you belong to a single eligible studio, Ripple goes directly to the permissions screen.
3. Under Review permissions, check the Ripple account, Studio, and Requested permissions.
4. Select Allow Claude Code or Allow Claude to grant access, or Decline to cancel.

Each authorization is tied to the studio you selected. Switching your active studio later in Ripple does not change which studio an existing connection accesses.

Manage and revoke connected apps

Open Settings → Integrations to view active connections under Connected apps.

• Every studio member can view and revoke their own connected apps.
• Studio owners and admins can also view and revoke other members’ connections for the studio.
• Each connection row shows the app name, the Connected badge, who authorized it and when, and the granted permission labels.

To disconnect an app:

1. Open Settings → Integrations.
2. Find the connection and select Revoke access.
3. Confirm the revocation when prompted.

After revoking, an access token already issued may remain valid for up to 15 minutes. Reconnecting the app later requires reviewing and accepting permissions again. If Ripple adds a new permission after you connected an app, revoke the connection in Settings → Integrations and connect the app again to grant the new permission.