BETA : Azumuta MCP est actuellement en version bêta et peut encore évoluer. Il est disponible sur invitation uniquement. Pour rejoindre la version bêta ou poser des questions, contactez support@azumuta.com.
Model Context Protocol (MCP) connecte votre assistant IA préféré aux données Azumuta autorisées. Vous pouvez poser des questions sur les instructions de travail, les commandes de produits, les enregistrements et les problèmes sans copier manuellement ces données dans une conversation.
Les outils Azumuta MCP sont en lecture seule. Ils ne peuvent pas modifier votre espace de travail. Consultez Utiliser Azumuta MCP pour des exemples et des limitations.
Avant de commencer
- Activez la version bêta MCP pour votre espace de travail.
- Utilisez un assistant IA approuvé par votre organisation. L'assistant doit supporter les connexions MCP distantes et un en-tête Authentification.
- Assurez-vous que vous avez la permission de gérer les appareils API, ou demandez à votre administrateur d'espace de travail de créer la clé.
- Vérifiez les données que vous pouvez partager avec le client IA et son fournisseur de modèle. Les données récupérées vont à ce client et ce fournisseur.
Cursor est l'exemple illustré dans ce guide. Les autres assistants IA ont des contrôles de configuration différents. Vous n'avez pas besoin d'installer le serveur Azumuta MCP sur votre ordinateur.
Si Scopes API n'est pas disponible, ou pour obtenir de l'aide avec la configuration de la connexion, contactez support@azumuta.com.
Créer une clé avec accès en lecture
Une clé API sélectionne l'espace de travail et contrôle les catégories de données auxquelles l'assistant peut accéder. Son accès ne correspond pas nécessairement à vos autorisations d'application web. Demandez à votre administrateur de l'examiner avant de vous connecter.
- Créez un appareil API dédié dans l'espace de travail que vous souhaitez connecter.
- Ouvrez Modifier le périphérique pour cet appareil.
- Ouvrez Sécurité.
- Sous Scopes API, sélectionnez Restreindre cette clé API à un sous-ensemble d'opérations.
- Décochez les scopes sélectionnés dont vous n'avez pas besoin. La sélection initiale inclut tous les scopes.
- Sélectionnez uniquement les options Lecture requises dans le tableau ci-dessous.
- Enregistrez l'appareil.
- Copiez sa clé API.
| Groupe de scopes | Accès en lecture | Identifiant de scope |
|---|---|---|
| Instructions de travail | Instructions de travail, contenu et versions | workinstructions:read |
| Enregistrements | Enregistrements d'instructions de travail et données de rapport structurées | recordings:read |
| Produits | Commandes de produits et leurs détails d'exécution | products:read |
| Problèmes | Problèmes, tableaux, flux et changements de statut | issues:read |
| Utilisateurs | Détails des utilisateurs | users:read |
| Zones | Zones et stations | spots:read |
MCP nécessite des scopes explicites. Une clé sans scopes sélectionnés ne fournit pas d'accès MCP sans restriction. Certaines questions nécessitent plusieurs scopes, tels que Instructions de travail et Enregistrements.
Connectez votre assistant IA préféré
Pour un espace de travail sur app.azumuta.com, utilisez ces paramètres :
| Paramètre | Valeur |
|---|---|
| Type de connexion | MCP distant utilisant HTTP en continu |
| URL du serveur | https://mcp.azumuta.com/mcp |
| Nom de l'en-tête | Authorization |
| Valeur de l'en-tête | Bearer <AZUMUTA_API_KEY> |
Remplacez <AZUMUTA_API_KEY> par votre clé. Conservez l'espace après Bearer. Cette connexion utilise une clé API, pas une connexion de navigateur Azumuta.
Utilisez une clé de l'environnement correspondant. Une clé sandbox ne se connecte pas à la production. Pour un autre environnement, utilisez son point de terminaison MCP confirmé.
Exemple : connexion dans Cursor
- Ouvrez Paramètres Cursor.
- Ouvrez Personnaliser.
- Sélectionnez MCPs.
- Sélectionnez Nouveau serveur MCP. Cursor ouvre le fichier de configuration
mcp.jsonau niveau utilisateur. - Ajoutez l'entrée
azumutaci-dessous à l'intérieur demcpServers. Conservez toutes les entrées de serveur existantes. - Remplacez
<AZUMUTA_API_KEY>par votre clé dédiée. - Enregistrez le fichier.
- Retournez à Personnaliser → MCPs.
- Ouvrez les paramètres du serveur Azumuta.
- Si la connexion est désactivée, activez-la.
- Vérifiez que la connexion affiche Connecté et répertorie les outils attendus.
{
"mcpServers": {
"azumuta": {
"url": "https://mcp.azumuta.com/mcp",
"headers": {
"Authorization": "Bearer <AZUMUTA_API_KEY>"
}
}
}
}
Le fichier au niveau utilisateur est ~/.cursor/mcp.json. Il peut rendre cette connexion disponible dans tous vos projets. Ne mettez pas une vraie clé dans une configuration de projet partagée, un référentiel, une invite ou une capture d'écran. Cursor supporte également les références de variables d'environnement dans les valeurs d'en-tête ; consultez la documentation MCP de Cursor.
Vérifiez la connexion
Dans la version Cursor illustrée, le mode Agent autorise ces appels MCP. Le mode Demander peut les bloquer. Limitez la demande à Azumuta MCP et vérifiez les outils utilisés. Les autres outils Agent peuvent avoir un accès en écriture.
- Commencez une nouvelle conversation avec votre assistant IA.
- Entrez : Utilisez Azumuta MCP pour lister cinq instructions de travail. Incluez leurs noms et identifiants.
- Si le client demande une approbation, vérifiez l'outil et ses arguments avant d'approuver la lecture.
- Comparez les instructions de travail retournées avec l'espace de travail Azumuta sélectionné.
Cette vérification nécessite Instructions de travail : Lecture. Une liste vide ne signifie pas en soi que la connexion a échoué. Vérifiez la réponse de l'outil et si l'espace de travail contient des instructions de travail accessibles.
Continuer avec questions d'exemple et limitations.
Problèmes de connexion
| Symptôme | Vérification |
|---|---|
| Erreur d'authentification | Confirmez le point de terminaison, l'environnement correspondant, la clé API et l'en-tête Bearer. N'incluez jamais la clé dans un message d'assistance. |
| Accès refusé ou outils attendus manquants | Confirmez l'accès à la version bêta et les scopes Lecture explicites de la clé. Après avoir modifié les scopes, reconnectez-vous ou actualisez la liste des outils. |
| Un enregistrement ne peut pas être trouvé | Vérifiez son nom ou identifiant et l'espace de travail sélectionné par la clé. |
| La réponse est trop volumineuse ou incomplète | Affinez la question. Spécifiez un enregistrement, un filtre ou un petit nombre de résultats. Demandez s'il reste d'autres pages. |
Déconnectez-vous ou révoquez l'accès
Pour arrêter d'utiliser la connexion dans un client, désactivez ou supprimez l'entrée Azumuta MCP là-bas. Cela n'invalide pas la clé API.
Pour révoquer la clé :
- Allez à Gestion → Appareils → API dans Azumuta.
- Ouvrez le menu de ligne pour l'appareil API dédié.
- Sélectionnez Supprimer le périphérique.
- Confirmez la suppression.
La suppression de l'appareil invalide sa clé pour toutes les intégrations qui l'utilisent. Vérifiez que l'appareil n'est pas partagé avant de le supprimer. La révocation ne supprime pas les données déjà retournées à une conversation IA.