Passer au contenu principal
Le serveur MCP de Square Cloud permet à un client d’IA d’agir sur votre compte via le Model Context Protocol. Demandez en langage courant et le client appelle les outils pour vous : consulter le statut, les logs, les métriques et le trafic edge, lire et modifier des fichiers, gérer les variables d’environnement, démarrer et redémarrer des applications, créer des applications, des bases de données et des snapshots, et plus encore.
  • Distant, rien à installer : une seule adresse HTTPS pour tous les clients.
  • Deux façons de se connecter : Claude et ChatGPT se connectent avec OAuth sur une page de consentement Square Cloud. Claude Code, VS Code, Cursor et les autres clients envoient une clé API.
  • Vos permissions décident : une connexion ne voit que les outils couverts par ses scopes, et une clé limitée à certaines applications et bases de données n’atteint que celles-ci.
  • Votre client demande, vos données restent protégées : la demande d’autorisation de votre client décide quelles modifications s’exécutent, et la suppression d’une application ou d’une base de données ou la restauration d’un snapshot prend d’abord un snapshot de sécurité.

​
Endpoint

C’est la seule adresse du serveur MCP. Sur api.squarecloud.app ou toute autre adresse Square Cloud, les requêtes MCP répondent 421 WRONG_HOST avec la bonne adresse. À l’inverse, mcp.squarecloud.app ne sert que le serveur MCP, jamais l’API REST.

​
Prérequis

  • Un plan actif. Le serveur MCP fait partie de tous les plans Square Cloud, à partir de Hobby. Sans plan actif, chaque requête répond 403 UPGRADE_REQUIRED. Si votre plan expire, vos connexions sont conservées et fonctionnent à nouveau dès le renouvellement du plan.
  • Un client MCP qui prend en charge les serveurs distants via Streamable HTTP, comme Claude, ChatGPT, Claude Code, VS Code ou Cursor. Consultez Connecter un client.

​
Protocole

​
Ce qui reste hors du MCP

  • Le déploiement d’un dossier depuis votre ordinateur. Le MCP agit sur ce qui est déjà sur Square Cloud. Envoyez un projet avec la CLI, l’extension VS Code ou les deploys GitHub.
  • Les téléchargements de snapshots et de certificats de base de données. Le lien de téléchargement signé se retrouverait dans la conversation et chez le fournisseur du modèle d’IA. Téléchargez-les depuis le tableau de bord.
  • L’activité du compte. Elle affiche les adresses IP et les appareils de votre compte, elle reste donc dans le tableau de bord.
  • Les valeurs secrètes. Les valeurs des variables d’environnement, les fichiers .env et les clés privées n’atteignent jamais le client d’IA. Consultez Secrets.
  • Les paramètres du compte, la facturation, les clés API et les membres des workspaces. Ils se gèrent dans le tableau de bord.

​
Prochaines étapes

Connecter un client

Configurez Claude, ChatGPT, Claude Code, VS Code ou Cursor.

Permissions et sécurité

Scopes, clés restreintes et snapshots de sécurité.

Outils

Chaque outil et le scope dont il a besoin.

Limites et erreurs

Les limites de requêtes et d’outils, et la signification de chaque erreur.