Qu’est-ce que Square MCP Server ?
Square, qui fait partie de Block, héberge son serveur MCP à https://mcp.squareup.com/mcp avec connexion OAuth ; un ancien endpoint /sse est encore servi. Seuls les clients approuvés peuvent se connecter, pour se prémunir contre l'enregistrement de client malveillant, et la documentation liste Claude.ai, Claude Desktop, Goose, Cursor et Windsurf. Le serveur hébergé n'atteint que les données de production, et tout le projet est encore étiqueté bêta.
Pour les tests en bac à sable, vous faites tourner le serveur local open source avec npx square-mcp-server start, un ACCESS_TOKEN et SANDBOX=true. DISALLOW_WRITES=true le rend en lecture seule et SQUARE_VERSION épingle la version de l'API. Le paquet npm n'a eu aucune version depuis 0.1.2 le 25 avril 2025, bien que le README du dépôt ait été révisé en octobre 2026 pour orienter la plupart des utilisateurs vers le serveur hébergé.
Plutôt qu'un outil par endpoint, il en a trois : get_service_info pour découvrir les méthodes d'un service, get_type_info pour récupérer les détails des paramètres, et make_api_request pour appeler l'API. Cela atteint 38 services Square, dont les paiements, remboursements, commandes, catalogue, inventaire, factures, paiements sortants, main-d'œuvre et fidélité.
Installer Square MCP Server
https://mcp.squareup.com/mcpSquare MCP Server vaut-il le coup ?
Square prend la même route que les outils génériques de Stripe : trois outils qui laissent l'agent découvrir et appeler n'importe lequel des 38 services Square. Cela garde la liste d'outils petite, ce qui aide quand plusieurs serveurs partagent une fenêtre de contexte, et signifie qu'un vendeur peut poser des questions sur le catalogue, les commandes, les clients ou les paiements sortants sans attendre un outil dédié.
Le prix des outils génériques est que le modèle doit trouver la bonne méthode et assembler le corps de la requête lui-même, et les issues ouvertes montrent où cela tourne mal. L'issue #20 (avril 2026) rapporte que make_api_request envoie des tableaux vides pour des champs comme location_ids, ce qui casse la recherche de commandes, et échoue à résoudre les paramètres de chemin. L'issue #31 (septembre 2026) argumente que la description de CreatePayment dit au modèle de générer une nouvelle clé d'idempotence à chaque appel, si bien qu'une requête relancée pourrait débiter une carte deux fois. L'issue #27 note que les noms génériques entrent en collision avec les outils d'autres serveurs, si bien qu'un modèle route parfois une question de paiements vers Stripe.
Le serveur hébergé n'atteint que la production, ce qui s'accorde mal avec le propre conseil de Square de tester les prompts en bac à sable d'abord : le faire signifie lancer le paquet local avec un jeton, et l'interrupteur de lecture seule DISALLOW_WRITES n'existe que là. La documentation ne nomme aucune portée OAuth pour le serveur hébergé, et ne publie aucune limite de débit ni condition de rétention de données pour le endpoint MCP.
Pour des questions en lecture seule sur l'activité d'un vendeur, comme les articles les plus vendus du mois dernier ou les factures en retard, la conception marche et ne coûte rien au-delà des frais Square normaux. Les écritures qui touchent les paiements, remboursements ou l'inventaire méritent une approbation humaine à chaque appel jusqu'à ce que les issues #20 et #31 soient fermées.
Là où il fait la différence
Le propriétaire d'un café à deux emplacements sur Square
Découvrir quels articles de menu se sont le mieux vendus le mois dernier et lesquels ont à peine bougé
Dans Claude, l'agent interroge les commandes et le catalogue via make_api_request sur le serveur hébergé. Pas de frais supplémentaires ; approuvez chaque appel, puisque le même outil peut aussi écrire, et une recherche de commandes qui échoue sur location_ids est le bug ouvert #20, pas le prompt.
Un développeur qui construit une intégration Square pour un client de détail
Explorer des endpoints Square inconnus contre des données de test
Lancez npx square-mcp-server start avec SANDBOX=true et DISALLOW_WRITES=true ; get_service_info et get_type_info font office de référence d'API interactive. Gratuit, et rien ne touche à de l'argent réel.
Avant de vous engager
- Mise en route
- Ajoutez https://mcp.squareup.com/mcp dans un client approuvé (Claude.ai, Claude Desktop, Goose, Cursor ou Windsurf) et connectez-vous avec Square ; la configuration de Claude Desktop utilise npx mcp-remote. Pour le bac à sable, lancez npx square-mcp-server start avec ACCESS_TOKEN et SANDBOX=true.
- Intégrations
- Trois outils : get_service_info et get_type_info pour la découverte en lecture seule, et make_api_request pour les lectures et écritures sur 38 services dont les paiements, remboursements, commandes, catalogue, inventaire, factures et paiements sortants.
- Données et confidentialité
- Le serveur hébergé agit sur les données de production en direct via OAuth ; la documentation ne liste aucune portée ni condition de rétention. Le serveur local garde un jeton d'accès sur votre machine et peut être rendu en lecture seule avec DISALLOW_WRITES=true.
- Coût à grande échelle
- Le serveur est gratuit sous Apache-2.0 ; les frais de traitement Square standard s'appliquent à tout paiement qu'il crée. Chaque opération prend généralement deux ou trois appels (découvrir, inspecter le type, puis requêter), si bien que l'usage de tokens par tâche est plus élevé qu'avec des outils dédiés ; les limites de débit ne sont pas publiées dans la documentation MCP.
- Limites
- Bêta ; le serveur hébergé est production-only ; les issues ouvertes rapportent des paramètres de tableau abandonnés (#20), un risque de double débit sur les paiements relancés (#31) et des collisions de noms d'outils avec d'autres serveurs (#27).
Les points forts
- Atteint 38 services Square via trois outils
- Serveur OAuth hébergé avec une liste de clients approuvés
- Mode lecture seule et prise en charge du bac à sable dans le serveur local
- La petite liste d'outils laisse de la place pour d'autres serveurs en contexte
Les points faibles
- Bêta, avec un paquet npm inchangé depuis avril 2025
- Le serveur hébergé est production-only sans interrupteur lecture seule
- Bugs ouverts : paramètres de tableau abandonnés, libellé d'idempotence qui risque des doubles débits
- Les noms d'outils génériques entrent en collision avec d'autres serveurs
Idéal pour
Les vendeurs et développeurs Square qui veulent qu'un assistant interroge les données de ventes, de commandes et de catalogue.
Alternatives à Square MCP Server
Square MCP Server : questions fréquentes
- Square MCP Server vaut-il le coup ?
- Toute l'API Square derrière trois outils : astucieux pour lire les données de vente, risqué pour tout ce qui déplace de l'argent tant que ses bugs de bêta restent ouverts. Nous lui donnons 3.6 sur 5.
- Combien coûte Square MCP Server ?
- Gratuit et open source (Apache-2.0) ; les frais Square normaux s'appliquent.
- Quels sont les inconvénients de Square MCP Server ?
- Bêta, avec un paquet npm inchangé depuis avril 2025; le serveur hébergé est production-only sans interrupteur lecture seule; bugs ouverts : paramètres de tableau abandonnés, libellé d'idempotence qui risque des doubles débits; les noms d'outils génériques entrent en collision avec d'autres serveurs.
- À qui s’adresse Square MCP Server ?
- Les vendeurs et développeurs Square qui veulent qu'un assistant interroge les données de ventes, de commandes et de catalogue.
- Combien coûte Square MCP Server pour une équipe ou en production ?
- Le serveur est gratuit sous Apache-2.0 ; les frais de traitement Square standard s'appliquent à tout paiement qu'il crée. Chaque opération prend généralement deux ou trois appels (découvrir, inspecter le type, puis requêter), si bien que l'usage de tokens par tâche est plus élevé qu'avec des outils dédiés ; les limites de débit ne sont pas publiées dans la documentation MCP.
- Square MCP Server est-il sûr pour les données de l’entreprise ?
- Le serveur hébergé agit sur les données de production en direct via OAuth ; la documentation ne liste aucune portée ni condition de rétention. Le serveur local garde un jeton d'accès sur votre machine et peut être rendu en lecture seule avec DISALLOW_WRITES=true.
- Quelles sont les meilleures alternatives à Square MCP Server ?
- Les alternatives les plus proches que nous avons testées sont Stripe MCP, PayPal MCP Server et Shopify Dev MCP.
Réponses vérifiées le 23 oct. 2026.