Gerencie automação pelas ferramentas de IA

Configure o Semaphore, execute tarefas e investigue resultados por MCP. Trabalhe no seu cliente de IA com as permissões da identidade da API.

Ainda configura automação manualmente?

Seu assistente ajuda com o script. Mas criar o modelo, definir entradas e agendar ainda exige trocar interfaces e repetir contexto.

Trabalhe com o Semaphore na mesma conversa

Use MCP para configurar Semaphore, iniciar tarefas e inspecionar resultados pelo cliente de IA. A identidade API configurada determina os recursos e ações acessíveis.

Configure a automaçãoGerencie projetos, modelos, entradas e agendamentos
Execute o trabalhoInicie ou pare tarefas no Semaphore
Investigue resultadosLeia a saída das tarefas e a atividade do projeto

Conecte o Semaphore ao Claude Code

Claude

Conecte uma vez e trabalhe com o Semaphore pelo Claude Code. O adaptador MCP fornece ao cliente ferramentas para chamar a API do Semaphore.

Conecte o adaptador

Direcione o adaptador MCP à instância Semaphore com um token de API que tenha o acesso que você deseja permitir.

Adicione ao Claude Code

Registre o adaptador no cliente MCP. As ferramentas disponíveis aparecem no Claude Code.

Trabalhe com sua automação

Crie modelos, atualize entradas, agende trabalhos ou investigue uma execução usando as ferramentas e permissões habilitadas.

Experimente em uma execução com falha

“Encontre a última tarefa com falha no meu projeto, leia a saída e sugira o que verificar em seguida. Não altere nada.”

Mantenha a investigação conectada à automação

Escolha a identidade usada pela integração

O acesso ao projeto determina o que a conta de API configurada pode alcançar.

Controle de acesso

O que adaptador e cliente podem acessar

Faça uma pergunta melhor sobre uma execução com falha

Um assistente pode ajudar a relacionar a saída da tarefa com as informações do modelo e projeto que seu adaptador expõe. Uma interação útil identifica a tarefa, pergunta o que as evidências sustentam e separa o diagnóstico da mudança proposta. A cobertura das ferramentas varia conforme a versão do adaptador; verifique se as operações de leitura necessárias estão realmente disponíveis.

Saiba de quem são as permissões usadas pelo assistente

No adaptador MCP documentado, um SEMAPHORE_API_TOKEN configurado sempre tem prioridade sobre tokens fornecidos pelos clientes. Sem esse token global, solicitações HTTP podem encaminhar o token bearer de cada cliente. Um token compartilhado significa autoridade e identidade de API compartilhadas; não fornece atribuição confiável à pessoa usando o assistente.

Defina limites deliberados para as alterações

O adaptador inclui ferramentas de alteração e leitura. Executar uma tarefa ou mudar um modelo é trabalho operacional, mesmo iniciado no chat. Confirmação humana é uma escolha de desenho do cliente e workflow; MCP não a impõe sozinho. Comece com investigação de baixo risco e amplie a superfície permitida só após testar o comportamento.

Defina para onde o contexto da tarefa pode ir

Auto-hospedar o Semaphore controla onde seu serviço executa. Isso não impede um cliente assistente de enviar logs ou metadados retornados ao provedor de modelo. Revise a implantação do cliente e modelo, evite saídas com segredos e defina qual contexto pode sair da rede antes de habilitar a conexão.

FAQ

A integração MCP é um assistente de IA integrado ao Semaphore?

A configuração descrita usa um adaptador MCP separado que se comunica com a REST API Semaphore. Não é um assistente oficial integrado. O adaptador expõe operações a um cliente compatível; cliente e modelo fornecem a conversa. Revise ferramentas, autenticação e implantação antes de conectar, pois capacidades e manutenção podem mudar independentemente da versão Semaphore.

De qual usuário são as permissões usadas pelo assistente?

É usada a identidade do token de API realmente selecionado pelo adaptador. Na implementação documentada, um SEMAPHORE_API_TOKEN global configurado tem prioridade sobre tokens dos clientes. O modo HTTP sem token global pode encaminhar tokens bearer por cliente. Portanto, um token compartilhado significa autoridade e identidade de API compartilhadas, não atribuição confiável a cada pessoa conversando com o assistente. Escolha o modo de implantação deliberadamente antes de adicionar vários usuários.

Posso começar com investigação de tarefas somente de leitura?

Sim, mas imponha o limite pretendido pela identidade Semaphore e configuração verificada do adaptador e cliente. Uma instrução de chat para não alterar não substitui limitar a autoridade do token. Comece com tarefa concreta e leituras necessárias ao contexto e saída. Confira se a explicação segue as evidências antes de ampliar para ações operacionais.

Logs de tarefas podem ser enviados a um provedor externo de modelos?

Sim, dependendo do cliente assistente e implantação do modelo. Auto-hospedar Semaphore determina onde a aplicação executa, mas não impede o cliente de encaminhar contexto retornado. Revise todo o caminho, incluindo logs, metadados, hospedagem do adaptador e processamento do modelo. Saídas podem conter valores sensíveis; defina exposição e escolha credenciais e acesso adequados antes de conectar.

O que posso perguntar ao assistente sobre uma tarefa Ansible com falha?

Comece pelo identificador da tarefa e peça ao assistente para ler status e saída com as ferramentas compatíveis do adaptador. Ele pode usar as evidências retornadas para explicar a etapa com falha e sugerir verificações. Confirme as sugestões no log original, especialmente antes de alterar playbook, credenciais ou infraestrutura.

MCP substitui a UI ou a REST API do Semaphore?

Não. O adaptador MCP usa a REST API do Semaphore para expor operações compatíveis a um cliente assistente compatível. O Semaphore continua sendo o local da execução e registro dos resultados. Abra a tarefa original na interface web para inspecionar sua saída independentemente da conversa ou explicação do modelo.

Posso usar um projeto Semaphore existente com o adaptador?

Sim, quando a identidade API configurada acessa o projeto e o adaptador suporta as operações. Comece com tarefa conhecida e confira as leituras. Não precisa reescrever playbook ou script apenas para inspecionar registros existentes pela integração.

O assistente corrige ou repete automaticamente um trabalho com falha?

A investigação de uma tarefa não executa novamente nem corrige a automação por si só. O adaptador pode expor ferramentas de alteração. Assim, as ações disponíveis dependem da versão, da configuração do cliente e das permissões da API. Imponha o acesso somente de leitura pretendido por meio da identidade subjacente e revise o projeto e a tarefa exatos antes de permitir uma ação de execução.