Collegare l’adattatore
Collega l’adattatore MCP all’istanza Semaphore usando un token API con gli accessi voluti.
Gestire l’automazione dagli strumenti IA
Configura Semaphore, esegui task ed esamina i risultati tramite MCP. Lavora dal client IA con i permessi della tua identità API.
Claude
Codex
GeminiControllare i servizi di produzioneTask Template
Imposti ancora l’automazione a mano?
L’assistente aiuta con lo script. Ma creare il modello, definire input e pianificare richiede ancora cambiare interfaccia e ripetere il contesto.
Lavorare con Semaphore dalla stessa conversazione
Usa MCP per configurare Semaphore, avviare task e leggere risultati dal client IA. L’identità API stabilisce risorse e azioni accessibili.
Configurare l’automazioneGestire progetti, modelli, input e pianificazioni
Eseguire il lavoroAvviare o fermare task in Semaphore
Analizzare i risultatiLeggere output e attività del progetto
Collegare Semaphore a Claude Code
Collegati una volta, poi lavora con Semaphore da Claude Code. L’adattatore MCP fornisce al client strumenti per chiamare l’API Semaphore.
Aggiungerlo a Claude Code
Registra l’adattatore nel client MCP. Gli strumenti disponibili appaiono in Claude Code.
Lavorare con la tua automazione
Crea modelli, aggiorna input, pianifica job o analizza un’esecuzione con strumenti e permessi abilitati.
Provare su un’esecuzione fallita
«Trova l’ultimo task fallito nel progetto, leggi l’output e suggerisci cosa controllare dopo. Non modificare nulla.»
Collegare l’indagine all’automazione
Verificare le evidenze originali del task
Cronologia e log delle esecuzioni
Scegliere l’identità dell’integrazione
Controllo degli accessiCosa possono raggiungere adattatore e client
Porre una domanda migliore su un’esecuzione fallita
Un assistente può collegare l’output di un task alle informazioni di modello e progetto esposte dall’adattatore. Un’interazione utile identifica il task, chiede cosa dimostrano le evidenze e separa diagnosi e modifica proposta. Gli strumenti variano con la versione dell’adattatore: verifica che le letture necessarie siano effettivamente disponibili.
Sapere di chi sono i permessi usati dall’assistente
Nell’adattatore MCP documentato un SEMAPHORE_API_TOKEN configurato ha sempre precedenza sui token dei client. Senza quel token globale le richieste HTTP possono inoltrare il bearer token di ciascun client. Un token condiviso implica autorità e identità API condivise e non permette di attribuire in modo affidabile le azioni alla singola persona che usa l’assistente.
Mantenere un confine esplicito per le modifiche
L’adattatore include modifiche oltre alle letture. Eseguire un task o cambiare un modello è lavoro operativo anche se avviato in chat. La conferma umana dipende dal client e dal processo; MCP da solo non la impone. Inizia con analisi a basso rischio ed espandi i permessi dopo aver testato il comportamento.
Decidere dove può andare il contesto dei task
L’auto-hosting controlla dove gira Semaphore. Non impedisce al client assistente di inviare log o metadati al provider del modello. Esamina client e deployment del modello, evita output con segreti e decidi quale contesto può lasciare la rete prima del collegamento.
Documentazione e funzionalità correlate
FAQ
L’integrazione MCP è un assistente IA integrato in Semaphore?
La configurazione usa un adattatore MCP separato che comunica con REST API Semaphore. Non è un assistente integrato di prima parte. L’adattatore espone operazioni supportate a un client compatibile; client e modello gestiscono la conversazione. Controlla strumenti, autenticazione e deployment prima di collegarlo, perché funzionalità e manutenzione possono cambiare indipendentemente da Semaphore.
Di quale utente usa i permessi l’assistente?
Usa l’identità del token API effettivamente selezionato dall’adattatore. Nell’implementazione documentata un SEMAPHORE_API_TOKEN globale ha precedenza sui token client. La modalità HTTP senza token globale può inoltrare bearer token individuali. Un token condiviso implica quindi autorità e identità condivise, non attribuzione affidabile a ogni persona in chat. Scegli deliberatamente la modalità prima di aggiungere più utenti.
Posso iniziare con l’analisi dei task in sola lettura?
Sì, ma imponi il confine tramite identità Semaphore e configurazione verificata di adattatore e client. Un’istruzione in chat non sostituisce la limitazione del token. Parti da un task concreto e dalle letture per contesto e output. Verifica che la spiegazione segua le evidenze prima di estendere l’integrazione ad azioni operative.
I log dei task possono essere inviati a un provider di modelli esterno?
Sì, secondo client e deployment del modello. L’auto-hosting determina dove gira Semaphore, ma non impedisce al client di inoltrare altrove il contesto ricevuto. Esamina l’intero percorso, inclusi log, metadati, hosting adattatore e modello. L’output può contenere dati sensibili: decidi cosa esporre e scegli credenziali e progetti adeguati prima del collegamento.
Cosa posso chiedere all’assistente su un task Ansible fallito?
Parti dall’ID del task e chiedi all’assistente di leggere stato e output con gli strumenti supportati. Può usare le evidenze per spiegare il punto di errore e proporre verifiche. Conferma le proposte sul log originale, soprattutto prima di modificare playbook, credenziali o infrastruttura.
MCP sostituisce l’interfaccia Semaphore o la REST API?
No. L’adattatore MCP usa la REST API Semaphore per esporre operazioni supportate a un client assistente compatibile. Semaphore resta dove si eseguono task e si registrano risultati. Apri il task originale nell’interfaccia per esaminare l’output indipendentemente dalla conversazione o spiegazione del modello.
Posso usare un progetto Semaphore esistente con l’adattatore?
Sì, se l’identità configurata accede al progetto e l’adattatore supporta le operazioni. Parti da un task noto e verifica i dati delle letture. Non serve riscrivere il codice solo per esaminarne la registrazione esistente.
L’assistente ripara o riesegue automaticamente un job?
L’indagine su un task non riesegue né ripara di per sé l’automazione. L’adattatore può esporre strumenti di modifica: le azioni disponibili dipendono da versione, configurazione del client e permessi API. Fai rispettare l’accesso di sola lettura tramite l’identità sottostante e verifica progetto e task esatti prima di consentire un’esecuzione.