Conecte seu agente de IA (MCP)

Dê ao Claude Code, Cursor ou qualquer agente compatível com MCP acesso seguro e somente leitura às suas falhas de CI para que ele possa fazer triagem e corrigi-las a partir do seu editor.

A aba de configurações API Keys — Settings, API Keys: crie uma chave e copie o comando de conexão pronto.

O Latchkey traz um servidor MCP: seu agente de codificação de IA se conecta a ele com uma chave de API do Latchkey e pode puxar contexto real de falhas de CI (execuções com falha, logs, pacotes de diagnóstico) direto para a sessão do seu editor. Em vez de copiar e colar logs em um chat, seu agente pergunta ao Latchkey diretamente e obtém tudo o que precisa para corrigir a falha.

Esta é a metade de repasse da autocorreção: a autocorreção corrige falhas de ambiente durante a execução e nunca toca no seu código-fonte, então quando o problema real é um bug no seu código, o build falha de forma verdadeira, e essa falha chega aqui como um pacote pronto para correção para o seu agente.

O que um agente conectado pode fazer#

toolTriagem de falhas de CIExamine o que está falhando em seus repositórios monitorados e priorize.

toolListar execuções com falhaEnumere execuções de workflow recentes com falha com seus metadados principais.

toolObter pacote de falhaPuxe o contexto completo de uma falha: logs, diagnóstico e detalhes do workflow.

toolCorrigir uma falha de CIConduza uma correção guiada de uma falha específica de dentro do seu editor.

Você nunca chama essas ferramentas pelo nome. Você faz ao seu agente uma pergunta em linguagem simples, e ele decide qual ferramenta do Latchkey a responde. Alguns pareamentos ilustrativos:

Você pergunta ao seu agente	Ferramenta que ele aciona
"O que está falhando em nossos repos agora?"	Triagem de falhas de CI
"Mostre-me as execuções recentes com falha deste repo"	Listar execuções com falha
"Puxe tudo que você tem sobre aquela execução com falha"	Obter pacote de falha
"Corrija o build que está falhando"	Corrigir uma falha de CI

Como é uma sessão#

Duas sessões ilustrativas. As palavras exatas, e as respostas exatas do agente, vão variar conforme o agente; o formato da troca é o que importa.

Você abre seu editor e pergunta: "O que está falhando em nossos repos?" O agente chama a ferramenta de triagem e volta com um panorama das falhas em seus repositórios monitorados, priorizado. Você o refina: "Quais delas importam mais para o release?" e o agente raciocina sobre os mesmos dados sem que você jamais abra uma aba de CI.

O valor é o ciclo permanecer em um só lugar: pergunta, contexto, próxima pergunta, tudo dentro da sessão do editor onde você fará a correção.

Você pergunta: "Puxe o pacote de falha do último build vermelho e corrija-o." O agente lista as execuções recentes com falha para encontrar a certa, puxa o pacote completo dela (logs, diagnóstico e detalhes do workflow), e então conduz uma correção guiada de dentro do seu editor, propondo mudanças para você revisar.

Note o que não aconteceu: o agente nunca tocou nas configurações do Latchkey ou no GitHub pela chave. Ele leu o contexto da falha; as mudanças de código passaram por você.

O que há em um pacote de falha#

O pacote de falha entrega ao seu agente o que ele de outra forma reconstruiria manualmente:

A causa raiz, em linguagem simples.
O código de saída da etapa que falhou e o arquivo-fonte exato onde o erro surgiu.
Os logs completos e não truncados da etapa que falhou, incluindo saída que o GitHub esconde em seu visualizador de logs. Segredos são removidos dos logs antes de saírem do Latchkey.
O que a autocorreção já investigou e por que ela recuou, mais a definição do workflow.

Configuração#

Crie uma chave de API

Abra Settings, API Keys (proprietários e administradores gerenciam as chaves). Clique em Create key, dê a ela um nome referente a onde ela vai ficar (por exemplo "Cursor on my laptop"), e escolha uma expiração: 30, 60, 90 dias, 1 ano ou nunca.

Copie a chave imediatamente

A chave completa (ela começa com lk_live_) é exibida uma única vez, na criação. Depois disso a interface só mostra um placeholder. Trate-a como uma senha; se você a perder, revogue-a e crie uma nova.

Conecte seu agente

O cartão Connect an agent na mesma aba de configurações mostra o comando exato para seu workspace. Para o Claude Code ele fica assim:

terminal

$ claude mcp add --transport http latchkey \
    https://latchkey.dev/mcp \
    --header "Authorization: Bearer lk_live_YOUR_KEY"

Use-a

Pergunte ao seu agente sobre CI que está falhando ("o que está falhando em nossos repos?", "puxe o pacote de falha do último build vermelho e corrija-o"). Qualquer cliente compatível com MCP que suporte transporte HTTP com um cabeçalho bearer funciona da mesma forma.

Modelo de segurança#

Escopo somente leitura. As chaves podem ler dados de falha de CI; elas não podem mudar nada no Latchkey ou no GitHub.
Escopo de workspace. O workspace é derivado da própria chave, então uma chave só pode ver os dados do seu próprio workspace.
Revogável. Revogue qualquer chave instantaneamente em Settings, API Keys; chaves revogadas ficam listadas para auditoria.

O que essas três propriedades significam na prática. Somente leitura limita o raio de impacto de um vazamento: uma chave roubada expõe dados de falha de CI (incluindo trechos de log), razão pela qual você ainda deve protegê-la, mas ela não pode abrir PRs, alterar configurações ou agir no GitHub em seu nome. O escopo de workspace significa que não há nada a configurar e nada a errar: a própria chave determina o que ela pode ver, e ela nunca pode ver outro workspace. E como a revogação é instantânea e chaves revogadas permanecem listadas para auditoria, a resposta segura para qualquer dúvida é simplesmente revogar e reemitir.

Dois hábitos de baixo esforço que mantêm isso limpo: crie uma chave separada para cada ferramenta ou máquina (o prompt de nomenclatura na criação, como "Cursor on my laptop", existe exatamente para isso), para que revogar uma chave nunca quebre as outras; e escolha a expiração mais curta que se encaixe em como você trabalha, reservando nunca para configurações que você acompanha ativamente. O gerenciamento de chaves fica com proprietários e administradores; veja Equipe e papéis e Segurança e permissões para o modelo mais amplo.