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

# Serveur MCP de Square Cloud

> Connectez Claude, ChatGPT, Claude Code, VS Code ou Cursor à votre compte Square Cloud avec le serveur MCP distant et gérez applications et bases de données depuis le chat.

Le serveur MCP de Square Cloud permet à un client d'IA d'agir sur votre compte via le [Model Context Protocol](https://modelcontextprotocol.io). Demandez en langage courant et le client appelle les [outils](https://docs.squarecloud.app/fr/mcp/tools.md) 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

```text theme={"system"}
https://mcp.squarecloud.app/mcp
```

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](https://docs.squarecloud.app/fr/platform/plans.md) 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](https://docs.squarecloud.app/fr/mcp/connect.md).

## Protocole

| Sujet | Détails |
| - | - |
| Transport | Streamable HTTP, `POST` uniquement. Le serveur ne conserve aucune session, et `GET` répond `405`. |
| Versions du protocole | `2026-07-28`, `2025-11-25`, `2025-06-18` et `2025-03-26`. Les clients de la révision `2026-07-28` appellent directement, sans poignée de main ; les clients plus anciens commencent par `initialize`. Une requête sans `MCP-Protocol-Version` est lue comme `2025-03-26`, et une version non prise en charge répond `400` avec la liste des versions prises en charge. |
| Capacités | Outils uniquement, ni ressources ni prompts. |
| Résultats | Chaque outil répond un objet JSON sous forme de bloc de texte, avec `ok`, un `summary` et, lorsque quelque chose a échoué ou nécessite votre intervention, un `code`. |
| Appels longs | Un appel qui dure plus de quelques secondes reçoit sa réponse sous forme de flux (SSE) avec des signaux de maintien de connexion. Fermer la connexion annule l'appel, et aucun appel ne dure plus de 3 minutes. |

## Ce qui reste hors du MCP

* **Les projets de plus de 1 Mo.** Le client peut envoyer un projet depuis votre ordinateur sous forme de zip de 1 Mo au maximum, avec `upload_application` pour une nouvelle application ou `commit_application` pour une nouvelle version, et des fichiers texte avec `create_application` et `commit_application`. Pour un projet plus gros, utilisez la [CLI](https://docs.squarecloud.app/fr/cli-reference/deploy.md), l'[extension VS Code](https://docs.squarecloud.app/fr/vscode-extension/features.md) ou les [deploys GitHub](https://docs.squarecloud.app/fr/cli-reference/github-deploys.md).
* **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](https://docs.squarecloud.app/fr/mcp/permissions-and-safety.md#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

> [card] [Connecter un client](https://docs.squarecloud.app/fr/mcp/connect.md)
>
> Configurez Claude, ChatGPT, Claude Code, VS Code ou Cursor.

> [card] [Permissions et sécurité](https://docs.squarecloud.app/fr/mcp/permissions-and-safety.md)
>
> Scopes, clés restreintes et snapshots de sécurité.

> [card] [Outils](https://docs.squarecloud.app/fr/mcp/tools.md)
>
> Chaque outil et le scope dont il a besoin.

> [card] [Limites et erreurs](https://docs.squarecloud.app/fr/mcp/limits-and-errors.md)
>
> Les limites de requêtes et d'outils, et la signification de chaque erreur.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.