As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Usando conectores gerenciados por parceiros
Um conector gerenciado pelo parceiro se conecta AWS DevOps Agente para um servidor Model Context Protocol (MCP) hospedado por um parceiro. Os exemplos incluem o serviço de observabilidade ou gerenciamento de incidentes de um parceiro. O parceiro publica o conector no AWS DevOps Repositório Agent Tools
Com um conector, você não precisa pesquisar os URLs de endpoints, URLs do OAuth ou escopos do parceiro. Você escolhe um endpoint e insere somente suas próprias credenciais, e AWS DevOps O agente cria o restante do registro a partir do conector. Use um conector quando o parceiro publicar um para seu servidor MCP. Para obter instruções sobre como registrar qualquer outro servidor MCP, consulte Registrando um servidor MCP.
Neste tópico, conectora significa a definição do parceiro e Servidor MCP significa o registro que você cria a partir dele. O console usa os mesmos termos, por exemplo Remover servidor MCP.
Um conector registra um servidor MCP, portanto, suas ferramentas funcionam da mesma forma que em um servidor MCP registrado por você mesmo. Um conector também fornece o seguinte:
Configuração fixa — Os URLs do endpoint, os métodos de autenticação e os URLs e escopos do OAuth vêm do conector. Você não pode mudá-los.
Habilidades recomendadas — Você pode instalar as habilidades recomendadas pelo conector ao adicioná-lo a um Espaço do Agente. Posteriormente, você pode instalar mais, ativá-las ou desativá-las ou removê-las.
Webhook de alerta — Quando você adiciona o conector a um Agent Space, AWS DevOps O agente cria um webhook para que os alertas do produto do parceiro possam iniciar investigações. Alguns conectores também definem a carga de alerta para você.
Como funcionam os conectores gerenciados por parceiros
A lista a seguir descreve quem executa o servidor de um conector e para onde vão seus dados:
Operação do servidor — O parceiro opera e oferece suporte ao servidor MCP. AWS não o opera. Para obter ajuda com o servidor, use o Suporte link para o conector no console.
Manutenção do conector — Cada conector mostra um Partner-managed ou AWS-gerenciado distintivo. Os nomes dos emblemas que mantêm a definição do conector.
Credenciais — Suas credenciais vão somente para os URLs na definição do conector.
Solicitações — O endpoint que você escolher pertence à região ou ao site do parceiro para sua conta com o parceiro. Pode estar fora do AWS Região do seu Espaço do Agente. Como acontece com qualquer servidor MCP que você conecta, as solicitações ao servidor então deixam isso AWS Região.
Inscrições e versões
A lista a seguir descreve como um registro se relaciona aos Agent Spaces e às versões do conector:
Escopo do registro — Você registra um conector uma vez no seu AWS conta. Em seguida, você o adiciona a cada Espaço do Agente que precisa dele.
Versões — Um registro mantém a versão do conector que você registrou. Quando um parceiro desativa um conector, o conector não aparece mais na Disponível seção, e você não pode registrá-la novamente. Seu cartão abaixo Registrado atualmente shows Obsoleto, e a página que Exibir tudo opens pode nomear o conector que o substitui. Os registros existentes continuam funcionando até que você os cancele.
Habilidades recomendadas
Uma habilidade recomendada é aquela que o parceiro sugere para seu conector, como orientação sobre como usar as ferramentas do parceiro durante uma investigação. As habilidades recomendadas vêm do catálogo de habilidades no AWS DevOps Repositório Agent Tools
Uma habilidade recomendada instalada aparece com as outras habilidades em seu Espaço do Agente. Seu conteúdo vem do catálogo, então você não pode editá-lo. O agente a carrega da mesma forma que qualquer outra habilidade. Para obter mais informações sobre habilidades, consulte DevOps Habilidades do agente.
Antes de começar
Para usar um conector gerenciado pelo parceiro, verifique se você tem o seguinte:
Uma conta com o parceiro que pode criar as credenciais que o conector exige, como uma chave de API ou um cliente OAuth. O guia de configuração do conector lista as etapas do produto do parceiro.
Permissão para registrar provedores de recursos e adicionar recursos a um Espaço do Agente no AWS DevOps Console do agente.
(Opcional) Uma conexão privada existente, se você acessar o endpoint do parceiro por meio de uma rede privada. Para obter mais informações sobre conexões privadas, consulte Conectando-se a ferramentas hospedadas de forma privada.
Para obter mais informações sobre as considerações de segurança que se aplicam a qualquer servidor MCP, como listar somente as ferramentas de que você precisa, consulte Considerações de segurança.
Encontrando um conector
Encontre um conector para ver o guia de configuração e as habilidades recomendadas antes de registrá-lo. Você pode começar no Provedores de capacidades página ou de um Agent Space.
Localizando um conector na página Provedores de Capacidades
Para encontrar um conector no Provedores de capacidades página, conclua as seguintes etapas:
Abra o AWS DevOps Console do agente em https://console.aws.amazon.com/devops-agent/
. No painel de navegação, escolha Provedores de capacidades.
Na Disponível seção, encontre o conector. Para restringir a lista, digite seu nome em Encontre a capacidade, ou escolha uma categoria. Cada placa mostra o emblema, a descrição e as categorias do conector.
Escolha o nome do conector.
A página do conector é aberta. Para ignorá-lo e iniciar o registro, você pode escolher Registre-se em vez disso, no cartão.
Encontrando um conector em um Agent Space
Para encontrar um conector em um Agent Space, conclua as seguintes etapas:
Abra o AWS DevOps Console do agente em https://console.aws.amazon.com/devops-agent/
e, em seguida, selecione seu Espaço do Agente. Escolha a guia Funcionalidades.
Na seção da categoria do conector, como Telemetria, Comunicações, ou DevOps, escolha Adicionar.
Em Adicionar um recurso, abaixo Partner-managed conectores, escolha Registre-se.
Na lista de conectores, escolha Selecione para o conector.
A página do conector é aberta.
O que a página do conector mostra
A página do conector mostra as seguintes informações:
O parceiro, a versão do conector e suas categorias
Links para a documentação e o suporte do parceiro
O guia de configuração do conector
As habilidades que o conector recomenda
Para iniciar o registro, escolha Registre-se. Para obter instruções, consulte Registrando um conector.
Registrando um conector
Quando você registra um conector, AWS DevOps O agente cria um registro de servidor MCP em seu AWS conta da definição do conector. O registro tem quatro etapas. O console ignora as etapas que o conector não precisa.
Etapa 1: detalhes do servidor MCP
Nesta etapa, você nomeia o servidor MCP e escolhe onde AWS DevOps O agente se conecta. O título da etapa inclui o nome do conector, por exemplo Exemplo de detalhes do servidor Corp MCP.
Se a etapa aparecer Guia de configuração, expanda-o antes de preencher o formulário e conclua as etapas do parceiro. Eles mostram como criar as credenciais que você insere Etapa 3: Configuração de autenticação. Para manter uma cópia das etapas, escolha Copiar.
Insira as seguintes informações:
Nome — Insira um nome curto para esse servidor MCP. O console preenche o nome do conector, que você pode alterar. Use letras, números, hífens (
-) e sublinhados (_). O nome deve ser exclusivo em seu AWS conta. AWS DevOps O agente adiciona o nome ao início de cada nome de ferramenta, e um nome de ferramenta pode ter no máximo 64 caracteres, portanto, mantenha o nome curto.Ponto final — Alguns parceiros oferecem mais de um endpoint, como um site regional. Nesse caso, escolha o endpoint que sua conta com o parceiro usa. Caso contrário, o console mostrará o terminal do conector. O URL do endpoint aparece em AWS CloudTrail faz login na sua conta.
Campos do conector — Alguns conectores solicitam mais valores, como o nome da sua instância com o parceiro. Cada campo mostra a etiqueta que o conector fornece. Insira o valor da sua conta com o parceiro.
Conecte-se ao endpoint usando uma conexão privada — (Opcional) Selecione essa opção para rotear solicitações para o endpoint do parceiro por meio de uma conexão privada existente. Para um conector que usa OAuth, você pode escolher uma conexão privada separada para a troca de tokens.
Configuração avançada — (Opcional) Escolha um cliente gerenciado AWS Serviço de gerenciamento de chaves (AWS Chave KMS) para criptografar o registro. Para obter mais informações sobre criptografia, consulte Criptografia em repouso para DevOps Agente.
Escolha Próximo.
Etapa 2: Método de autenticação
Nesta etapa, você escolhe como AWS DevOps O agente se autentica no produto do parceiro. Você vê essa etapa somente quando o conector oferece mais de um método de autenticação. O conector define a ordem dos métodos. Escolha uma das seguintes opções:
Chave de API — AWS DevOps O agente se autentica com uma chave que você cria no produto do parceiro, para que você controle suas permissões.
Credenciais do cliente OAuth — AWS DevOps O agente se autentica com um ID de cliente e um segredo que você cria no produto do parceiro.
Faça login em parceiro (por exemplo, Faça login na Example Corp) — AWS DevOps O agente age em seu nome depois que você faz login no produto do parceiro.
Faça login com registro dinâmico de clientes — AWS DevOps O agente registra seu próprio cliente OAuth com o parceiro e age em seu nome após você fazer login.
Escolha Próximo.
Etapa 3: Configuração de autenticação
Nesta etapa, você insere as credenciais de que seu método de autenticação precisa. O Definido pelo conector a seção mostra os valores que o conector define, que você não pode alterar.
O console ignora essa etapa por Faça login com registro dinâmico de clientes. Ele também pula esta etapa por Faça login em parceiro quando o conector fornece seu próprio cliente OAuth.
Chave de API
Para uma chave de API, insira um valor para cada cabeçalho listado pelo conector. O conector define o nome do cabeçalho e qualquer prefixo, como Bearer , então insira somente a chave.
Credenciais de cliente OAuth
Para obter as credenciais do cliente OAuth, conclua as seguintes etapas:
Insira o ID do cliente e Segredo do cliente que você criou no produto do parceiro.
(Opcional) Adicionar Escopos adicionais e Parâmetros adicionais de troca. AWS DevOps O agente os solicita, além dos escopos e parâmetros definidos pelo conector.
Faça login no parceiro
Para Faça login em parceiro, conclua as seguintes etapas:
Se o conector não fornecer seu próprio cliente OAuth, insira o ID do cliente e Segredo do cliente que você criou no produto do parceiro. Se o parceiro oferecer suporte ao Proof Key for Code Exchange (PKCE), você poderá deixar o segredo do cliente vazio.
(Opcional) Adicionar Escopos adicionais.
Escolha Próximo.
Etapa 4: revisar e registrar
Para finalizar o registro, conclua as seguintes etapas:
Revise os detalhes. Para alterar uma etapa, escolha Editar na seção dessa etapa.
Escolha Registrar.
Se você escolheu um método de login, entre na página do parceiro que o console abre e, em seguida, aprove o acesso.
O console retorna para AWS DevOps Agente, e o registro está completo. Se você se registrou em um Espaço do Agente, o console então abre as etapas para adicionar o conector a esse Espaço do Agente. Se você se registrou no Provedores de capacidades página, consulte Adicionando um conector a um Agent Space.
Se o registro falhar, o console permanecerá na etapa de revisão e mostrará o erro. Corrija os detalhes e escolha Registre-se novamente.
Adicionando um conector a um Agent Space
Ao adicionar um conector a um Agent Space, você escolhe as ferramentas que os agentes podem usar lá e, opcionalmente, instala as habilidades recomendadas do conector. Se você registrou o conector do Provedores de capacidades página, comece no seu Espaço do Agente:
Abra o AWS DevOps Console do agente em https://console.aws.amazon.com/devops-agent/
e, em seguida, selecione seu Espaço do Agente. Escolha a guia Funcionalidades.
Na seção da categoria do conector, escolha Adicionar.
Em Adicionar um recurso, localize o servidor MCP que você registrou a partir do conector e escolha Adicionar.
Etapa 1: selecionar ferramentas
Nesta etapa, você escolhe as ferramentas que o agente pode usar neste Espaço do Agente. Selecione somente as ferramentas de que seu Agent Space precisa. Se você classificar as ferramentas como somente para leitura ou mutantes, escolha uma classificação para cada ferramenta. Para obter mais informações sobre ferramentas de classificação, consulte Trabalhando com ações direcionadas. Para obter mais informações sobre o número máximo de ferramentas MCP em um Agent Space, consulte Cotas.
Alguns conectores também mostram Tipo de autenticação de webhook. Escolha como o produto do parceiro é autenticado no webhook de alerta do Agent Space: HAMAC (o padrão) ou Chave de API. Os conectores que definem seus próprios alertas definem isso para você.
Para pular a etapa de habilidades opcionais, escolha Ir para revisar e salvar. Caso contrário, escolha Next.
Etapa 2: selecione as habilidades recomendadas (opcional)
Você vê essa etapa somente quando o conector recomenda habilidades. Nesta etapa, você escolhe as habilidades recomendadas para instalar. O console lista as habilidades recomendadas pelo conector, sem nenhuma selecionada. Uma habilidade que já está instalada no Agent Space mostra Ativado ou Desativado, e você não pode selecioná-lo. Selecione as habilidades que você deseja instalar e, em seguida, escolha Próximo.
Etapa 5: Analisar e criar
Para salvar o conector no Espaço do Agente, conclua as seguintes etapas:
Analise as ferramentas, as habilidades e as Webhook de alerta tipo. Para alterá-los, escolha Editar em sua seção.
Escolha Salvar.
AWS DevOps O agente adiciona o servidor MCP ao Espaço do Agente e, em seguida, instala as habilidades que você selecionou. Se uma habilidade falhar na instalação, uma notificação a listará e o servidor MCP permanecerá no Espaço do Agente. Para tentar novamente, edite o conector no Espaço do Agente e selecione a habilidade. Para obter instruções, consulte Editando um conector em um Agent Space.
Configurando o webhook de alerta
Depois de escolher Salvar, o console se abre Configurar webhook de alerta. Ele é aberto sempre que você adiciona o conector a um Agent Space, mas não quando você edita o conector. Depois de configurar o webhook, cada alerta enviado a ele inicia uma investigação no Espaço do Agente.
Para configurar o webhook, conclua as seguintes etapas:
Copie o URL do webhook, a cabeçalho ou Segredo de assinatura, e o Corpo da solicitação ou Formato do corpo da solicitação. Para salvar o URL e o segredo em um arquivo, escolha Baixe o arquivo.csv. AWS DevOps O agente mostra o segredo apenas uma vez.
Selecione Salvei e armazenei meu URL e minhas credenciaise, em seguida, escolha Feito.
Configure o webhook no produto do parceiro. Para obter instruções, consulte o guia de configuração do conector.
Os valores funcionam da seguinte maneira:
URL do webhook — O URL para o qual o produto do parceiro envia alertas.
cabeçalho — Para um webhook que usa um token de portador, o
Authorization: Bearercabeçalho que o produto do parceiro envia com cada solicitação.Segredo de assinatura — Para um webhook que assina solicitações, o segredo que o produto do parceiro usa para assinar
timestamp:bodycom HMAC-SHA256. O produto do parceiro envia o carimbo de data/hora nox-amzn-event-timestampcabeçalho e a assinatura nox-amzn-event-signaturecabeçalho.Corpo da solicitação — Para um conector que define seus alertas, a carga útil do alerta. O produto do parceiro preenche os valores do modelo quando um alerta é acionado.
Formato do corpo da solicitação — Para qualquer outro conector, o formato JSON que cada alerta deve usar. Dê a cada alerta um único
incidentId.
Qual dos cabeçalho ou Segredo de assinatura você vê que depende de como o webhook é autenticado. Ou o conector o configura ou você o escolhe Selecione ferramentas. Não depende do método de autenticação que você escolheu ao registrar o conector.
Para obter mais informações sobre a autenticação e a carga útil do webhook, consulte Invocando DevOps Agente por meio de Webhook. Para obter mais informações sobre como substituir um segredo perdido, consulte Credenciais rotativas de webhook.
Onde o conector aparece
Na Capacidades guia, o conector aparece na seção de sua primeira categoria: Telemetria, Pipeline, Comunicações, ou DevOps. Um conector cuja primeira categoria é Nuvem, ou que o catálogo não lista mais, aparece na Servidor MCP seção.
Editando um conector em um Agent Space
Você pode alterar as ferramentas de um conector em um Espaço do Agente e instalar, ativar, desativar ou remover suas habilidades recomendadas. Para editar um conector, conclua as seguintes etapas:
Abra o AWS DevOps Console do agente em https://console.aws.amazon.com/devops-agent/
e, em seguida, selecione seu Espaço do Agente. Na Capacidades guia, selecione o servidor MCP em sua seção e, em seguida, escolha Editar.
Ligado Selecione ferramentas, troque as ferramentas. O console começa com as ferramentas que você salvou. Se o servidor MCP não listar mais uma ferramenta salva, o console removerá a ferramenta da seleção e exibirá um aviso.
Ligado Selecione as habilidades recomendadas, selecione as habilidades a serem mantidas ou instaladas. Para remover uma habilidade instalada, limpe-a.
(Opcional) Ativado Definir status de habilidade, ativa ou desativa cada habilidade instalada. Os agentes usam somente as habilidades que estão ativas. Você vê essa etapa somente quando pelo menos uma habilidade permanece instalada.
Ligado Revise e salve, revise a alteração em cada habilidade e, em seguida, escolha Salvar.
AWS DevOps O agente salva suas alterações e o webhook de alerta permanece o mesmo. Antes de salvar, a revisão avisa se a alteração remover habilidades. Ele também avisa se outro conector no Espaço do Agente recomendar uma habilidade que você desative ou remova, porque a alteração também se aplica a esse conector. Você pode instalar uma habilidade removida novamente mais tarde.
Se uma mudança de habilidade falhar, uma notificação a listará e suas outras alterações serão mantidas. Para tentar novamente, edite o conector novamente.
Removendo um conector de um Agent Space
Para remover um conector de um Agent Space, conclua as seguintes etapas:
Abra o AWS DevOps Console do agente em https://console.aws.amazon.com/devops-agent/
e, em seguida, selecione seu Espaço do Agente. Na Capacidades guia, selecione o servidor MCP em sua seção e, em seguida, escolha Remover.
Em Remover servidor MCP, revise a confirmação e, em seguida, escolha Remover.
O servidor MCP é removido do Espaço do Agente. Removê-lo também exclui as habilidades recomendadas do conector que estão instaladas no Espaço do Agente. Isso inclui uma habilidade recomendada que você instalou sozinho. Uma habilidade permanece instalada se outro conector no Espaço do Agente também a recomendar. A confirmação nomeia a habilidade ou fornece o número de habilidades antes que qualquer coisa seja excluída. Não será possível desfazer essa ação.
Se AWS DevOps O agente não pode verificar quais habilidades estão instaladas, diz a confirmação. Nesse caso, as habilidades permanecem instaladas e Remover remove somente o servidor MCP.
Atualizar ou cancelar o registro de um conector
Para encontrar um registro de conector, conclua as seguintes etapas:
Abra o AWS DevOps Console do agente em https://console.aws.amazon.com/devops-agent/
. No painel de navegação, escolha Provedores de capacidades.
Abaixo Registrado atualmente, localize a placa do conector e escolha Exibir tudo.
Em Inscrições, selecione o servidor MCP.
Se o registro usar Faça login em parceiro ou Faça login com registro dinâmico de clientes, você pode entrar novamente sem cancelar o registro, por exemplo, após o parceiro revogar o acesso. Escolha Açõese, em seguida, escolha Atualizar. Na etapa de revisão, deixe URL de autorização vazio, escolha Atualizare, em seguida, faça login na página do parceiro. AWS DevOps O agente atualiza seu acesso e suas credenciais de cliente e associações do Agent Space permanecem as mesmas.
Para alterar uma chave de API ou as credenciais do cliente OAuth, ou usar uma versão mais recente do conector, cancele o registro do servidor MCP e registre o conector novamente. Para cancelar o registro, primeiro remova o servidor MCP de cada Agent Space que o usa. Para obter instruções, consulte Removendo um conector de um Agent Space. Em seguida, selecione o servidor MCP, escolha Ações, e escolha Cancelar o registro. O console cancela o registro do servidor MCP imediatamente, sem solicitar sua confirmação.
Solução de problemas de conectores gerenciados por parceiros
Use as informações a seguir para resolver problemas comuns com conectores gerenciados por parceiros.
“Esse conector não define um URL para o endpoint que você escolheu”
Esse erro significa que a definição do conector não inclui o endpoint que você escolheu. Para resolver isso, escolha outro endpoint. Se o erro persistir, entre em contato com o suporte do conector.
O registro falha porque o nome está em uso
Os nomes dos servidores MCP devem ser exclusivos em seu AWS conta. Para resolver esse problema, digite outro nome em Etapa 1: detalhes do servidor MCPe, em seguida, registre-se novamente.
A página do webhook de alerta não mostra nenhuma credencial
Se Configurar webhook de alerta mostra um erro em vez do cabeçalho ou do segredo de assinatura, AWS DevOps O agente não retornou uma credencial para o webhook. Para obter um, gire o webhook. Para obter instruções, consulte Credenciais rotativas de webhook.
Os alertas não iniciam investigações
O produto do parceiro deve enviar a solicitação exatamente como o console a mostrou. Para resolver esse problema, siga as seguintes etapas:
No produto do parceiro, verifique se o webhook usa o URL do webhook do console.
Verifique se cada solicitação inclui
Authorizationcabeçalho ou ox-amzn-event-timestampex-amzn-event-signaturecabeçalhos para um webhook assinado.Verifique se o corpo da solicitação corresponde ao Corpo da solicitação ou Formato do corpo da solicitação do console.
Para obter mais etapas de solução de problemas, consulte Solução de problemas de webhooks.