Connecter Claude et les applications MCP

Utilisez Settings → Integrations (Connected apps) pour connecter Claude Code ou Claude.ai à votre studio Ripple via le Model Context Protocol (MCP). Une fois connecté, Claude peut lire les jeux et les campagnes de votre studio ainsi que la documentation Ripple, créer et modifier des brouillons de campagne pour votre studio, et ajouter des jeux à votre studio depuis Steam, associer leur catégorie Twitch et archiver ou restaurer vos jeux.

Les connexions MCP sont disponibles pour les comptes studio des studios éligibles. Si l’accès MCP n’est pas encore activé pour votre studio, Settings → Integrations affiche le badge Soon avec la mention « Connecting [app] to your studio is coming soon. » pour chaque application.

Ce qu’une application connectée peut et ne peut pas faire

Lorsque vous connectez une application, Ripple affiche les permissions demandées (Requested permissions) sur l’écran d’autorisation, puis affiche un libellé court pour chaque permission accordée dans Settings → Integrations.

Permission demandée (écran d’autorisation)	Libellé dans Settings → Integrations
Read your studio’s games, campaigns and Ripple documentation. (Lire les jeux et les campagnes de votre studio ainsi que la documentation Ripple.)	Read games and campaigns
Create and edit campaign drafts for your studio. (Créer et modifier des brouillons de campagne pour votre studio.)	Create and edit campaign drafts
Add games to your studio from Steam, link their Twitch category, and archive or restore your games. (Ajouter des jeux à votre studio depuis Steam, associer leur catégorie Twitch, et archiver ou restaurer vos jeux.)	Add and archive games
Keep the connection active between visits, until you revoke it or its renewal expires. (Maintenir la connexion active entre les visites, jusqu’à sa révocation ou l’expiration de son renouvellement.)	Stay connected between visits

Cet accès ne permet ni les paiements ni le lancement de campagnes (« This access does not allow payments or campaign launches. »).

Connecter Claude Code

1. Ouvrez Settings → Integrations.
2. Dans la carte Connect Claude Code, repérez le champ Claude Code et sélectionnez Copy pour copier la commande exacte générée par l’application. Elle a la forme :

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

3. Exécutez la commande copiée dans votre terminal.
4. Dans Claude Code, ouvrez /mcp et authentifiez-vous dans votre navigateur.

Connecter Claude.ai

1. Ouvrez Settings → Integrations.
2. Dans la carte Connect Claude, copiez Ripple MCP URL.
3. Copiez l’identifiant affiché dans le champ Claude.ai (« Add a custom connector with the URL above, then enter this client ID in its advanced settings: »).
4. Dans Claude.ai, ajoutez un connecteur personnalisé avec la Ripple MCP URL, ouvrez ses paramètres avancés et saisissez le Client ID copié (aucun client secret n’est utilisé).
5. Lancez la connexion depuis Claude.ai pour ouvrir le parcours d’autorisation Ripple dans votre navigateur.

Autoriser l’accès au studio

Tout membre du studio peut connecter une application pour son studio ; seuls les propriétaires (Owner) et administrateurs (Admin) peuvent voir et révoquer les connexions des autres membres.

1. Connectez-vous à votre compte studio Ripple si cela vous est demandé, y compris la vérification par double authentification (2FA) ou passkey.
2. Si votre compte appartient à plusieurs studios éligibles, choisissez le studio à connecter puis sélectionnez Continue to permissions. Si vous n’appartenez qu’à un seul studio éligible, Ripple ouvre directement l’écran des permissions.
3. Sous Review permissions, vérifiez le compte (Ripple account), le studio (Studio) et les permissions demandées (Requested permissions).
4. Sélectionnez Allow Claude Code ou Allow Claude pour autoriser l’accès, ou Decline pour annuler.

Chaque autorisation est liée au studio sélectionné. Changer de studio actif plus tard dans Ripple ne modifie pas le studio auquel une connexion existante a accès.

Gérer et révoquer les applications connectées

Ouvrez Settings → Integrations pour voir les connexions actives sous Connected apps.

• Chaque membre du studio peut voir et révoquer ses propres applications connectées.
• Les propriétaires (Owner) et administrateurs (Admin) du studio peuvent également voir et révoquer les connexions des autres membres du studio.
• Chaque ligne affiche le nom de l’application, le badge Connected, la personne qui l’a autorisée et la date, ainsi que les libellés des permissions accordées.

Pour déconnecter une application :

1. Ouvrez Settings → Integrations.
2. Repérez la connexion et sélectionnez Revoke access.
3. Confirmez la révocation lorsque la fenêtre de confirmation s’affiche.

Après la révocation, un jeton d’accès déjà émis peut rester valide pendant 15 minutes au maximum (« After revoking, an access token already issued may remain valid for up to 15 minutes. »). Reconnecter l’application plus tard nécessite de relire et d’accepter à nouveau les permissions. Si Ripple ajoute une nouvelle permission après la connexion initiale d’une application, révoquez la connexion dans Settings → Integrations puis reconnectez l’application pour accorder cette nouvelle permission.