Utiliser MaShop depuis un autre assistant IA
Autorisez un client MCP compatible à travailler sur vos projets MaShop.
Comprendre le sens de l’accès
Le serveur MCP MaShop expose les outils MaShop à un assistant externe compatible. C’est différent de la connexion du serveur MCP d’un autre service dans MaShop. Le client externe agit sur le compte MaShop autorisé et avec les droits accordés.
L’adresse du serveur est https://mcp.mashop.app/mcp. Utilisez un client prenant en charge MCP distant par HTTP et le parcours d’autorisation OAuth proposé. La configuration et les fonctions disponibles dépendent de l’application utilisée.
Connecter et vérifier
- Ajoutez l’adresse MaShop dans les paramètres de connexion MCP de votre assistant.
- Connectez-vous et examinez le nom de l’application et les accès demandés sur l’écran de consentement.
- Demandez à l’assistant de lire votre identité ou de lister vos projets avant toute modification.
- Pour une tâche Code, précisez le projet et vérifiez l’état et le résultat retournés.
- Consultez les applications autorisées dans les paramètres MaShop et révoquez les accès devenus inutiles.
Examiner d’abord le projet
Demandez à l’assistant externe d’utiliser get_me pour confirmer le compte MaShop autorisé, puis list_projects pour identifier le projet souhaité. Utilisez son project_id dans les appels suivants ; le nom du projet ne remplace pas cet identifiant.
list_files lit la liste des fichiers du dépôt. read_file reçoit project_id et un chemin relatif au dépôt. Les deux acceptent un git_ref facultatif pour examiner une révision enregistrée avant de discuter d’une modification.
Suivre une tâche Code longue
send_message reçoit project_id et message. Pour une tâche longue, le client externe peut définir wait sur false, conserver le message_id retourné et appeler get_message avec les mêmes project_id et message_id. Il consulte ainsi la tâche existante au lieu de créer une demande en double.
Lisez l’état retourné : in_progress indique que la tâche est encore en cours ; complete fournit la réponse enregistrée de l’assistant ; error nécessite de consulter l’erreur avant de réessayer. Même après une réponse terminée, contrôlez les fichiers et l’aperçu avant de vous appuyer sur l’application.
L’action actuelle d’envoi d’une tâche Code nécessite un projet appartenant au compte MaShop autorisé. Une invitation de collaborateur dans le navigateur ne remplace pas cette condition. En cas de refus, vérifiez le compte et le projet avant de renvoyer une demande.
Créer à partir de votre brief
create_project reçoit un prompt décrivant le site ou l’application, ses utilisateurs, ses fonctions et son design. La route actuelle vérifie les connexions GitHub et Supabase ainsi que la limite de projets du compte. Elle retourne un identifiant et une adresse de workspace contenant le brief. Ouvrez cette adresse pour continuer ; la création d’un enregistrement ne signifie pas que l’application est prête.
Décrivez les pages, les fonctionnalités, la langue, les couleurs et les typographies nécessaires à votre projet. Le choix facultatif include_backoffice est déduit du brief lorsqu’il est omis. Aucun identifiant de template sélectionnable n’est accepté. remix_project reprend le brief et les paramètres enregistrés dans un nouveau projet ; il ne copie pas le dépôt ni les fichiers du projet source.
Vérifier la publication séparément
deploy_project utilise la connexion native Netlify et le dépôt GitHub lié au projet. Appelez-le pour le projet et le compte d’hébergement souhaités. Il ne sélectionne pas un autre hébergeur. Les autres parcours de publication nécessitent les connexions et outils adaptés.
Une réponse building confirme le lancement du déploiement, pas la mise en ligne de la nouvelle application. Consultez le résultat du build dans le workspace. get_project_status retourne l’adresse du dernier déploiement réussi lorsqu’elle existe ; cette adresse peut encore correspondre à une ancienne version.
Consulter le catalogue et le contexte enregistré
Laissez le client découvrir les outils du serveur plutôt que de déduire ses capacités de celles d’un autre assistant. list_template_projects et list_library_projects retournent actuellement des listes vides avec feature_status égal à not_available. Ils ne fournissent ni applications préfabriquées ni bibliothèques de projets réutilisables. Commencez par un brief avec create_project.
Les outils de connaissance du workspace et du projet lisent ou remplacent un texte enregistré via MCP. Lisez le texte existant avant de le remplacer ; une chaîne vide l’efface. Ce stockage est distinct des instructions, skills et mémoires d’un agent. Un enregistrement réussi ne prouve pas qu’une exécution ultérieure applique automatiquement ce texte. Transmettez les consignes utiles avec la tâche et vérifiez le résultat.
get_credits lit les soldes enregistrés. top_up_credits crée un lien de paiement pour le montant demandé ; cet appel ne débite pas le compte et n’ajoute pas de crédits à lui seul. Vérifiez le montant, payez dans le navigateur et consultez le solde après confirmation.
Partager les fichiers adaptés
get_file_upload_url prépare l’envoi d’un fichier autorisé dans un projet qui vous appartient. Indiquez son nom, sa taille déclarée et un type MIME accepté, comme image/png ; la route actuelle refuse les types et extensions non pris en charge. La taille déclarée maximale est de 10 Mo.
Le client effectue ensuite l’envoi avec l’adresse retournée et vérifie sa réussite. Le stockage de ces fichiers est public. Réservez-le aux images, polices et autres fichiers publics acceptés ; n’y envoyez pas de secrets ni de données privées.