> ## Documentation Index > Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt > Use this file to discover all available pages before exploring further. # Connecter un client d'IA au serveur MCP de Square Cloud > Connectez Claude et ChatGPT avec OAuth, ou Claude Code, VS Code et Cursor avec une clé API, au serveur MCP de Square Cloud, et découvrez combien de temps dure une connexion. Tous les clients utilisent la même adresse, `https://mcp.squarecloud.app/mcp`. La façon de se connecter dépend du client : | Client | Mode de connexion | | - | - | | [Claude](#claude) (claude.ai et les applications Claude) | OAuth : collez l'adresse et autorisez sur Square Cloud | | [ChatGPT](#chatgpt) | OAuth : collez l'adresse et autorisez sur Square Cloud | | [Claude Code](#claude-code) | [Clé API](#créer-une-clé-api) dans l'en-tête `Authorization` | | [VS Code](#vs-code) | [Clé API](#créer-une-clé-api) dans l'en-tête `Authorization` | | [Cursor](#cursor) | [Clé API](#créer-une-clé-api) dans l'en-tête `Authorization` | | [Autres clients](#autres-clients) | [Clé API](#créer-une-clé-api) dans l'en-tête `Authorization` | Dans les deux cas, votre compte doit avoir un [plan](https://docs.squarecloud.app/fr/platform/plans.md) actif. ## Claude **1. Ajouter un connecteur personnalisé** Dans Claude, ouvrez **Customize > Connectors**, cliquez sur **+ Add** puis sur **Add custom connector**. Sur les plans Team et Enterprise, un propriétaire l'ajoute d'abord dans **Organization settings > Connectors** (**Add > Custom > Web**), puis chaque membre le connecte depuis **Customize > Connectors**. **2. Saisir l'adresse** Nommez-le `Square Cloud`, saisissez `https://mcp.squarecloud.app/mcp` et cliquez sur **Continue**. **3. Conserver l'identité propre de Claude** Gardez une option de connexion (**Sign in now** ou **Sign in when needed**) et, comme client OAuth, **Use Claude's published identity (Recommended)**. Laissez **Request headers** vide et cliquez sur **Add**. **4. Autoriser sur Square Cloud** Claude ouvre une page Square Cloud. Connectez-vous si nécessaire, vérifiez les permissions demandées par Claude et cliquez pour autoriser. Vous pouvez décocher des permissions pour donner moins d'accès à Claude ; `mcp` reste toujours, puisque c'est lui qui établit la connexion. **5. L'utiliser dans un chat** De retour dans Claude, cliquez sur **+** dans la zone de saisie, ouvrez **Connectors** et activez **Square Cloud**. > [!NOTE] > > Square Cloud n'accepte que l'identité publiée de Claude. **Register automatically** et **Use your own OAuth client** ne fonctionnent pas avec lui. ## ChatGPT **1. Ajouter un serveur MCP personnalisé** Ouvrez [ChatGPT Plugins](https://chatgpt.com/plugins), sélectionnez **+** puis **Add custom MCP server**. Selon votre plan ChatGPT, un administrateur du workspace devra peut-être d'abord autoriser les serveurs MCP personnalisés. **2. Saisir l'adresse** Nommez-le `Square Cloud`, choisissez l'endpoint public comme connexion et saisissez `https://mcp.squarecloud.app/mcp`. Choisissez OAuth pour l'authentification. **3. Le créer** Lisez l'avertissement, sélectionnez **I understand and want to continue** puis **Create as a plugin**. **4. Autoriser sur Square Cloud** Lorsque ChatGPT vous demande de vous connecter, il ouvre une page Square Cloud. Connectez-vous si nécessaire, vérifiez les permissions et cliquez pour autoriser. Vous pouvez décocher des permissions ; `mcp` reste toujours. **5. L'utiliser dans un chat** Démarrez une nouvelle conversation, tapez `@` et choisissez **Square Cloud**. > [!NOTE] > > ChatGPT change de temps en temps le nom de ces menus. S'ils diffèrent, suivez le [guide d'OpenAI pour connecter un serveur MCP](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt). ## Claude Code Claude Code se connecte avec une [clé API](#créer-une-clé-api) dans un en-tête, pas avec OAuth. Placez la clé dans la variable d'environnement `SQUARECLOUD_API_KEY` et exécutez : ```bash theme={"system"} claude mcp add --transport http squarecloud https://mcp.squarecloud.app/mcp \ --header "Authorization: Bearer $SQUARECLOUD_API_KEY" ``` Votre shell insère la clé au moment où vous exécutez la commande, et Claude Code l'enregistre dans sa propre configuration. Pour partager le serveur avec un projet sans partager la clé, ajoutez-le plutôt au fichier `.mcp.json` du projet ; Claude Code lit la variable à chaque démarrage : ```json .mcp.json theme={"system"} { "mcpServers": { "squarecloud": { "type": "http", "url": "https://mcp.squarecloud.app/mcp", "headers": { "Authorization": "Bearer ${SQUARECLOUD_API_KEY}" } } } } ``` Vérifiez la connexion avec `claude mcp list`, ou avec `/mcp` dans Claude Code. ## VS Code Ajoutez le serveur à `.vscode/mcp.json` dans votre projet, ou à votre configuration utilisateur avec **MCP: Open User Configuration** depuis la palette de commandes : ```json .vscode/mcp.json theme={"system"} { "inputs": [ { "type": "promptString", "id": "squarecloud-api-key", "description": "Square Cloud API key", "password": true } ], "servers": { "squarecloud": { "type": "http", "url": "https://mcp.squarecloud.app/mcp", "headers": { "Authorization": "Bearer ${input:squarecloud-api-key}" } } } } ``` VS Code demande la [clé API](#créer-une-clé-api) au démarrage du serveur, elle ne reste donc jamais dans le fichier. Démarrez, arrêtez ou redémarrez le serveur avec **MCP: List Servers**. > [!TIP] > > Ceci est distinct de l'[extension Square Cloud pour VS Code](https://docs.squarecloud.app/fr/vscode-extension/installation.md), qui gère vos applications depuis la barre latérale. Vous pouvez utiliser les deux. ## Cursor Ajoutez le serveur à `.cursor/mcp.json` dans votre projet, ou à `~/.cursor/mcp.json` pour tous vos projets : ```json .cursor/mcp.json theme={"system"} { "mcpServers": { "squarecloud": { "url": "https://mcp.squarecloud.app/mcp", "headers": { "Authorization": "Bearer ${env:SQUARECLOUD_API_KEY}" } } } } ``` Définissez `SQUARECLOUD_API_KEY` dans votre environnement avant d'ouvrir Cursor. Activez le serveur dans le menu **Customize** de Cursor ; s'il ne se connecte pas, le canal **MCP Logs** du panneau de sortie (Output) en indique la raison. ## Autres clients Tout client qui prend en charge les serveurs MCP distants via Streamable HTTP avec un en-tête personnalisé fonctionne de la même façon : utilisez l'adresse `https://mcp.squarecloud.app/mcp` et envoyez la clé API dans l'en-tête `Authorization`. Le préfixe `Bearer ` est facultatif. ```http theme={"system"} Authorization: Bearer ``` ## Créer une clé API Créez la clé dans les [paramètres de sécurité de votre compte](https://squarecloud.app/fr/account/security) : * **Donnez-lui le scope `mcp`**, ainsi que les scopes des outils que le client doit pouvoir utiliser. Une clé à accès complet fonctionne aussi. Consultez [Scopes](https://docs.squarecloud.app/fr/mcp/permissions-and-safety.md#scopes). * **Pour un accès en lecture seule**, choisissez `mcp`, `apps:read`, `files:read`, `envs:read`, `snapshots:read` et `databases:read`. * **Pour limiter le client à certaines applications et bases de données**, restreignez la clé à celles-ci. Consultez [Clés restreintes](https://docs.squarecloud.app/fr/mcp/permissions-and-safety.md#clés-restreintes-à-des-applications-et-bases-de-données). Le secret ne s'affiche qu'une seule fois. Conservez-le dans une variable d'environnement ou dans le stockage des secrets de votre client, jamais dans un chat ni dans un fichier que vous commitez. Les clés que vous créez n'expirent pas : révoquez la clé lorsque vous ne l'utilisez plus. Un compte peut détenir jusqu'à 10 clés. ## Durée d'une connexion **Claude et ChatGPT (OAuth).** L'autorisation crée une clé API pour ce client, nommée d'après lui (`Claude` ou `ChatGPT`) : * Elle est valable **90 jours** et n'a pas de jeton de rafraîchissement. Lorsqu'elle expire, le client vous demande de vous connecter et d'autoriser à nouveau. * Elle ne fonctionne que sur le serveur MCP. Sur l'API REST, elle répond `403 MISSING_SCOPE`. * **Connecter à nouveau le même client révoque sa clé précédente.** Chaque compte conserve une connexion Claude et une connexion ChatGPT, donc connecter un second compte Claude déconnecte le premier. Pour garder plusieurs connexions à la fois, donnez à chaque connexion supplémentaire sa propre clé API. Dans Claude, un connecteur personnalisé peut aussi envoyer une clé API : choisissez **No sign in** sous **Authentication** et ajoutez l'en-tête `Authorization` dans **Request headers**. Sur les plans Team et Enterprise, toutes les personnes qui utilisent ce connecteur partagent l'accès de la clé. **Les clés API que vous créez** n'expirent pas. Quel que soit le mode d'accès, toutes les connexions MCP d'un compte partagent les mêmes [limites](https://docs.squarecloud.app/fr/mcp/limits-and-errors.md). ## Se déconnecter Révoquez la clé dans les [paramètres de sécurité de votre compte](https://squarecloud.app/fr/account/security) : la clé `Claude` ou `ChatGPT` pour une connexion OAuth, ou la clé que vous avez créée. L'accès prend fin à la requête suivante du client. Supprimer le connecteur ou le serveur dans le client l'empêche d'appeler, mais seule la révocation de la clé sur Square Cloud l'invalide. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.