Connecter l’adaptateur
Connectez l’adaptateur MCP à votre instance Semaphore avec un jeton API disposant des accès que vous voulez autoriser.
Gérer l’automatisation depuis vos outils IA
Configurez Semaphore, exécutez des tâches et examinez les résultats via MCP. Travaillez depuis votre client IA avec les autorisations de votre identité API.
Claude
Codex
GeminiVérifier les services en productionTask Template
Vous configurez encore l’automatisation à la main ?
L’assistant aide à écrire le script. Mais créer le modèle, définir ses entrées et planifier le travail impose encore de changer d’interface et répéter le contexte.
Travailler avec Semaphore dans la même conversation
Utilisez MCP pour configurer Semaphore, démarrer des tâches et examiner les résultats depuis votre client IA. L’identité API configurée détermine les ressources et actions accessibles.
Configurer l’automatisationGérer projets, modèles, entrées et planifications
Exécuter le travailDémarrer ou arrêter des tâches dans Semaphore
Examiner les résultatsLire la sortie de tâche et l’activité du projet
Connecter Semaphore à Claude Code
Connectez-vous une fois, puis travaillez avec Semaphore depuis Claude Code. L’adaptateur MCP fournit à votre client des outils pour appeler l’API Semaphore.
L’ajouter à Claude Code
Enregistrez l’adaptateur dans votre client MCP. Vos outils disponibles apparaissent dans Claude Code.
Travailler avec votre automatisation
Créez des modèles, modifiez les entrées, planifiez des travaux ou examinez une exécution avec les outils et autorisations activés.
Essayer sur une exécution en échec
« Trouve la dernière tâche en échec de mon projet, lis sa sortie et propose les prochaines vérifications. Ne modifie rien. »
Garder l’enquête liée à votre automatisation
Vérifier les preuves originales de la tâche
Historique et journaux d’exécution
Choisir l’identité utilisée par l’intégration
Contrôle d’accèsLes accès possibles de l’adaptateur et du client
Mieux interroger un échec d’exécution
Un assistant peut relier la sortie d’une tâche aux informations du modèle et du projet exposées par son adaptateur. Une interaction utile nomme la tâche, demande ce que les preuves permettent de conclure et sépare le diagnostic de la modification proposée. La couverture des outils varie selon la version de l’adaptateur : vérifiez donc que les opérations de lecture requises sont réellement disponibles.
Savoir quelles autorisations utilise l’assistant
Dans l’adaptateur MCP documenté, un SEMAPHORE_API_TOKEN configuré a toujours priorité sur les jetons fournis par les clients. Sans ce jeton global, les requêtes HTTP peuvent transmettre le jeton bearer de chaque client. Un jeton partagé signifie autorité et identité API partagées ; il ne permet pas une attribution fiable à la personne qui utilise l’assistant.
Garder une limite explicite autour des modifications
L’adaptateur comprend des outils de modification en plus des lectures. Exécuter une tâche ou modifier un modèle est une action opérationnelle, même initiée dans un chat. La confirmation humaine relève de la conception du client et du processus ; MCP seul ne l’impose pas. Commencez par des enquêtes à faible risque et élargissez les fonctions autorisées uniquement après test du comportement.
Décider où le contexte des tâches peut aller
L’auto-hébergement de Semaphore contrôle l’emplacement de son service. Il n’empêche pas un client assistant d’envoyer les journaux ou métadonnées retournés au fournisseur du modèle. Examinez le déploiement du client et du modèle, évitez les sorties contenant des secrets et décidez du contexte autorisé à quitter le réseau avant de connecter.
Documentation et fonctions associées
FAQ
L’intégration MCP est-elle un assistant IA intégré à Semaphore ?
La configuration décrite utilise un adaptateur MCP séparé communiquant avec la REST API Semaphore. Ce n’est pas un assistant natif intégré de Semaphore. L’adaptateur expose les opérations prises en charge à un client compatible, tandis que client et modèle fournissent la conversation. Examinez liste des outils, authentification et modèle de déploiement avant connexion, car capacités et maintenance peuvent évoluer indépendamment de votre version Semaphore.
Quelles autorisations utilisateur l’assistant utilise-t-il ?
Il utilise l’identité du jeton API réellement choisi par l’adaptateur. Dans l’implémentation documentée, un SEMAPHORE_API_TOKEN global configuré a priorité sur les jetons clients. Le mode HTTP sans ce jeton global peut transmettre les jetons bearer individuels. Un jeton partagé signifie donc autorité et identité API partagées, pas attribution fiable à chaque personne qui dialogue avec l’assistant. Choisissez le mode de déploiement délibérément avant d’ajouter plusieurs utilisateurs.
Puis-je commencer par examiner les tâches en lecture seule ?
Oui, mais faites respecter la limite prévue par l’identité Semaphore et la configuration vérifiée de l’adaptateur et du client. Une consigne de chat de ne rien modifier ne remplace pas la restriction des droits du jeton. Commencez par une tâche concrète et les lectures nécessaires à son contexte et sa sortie. Vérifiez que l’explication de l’assistant suit les preuves reçues avant d’étendre l’intégration aux actions opérationnelles.
Les journaux de tâches peuvent-ils être envoyés à un fournisseur de modèle externe ?
Oui, selon le client assistant et le déploiement du modèle. L’auto-hébergement détermine où s’exécute Semaphore, mais n’empêche pas un client connecté de transmettre le contexte ailleurs. Examinez tout le parcours des données, notamment journaux, métadonnées, hébergement de l’adaptateur et traitement par le modèle. La sortie peut contenir des valeurs sensibles : décidez ce qui peut être exposé et choisissez identifiants et accès adaptés avant connexion.
Que demander à un assistant sur une tâche Ansible en échec ?
Commencez par l’identifiant de tâche et demandez à l’assistant de lire état et sortie avec les outils pris en charge par l’adaptateur. Les preuves renvoyées lui permettent d’expliquer l’étape en échec et de proposer des vérifications. Confirmez ces suggestions dans le journal original, surtout avant de modifier playbook, identifiants ou infrastructure cible.
MCP remplace-t-il l’interface Semaphore ou la REST API ?
Non. L’adaptateur MCP utilise la REST API Semaphore pour exposer les opérations prises en charge à un client assistant compatible. Semaphore reste le lieu d’exécution des tâches et d’enregistrement des résultats. Ouvrez la tâche originale dans l’interface web pour examiner sa sortie indépendamment de la conversation ou des explications du modèle.
Puis-je utiliser un projet Semaphore existant avec l’adaptateur ?
Oui, si l’identité API configurée accède au projet et l’adaptateur prend en charge les opérations requises. Commencez par une tâche connue et vérifiez les informations des outils de lecture. Il n’est pas nécessaire de réécrire playbook ou script pour examiner sa trace existante via l’intégration.
L’assistant va-t-il réparer ou relancer automatiquement un travail en échec ?
L’examen d’une tâche ne relance ni ne répare l’automatisation en soi. L’adaptateur peut exposer des outils de modification : les actions disponibles dépendent donc de sa version, de la configuration du client et des autorisations API. Faites respecter la lecture seule prévue par l’identité sous-jacente et vérifiez le projet et la tâche exacts avant d’autoriser une exécution.