

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](https://github.com/aws/tools-for-devops-agent) na GitHub site. O conector define os endpoints do servidor e os métodos de autenticação que ele aceita. Também pode listar as habilidades recomendadas pelo parceiro.

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](configuring-integrations-and-knowledge-connecting-mcp-servers.html#registering-an-mcp-server-account-level).

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 name="how-partner-managed-connectors-work"></a>

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 name="registrations-and-versions"></a>

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
<a name="recommended-skills"></a>

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](https://github.com/aws/tools-for-devops-agent) na GitHub site. Você pode instalar as habilidades recomendadas ao adicionar o conector a um Agent Space. Ao editar o servidor MCP posteriormente, você pode instalar mais habilidades, ativar ou desativar as habilidades instaladas ou removê-las.

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](about-aws-devops-agent-devops-agent-skills.md).

## Antes de começar
<a name="before-you-begin"></a>

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](configuring-integrations-and-knowledge-connecting-to-privately-hosted-tools.md).

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](configuring-integrations-and-knowledge-connecting-mcp-servers.html#security-considerations).

## Encontrando um conector
<a name="finding-a-connector"></a>

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
<a name="finding-a-connector-on-the-capability-providers-page"></a>

Para encontrar um conector no **Provedores de capacidades** página, conclua as seguintes etapas:

1. Abra o AWS DevOps Console do agente em [https://console.aws.amazon.com/devops-agent/](https://console.aws.amazon.com/devops-agent/).

1. No painel de navegação, escolha **Provedores de capacidades**.

1. 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.

1. 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
<a name="finding-a-connector-from-an-agent-space"></a>

Para encontrar um conector em um Agent Space, conclua as seguintes etapas:

1. Abra o AWS DevOps Console do agente em [https://console.aws.amazon.com/devops-agent/](https://console.aws.amazon.com/devops-agent/)e, em seguida, selecione seu Espaço do Agente.

1. Escolha a guia **Funcionalidades**.

1. Na seção da categoria do conector, como **Telemetria**, **Comunicações**, ou **DevOps**, escolha **Adicionar**.

1. Em **Adicionar um recurso**, abaixo **Partner-managed conectores**, escolha **Registre-se**.

1. Na lista de conectores, escolha **Selecione** para o conector.

A página do conector é aberta.

### O que a página do conector mostra
<a name="what-the-connectors-page-shows"></a>

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](#registering-a-connector).

## Registrando um conector
<a name="registering-a-connector"></a>

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
<a name="step-1-mcp-server-details"></a>

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](#step-3-authentication-configuration). 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](aws-devops-agent-security-encryption-at-rest-for-devops-agent.md).

Escolha **Próximo**.

### Etapa 2: Método de autenticação
<a name="step-2-authentication-method"></a>

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
<a name="step-3-authentication-configuration"></a>

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
<a name="api-key"></a>

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
<a name="oauth-client-credentials"></a>

Para obter as credenciais do cliente OAuth, conclua as seguintes etapas:

1. Insira o **ID do cliente** e **Segredo do cliente** que você criou no produto do parceiro.

1. (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
<a name="sign-in-to-the-partner"></a>

Para **Faça login em** *parceiro*, conclua as seguintes etapas:

1. 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.

1. (Opcional) Adicionar **Escopos adicionais**.

Escolha **Próximo**.

### Etapa 4: revisar e registrar
<a name="step-4-review-and-register"></a>

Para finalizar o registro, conclua as seguintes etapas:

1. Revise os detalhes. Para alterar uma etapa, escolha **Editar** na seção dessa etapa.

1. Escolha **Registrar**.

1. 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](#adding-a-connector-to-an-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
<a name="adding-a-connector-to-an-agent-space"></a>

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:

1. Abra o AWS DevOps Console do agente em [https://console.aws.amazon.com/devops-agent/](https://console.aws.amazon.com/devops-agent/)e, em seguida, selecione seu Espaço do Agente.

1. Escolha a guia **Funcionalidades**.

1. Na seção da categoria do conector, escolha **Adicionar**.

1. Em **Adicionar um recurso**, localize o servidor MCP que você registrou a partir do conector e escolha **Adicionar**.

### Etapa 1: selecionar ferramentas
<a name="step-1-select-tools"></a>

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](working-with-devops-agent-working-with-directed-actions.md). Para obter mais informações sobre o número máximo de ferramentas MCP em um Agent Space, consulte [Cotas](quotas.md).

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)
<a name="step-2-select-recommended-skills-optional"></a>

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
<a name="step-3-review-and-save"></a>

Para salvar o conector no Espaço do Agente, conclua as seguintes etapas:

1. Analise as ferramentas, as habilidades e as **Webhook de alerta** tipo. Para alterá-los, escolha **Editar** em sua seção.

1. 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](#editing-a-connector-in-an-agent-space).

### Configurando o webhook de alerta
<a name="setting-up-the-alert-webhook"></a>

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:

1. 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.

1. Selecione **Salvei e armazenei meu URL e minhas credenciais**e, em seguida, escolha **Feito**.

1. 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: Bearer` cabeç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:body` com HMAC-SHA256. O produto do parceiro envia o carimbo de data/hora no `x-amzn-event-timestamp` cabeçalho e a assinatura no `x-amzn-event-signature` cabeç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](configuring-integrations-and-knowledge-invoking-devops-agent-through-webhook.md). Para obter mais informações sobre como substituir um segredo perdido, consulte [Credenciais rotativas de webhook](configuring-integrations-and-knowledge-invoking-devops-agent-through-webhook.html#rotating-webhook-credentials).

### Onde o conector aparece
<a name="where-the-connector-appears"></a>

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
<a name="editing-a-connector-in-an-agent-space"></a>

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:

1. Abra o AWS DevOps Console do agente em [https://console.aws.amazon.com/devops-agent/](https://console.aws.amazon.com/devops-agent/)e, em seguida, selecione seu Espaço do Agente.

1. Na **Capacidades** guia, selecione o servidor MCP em sua seção e, em seguida, escolha **Editar**.

1. 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.

1. Ligado **Selecione as habilidades recomendadas**, selecione as habilidades a serem mantidas ou instaladas. Para remover uma habilidade instalada, limpe-a.

1. (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.

1. 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
<a name="removing-a-connector-from-an-agent-space"></a>

Para remover um conector de um Agent Space, conclua as seguintes etapas:

1. Abra o AWS DevOps Console do agente em [https://console.aws.amazon.com/devops-agent/](https://console.aws.amazon.com/devops-agent/)e, em seguida, selecione seu Espaço do Agente.

1. Na **Capacidades** guia, selecione o servidor MCP em sua seção e, em seguida, escolha **Remover**.

1. 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
<a name="updating-or-deregistering-a-connector"></a>

Para encontrar um registro de conector, conclua as seguintes etapas:

1. Abra o AWS DevOps Console do agente em [https://console.aws.amazon.com/devops-agent/](https://console.aws.amazon.com/devops-agent/).

1. No painel de navegação, escolha **Provedores de capacidades**.

1. Abaixo **Registrado atualmente**, localize a placa do conector e escolha **Exibir tudo**.

1. 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ções**e, em seguida, escolha **Atualizar**. Na etapa de revisão, deixe **URL de autorização** vazio, escolha **Atualizar**e, 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](#removing-a-connector-from-an-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
<a name="troubleshooting-partner-managed-connectors"></a>

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”
<a name="this-connector-doesnt-define-a-url-for-the-endpoint-you-chose"></a>

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
<a name="registration-fails-because-the-name-is-in-use"></a>

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 MCP](#step-1-mcp-server-details)e, em seguida, registre-se novamente.

### A página do webhook de alerta não mostra nenhuma credencial
<a name="the-alert-webhook-page-shows-no-credential"></a>

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](configuring-integrations-and-knowledge-invoking-devops-agent-through-webhook.html#rotating-webhook-credentials).

### Os alertas não iniciam investigações
<a name="alerts-dont-start-investigations"></a>

O produto do parceiro deve enviar a solicitação exatamente como o console a mostrou. Para resolver esse problema, siga as seguintes etapas:

1. No produto do parceiro, verifique se o webhook usa o URL do webhook do console.

1. Verifique se cada solicitação inclui `Authorization` cabeçalho ou o `x-amzn-event-timestamp` e `x-amzn-event-signature` cabeçalhos para um webhook assinado.

1. 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](configuring-integrations-and-knowledge-invoking-devops-agent-through-webhook.html#troubleshooting-webhooks).

## Tópicos relacionados
<a name="related-topics"></a>
+ [AWS DevOps Segurança do agente](aws-devops-agent-security.md)
+ [Conectando servidores MCP](configuring-integrations-and-knowledge-connecting-mcp-servers.md)
+ [Conectando-se a ferramentas hospedadas de forma privada](configuring-integrations-and-knowledge-connecting-to-privately-hosted-tools.md)
+ [DevOps Habilidades do agente](about-aws-devops-agent-devops-agent-skills.md)
+ [Invocando DevOps Agente por meio de Webhook](configuring-integrations-and-knowledge-invoking-devops-agent-through-webhook.md)
+ [Trabalhando com ações direcionadas](working-with-devops-agent-working-with-directed-actions.md)