Connecter un client d'IA au serveur MCP de Square Cloud

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.ai et les applications Claude)	OAuth : collez l’adresse et autorisez sur Square Cloud
ChatGPT	OAuth : collez l’adresse et autorisez sur Square Cloud
Claude Code	Clé API dans l’en-tête `Authorization`
VS Code	Clé API dans l’en-tête `Authorization`
Cursor	Clé API dans l’en-tête `Authorization`
Autres clients	Clé API dans l’en-tête `Authorization`

Dans les deux cas, votre compte doit avoir un plan actif.

Claude

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.

Saisir l'adresse

Nommez-le Square Cloud, saisissez https://mcp.squarecloud.app/mcp et cliquez sur Continue.

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.

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.

L'utiliser dans un chat

De retour dans Claude, cliquez sur + dans la zone de saisie, ouvrez Connectors et activez Square Cloud.

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

Ajouter un serveur MCP personnalisé

Ouvrez ChatGPT 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.

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.

Le créer

Lisez l’avertissement, sélectionnez I understand and want to continue puis Create as a plugin.

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.

L'utiliser dans un chat

Démarrez une nouvelle conversation, tapez @ et choisissez Square Cloud.

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.

Claude Code

Claude Code se connecte avec 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 :

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 :

.mcp.json

{
  "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 :

.vscode/mcp.json

{
  "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 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.

Ceci est distinct de l’extension Square Cloud pour VS Code, 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 :

.cursor/mcp.json

{
  "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.

Authorization: Bearer <your API key>

Créer une clé API

Créez la clé dans les paramètres de sécurité de votre compte :

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.
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.

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.

Se déconnecter

Révoquez la clé dans les paramètres de sécurité de votre compte : 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.

CLI

VS Code

MCP

SDKs

Connecter un client d'IA au serveur MCP de Square Cloud

Claude

ChatGPT

Claude Code

VS Code

Cursor

Autres clients

Créer une clé API

Durée d’une connexion

Se déconnecter

​Claude

​ChatGPT

​Claude Code

​VS Code

​Cursor

​Autres clients

​Créer une clé API

​Durée d’une connexion

​Se déconnecter

Claude

ChatGPT

Claude Code

VS Code

Cursor

Autres clients

Créer une clé API

Durée d’une connexion

Se déconnecter