← Accueil

Guide MCP Onestore

Connectez votre assistant aux outils de gestion de l’App Store et de Google Play.

Connecter mon assistant

Adresse du serveur MCP (HTTP + OAuth)

https://www.onestore.so/api/mcp
Ajouter à Cursor

Installer le MCP et le skill

Node.js 20 ou supérieur. Téléchargez le script, puis exécutez-le pour l’assistant choisi. Il ajoute Onestore à la configuration et installe use-onestore pour votre compte local.

curl -fsSL https://www.onestore.so/mcp/onestore.mjs -o onestore.mjs
node onestore.mjs setup --client cursor --origin https://www.onestore.so
Voir / télécharger le script

Ouvrez les paramètres MCP de Cursor et authentifiez Onestore.

Relancez setup pour mettre à jour. Les fichiers modifiés et les autres connexions sont préservés. Cursor/Claude Code acceptent aussi --scope project. Pour retirer cette installation :

node onestore.mjs uninstall --client cursor --origin https://www.onestore.so

Révoquez aussi la connexion dans Onestore pour invalider son accès. L’installateur ne stocke aucun jeton ; le client gère OAuth.

Vérifier la connexion

Après avoir choisi vos applications et vos droits, demandez : « Vérifie ma connexion Onestore et liste mes applications accessibles. » L’assistant doit utiliser get_connection et list_apps.

Diagnostic réseau facultatif : node onestore.mjs doctor. Ce diagnostic vérifie la découverte OAuth publique, pas l’authentification de votre compte.

Lire le skill · Télécharger le bundle du skill

Le serveur accepte aussi une clé Onestore pour les clients permettant un en-tête Authorization. Créez-la dans les paramètres et gardez-la dans le stockage privé de votre client.

Choisir les droits et l’autonomie

À la connexion, choisissez un espace, les applications et les plateformes. L’accès aux futures applications est une option explicite. Les connexions expirent au plus tard après 90 jours et peuvent être révoquées dans les paramètres.

  • read — consulter les données.
  • drafts — modifier les brouillons.
  • uploads — envoyer et gérer les fichiers.
  • store — synchroniser, pousser les fiches et répondre aux avis.
  • publish — soumettre les releases et gérer la distribution.
  • admin — modifier les paramètres ou supprimer les données d’une application Onestore (propriétaire).

Lecture et brouillons sont disponibles aux membres ; les autres droits demandent un administrateur ou propriétaire, et admin un propriétaire. Les brouillons partagés entre les stores nécessitent les deux plateformes. L’autonomie ne donne aucun droit supplémentaire : préparation autorise brouillons/uploads, test ajoute la distribution de test, et complète autorise toutes les actions déjà accordées. Les autres actions restent soumises à validation.

De votre build à la release

  1. L’IA identifie l’application, la version, la signature et le canal cible. Elle compile avec les outils de votre projet ; iOS nécessite macOS/Xcode et votre signature.
  2. Elle prépare un upload, transfère les octets directement vers le stockage puis finalise le fichier sur Onestore. Limites : .ipa 500 Mio, .aab 200 Mio.
  3. L’envoi au store est une action distincte. Pour Apple, le worker macOS envoie le build ; l’IA suit son traitement et l’attache à la version. Pour Google, le canal et le statut du build déterminent sa distribution.
  4. La soumission et la publication respectent les droits de la connexion et les validations demandées. L’IA indique l’état observé : envoyé, en traitement, en revue ou publié.

Un upload réussi ne signifie pas que la version est publiée. Les accords, déclarations et validations imposés par Apple ou Google restent nécessaires. La distribution par groupes TestFlight, le déploiement progressif Apple et la publication finale d’une version Apple approuvée en mode manuel ne sont pas encore exposés.

Comprendre les opérations

list_actions → plan_action → execute_operation → get_operation

Le catalogue donne les schémas actuels. Chaque plan conserve ses paramètres et l’état ciblé. Si une validation est nécessaire, l’utilisateur ouvre le lien Onestore. Après validation, l’IA exécute le plan et suit son état. Les plans expirent après 24 heures ; un changement de données peut imposer un nouveau plan.

Une opération incertaine apparaît en NEEDS_RECONCILIATION : vérifier l’état réel avant toute nouvelle tentative. L’historique et les validations sont accessibles dans les paramètres. L’outil get_guide donne à l’IA les mêmes procédures que le skill.

Résoudre un problème

  • Pas d’outils : vérifiez l’adresse /api/mcp, le transport HTTP et rechargez le connecteur.
  • 401 : reconnectez-vous ; la connexion peut être expirée ou révoquée.
  • Application absente ou accès refusé : vérifiez l’espace, les applications, les plateformes et votre rôle.
  • Action en attente : ouvrez le lien de validation avec le compte qui a connecté l’IA.
  • Upload interrompu : ne finalisez pas le fichier ; préparez un nouvel upload si l’URL a expiré.

Pour le support, conservez l’identifiant de l’opération et le code d’erreur. N’envoyez ni jeton d’accès ni URL d’upload signée.