Connectez votre assistant AI à Azumuta

Mis à jour

BETA : Azumuta MCP est actuellement en bêta et peut encore évoluer. Il est disponible uniquement sur inscription. Pour rejoindre la bêta ou poser des questions, contactez support@azumuta.com.

Le 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 ordres produit, les enregistrements et les incidents 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 Use Azumuta MCP pour des exemples et des limitations.

Avant de commencer

  • Activez la bêta MCP pour votre espace de travail.
  • Utilisez un assistant IA approuvé par votre organisation. L'assistant doit prendre en charge les connexions MCP à distance et un en‑tête Authorization.
  • Assurez‑vous d'avoir l'autorisation de gérer les appareils API, ou demandez à l'administrateur de votre espace de travail de créer la clé.
  • Vérifiez quelles données vous pouvez partager avec le client IA et son fournisseur de modèle. Les données récupérées sont transmises à ce client et à ce fournisseur.

Cursor est l'exemple illustré dans ce guide. D'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 les API scopes ne sont pas disponibles, ou pour obtenir de l'aide pour 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 quelles catégories de données l'assistant peut accéder. Son accès ne correspond pas nécessairement à vos permissions dans l'application web. Demandez à votre administrateur de la vérifier avant de connecter.

  1. Créez un appareil API dédié dans l'espace de travail que vous souhaitez connecter.
  2. Ouvrez Edit device pour cet appareil.
  3. Ouvrez Security.
  4. Sous API scopes, sélectionnez Restrict this API key to a subset of operations.
  5. Désélectionnez les scopes choisis dont vous n'avez pas besoin. La sélection initiale inclut tous les scopes.
  6. Sélectionnez uniquement les options Read requises dans le tableau ci‑dessous.
  7. Enregistrez l'appareil.
  8. Copiez sa clé API.
Scope group Read access Scope identifier
Work instructions Instructions de travail, contenu et versions workinstructions:read
Recordings Enregistrements des instructions de travail et données de rapport structurées recordings:read
Products Ordres produit et détails d'exécution products:read
Issues Incidents, tableaux, flux et changements d'état issues:read
Users Détails des utilisateurs users:read
Spots Zones et postes spots:read

Le MCP requiert des scopes explicites. Une clé sans scopes sélectionnés n'accorde pas d'accès MCP illimité. Certaines questions nécessitent plusieurs scopes, par exemple Work instructions et Recordings.

API scopes filtrés sur Work instructions, avec Read sélectionné et Write et Delete désactivés

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 Remote MCP using Streamable HTTP
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 authentification via le navigateur Azumuta.

Utilisez une clé provenant 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

  1. Ouvrez Cursor Settings.
  2. Ouvrez Customize.
  3. Sélectionnez MCPs.
  4. Sélectionnez New MCP Server. Cursor ouvre le fichier de configuration utilisateur mcp.json.
  5. Ajoutez l'entrée azumuta ci‑dessous à l'intérieur de mcpServers. Conservez les entrées de serveur existantes.
  6. Remplacez <AZUMUTA_API_KEY> par votre clé dédiée.
  7. Enregistrez le fichier.
  8. Retournez à Customize → MCPs.
  9. Ouvrez les paramètres du serveur Azumuta.
  10. Si la connexion est désactivée, activez‑la.
  11. Vérifiez que la connexion indique Connected et liste 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 de clé réelle dans une configuration de projet partagée, un dépôt, un prompt ou une capture d'écran. Cursor prend également en charge les références aux variables d'environnement dans les valeurs d'en‑tête ; voir la documentation MCP de Cursor.

Cursor affiche la connexion Azumuta comme Connected et liste les outils en lecture

Vérifier la connexion

Dans la version de Cursor illustrée, le mode Agent autorise ces appels MCP. Le mode Ask peut les bloquer. Limitez la requête à Azumuta MCP et vérifiez les outils utilisés. D'autres outils Agent peuvent avoir un accès en écriture.

  1. Démarrez une nouvelle conversation avec votre assistant IA.
  2. Saisissez : Utilisez Azumuta MCP pour lister cinq instructions de travail. Incluez leurs noms et leurs ID.
  3. Si le client demande une approbation, vérifiez l'outil et ses arguments avant d'approuver la lecture.
  4. Comparez les instructions de travail renvoyées avec l'espace de travail Azumuta sélectionné.

Cette vérification nécessite Work instructions: Read. Une liste vide n'indique pas nécessairement un échec de la connexion. Vérifiez la réponse de l'outil et si l'espace de travail contient des instructions de travail accessibles.

Continuez avec exemples de questions et limitations.

Problèmes de connexion

Symptôme Vérifier
Authentication error 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 de support.
Access denied or no expected tools Confirmez l'accès à la bêta et les scopes Read explicites de la clé. Après avoir modifié les scopes, reconnectez‑vous ou actualisez la liste d'outils.
A record cannot be found Vérifiez son nom ou son ID et l'espace de travail sélectionné par la clé.
The response is too large or incomplete Resserrez la question. Spécifiez un enregistrement, un filtre ou un petit nombre de résultats. Demandez s'il reste d'autres pages.

Déconnecter ou révoquer l'accès

Pour cesser d'utiliser la connexion dans un client, désactivez ou supprimez l'entrée Azumuta MCP dans ce client. Cela n'invalide pas la clé API.

Pour révoquer la clé :

  1. Allez dans Management → Devices → API dans Azumuta.
  2. Ouvrez le menu de la ligne pour l'appareil API dédié.
  3. Sélectionnez Delete device.
  4. 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à renvoyées dans une conversation IA.

Sur cette page