

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo di connettori gestiti dai partner
<a name="configuring-integrations-and-knowledge-using-partner-managed-connectors"></a>

Un connettore gestito dai partner si connette AWS DevOps Agente a un server Model Context Protocol (MCP) ospitato da un partner. Gli esempi includono il servizio di osservabilità o gestione degli incidenti di un partner. Il partner pubblica il connettore nel [AWS DevOps Archivio Agent Tools](https://github.com/aws/tools-for-devops-agent) sul GitHub sito web. Il connettore definisce gli endpoint del server e i metodi di autenticazione che accetta. Può anche elencare le competenze consigliate dal partner.

Con un connettore, non è necessario cercare gli URL degli endpoint, gli URL OAuth o gli ambiti del partner. Scegli un endpoint e inserisci solo le tue credenziali e AWS DevOps L'agente crea il resto della registrazione dal connettore. Utilizza un connettore quando il partner ne pubblica uno per il suo server MCP. Per istruzioni sulla registrazione di qualsiasi altro server MCP, vedere [Registrazione di un server MCP](configuring-integrations-and-knowledge-connecting-mcp-servers.html#registering-an-mcp-server-account-level).

In questo argomento, *connettore* indica la definizione del partner e *server MCP* indica la registrazione che viene creata da esso. La console utilizza gli stessi termini, ad esempio **Rimuovi il server MCP**.

Un connettore registra un server MCP, quindi i suoi strumenti funzionano come per un server MCP che registri tu stesso. Un connettore fornisce anche quanto segue:
+ **Configurazione fissa** — Gli URL degli endpoint, i metodi di autenticazione e gli URL e gli ambiti OAuth provengono dal connettore. Non puoi cambiarli.
+ **Competenze consigliate** — È possibile installare le competenze consigliate dal connettore quando lo si aggiunge a un Agent Space. Successivamente, puoi installarne altre, attivarle o disattivarle o rimuoverle.
+ **Webhook di avviso** — Quando si aggiunge il connettore a un Agent Space, AWS DevOps L'agente crea un webhook in modo che gli avvisi provenienti dal prodotto del partner possano avviare le indagini. Alcuni connettori definiscono anche il payload degli avvisi per te.

## Come funzionano i connettori gestiti dai partner
<a name="how-partner-managed-connectors-work"></a>

L'elenco seguente descrive chi gestisce il server di un connettore e dove vanno i tuoi dati:
+ **Funzionamento del server** — Il partner gestisce e supporta il server MCP. AWS non lo gestisce. Per assistenza con il server, usa il **Supporto** collegamento per il connettore nella console.
+ **Manutenzione del connettore** — Ogni connettore mostra un **Partner-managed** o **AWS-gestito** distintivo. I nomi dei badge che mantengono la definizione del connettore.
+ **Credenziali** — Le tue credenziali vanno solo agli URL nella definizione del connettore.
+ **Richieste** — L'endpoint che scegli appartiene alla regione o al sito del partner per il tuo account con il partner. Può essere al di fuori del AWS Regione del tuo spazio agente. Come per qualsiasi server MCP a cui ci si connette, le richieste al server vengono quindi abbandonate AWS Regione.

## Registrazioni e versioni
<a name="registrations-and-versions"></a>

L'elenco seguente descrive in che modo una registrazione si riferisce ad Agent Spaces e alle versioni dei connettori:
+ **Ambito di registrazione** — Si registra un connettore una volta nel AWS account. Quindi lo aggiungi a ogni Agent Space che ne ha bisogno.
+ **Versioni** — Una registrazione mantiene la versione del connettore registrata. Quando un partner rende obsoleto un connettore, il connettore non viene più visualizzato nella **Disponibile** sezione e non puoi registrarla nuovamente. La sua scheda è sotto **Attualmente registrato** mostra **Obsoleto**e la pagina che **Visualizza tutto** opens può assegnare un nome al connettore che lo sostituisce. Le registrazioni esistenti continuano a funzionare finché non vengono annullate.

## Competenze consigliate
<a name="recommended-skills"></a>

Un'abilità consigliata è un'abilità che il partner suggerisce per il suo connettore, ad esempio una guida sull'uso degli strumenti del partner durante un'indagine. Le competenze consigliate provengono dal catalogo delle competenze in [AWS DevOps Archivio Agent Tools](https://github.com/aws/tools-for-devops-agent) sul GitHub sito web. È possibile installare le competenze consigliate quando si aggiunge il connettore a un Agent Space. Quando modifichi il server MCP in un secondo momento, puoi installare altre competenze, abilitare o disabilitare le competenze installate o rimuoverle.

Un'abilità installata consigliata viene visualizzata insieme alle altre abilità nel tuo Agent Space. Il suo contenuto proviene dal catalogo, quindi non è possibile modificarlo. L'agente lo carica nello stesso modo di qualsiasi altra abilità. Per ulteriori informazioni sulle competenze, consulta [DevOps Competenze degli agenti](about-aws-devops-agent-devops-agent-skills.md).

## Prima di iniziare
<a name="before-you-begin"></a>

Per utilizzare un connettore gestito dai partner, verifica di disporre di quanto segue:
+ Un account con il partner in grado di creare le credenziali richieste dal connettore, ad esempio una chiave API o un client OAuth. La guida alla configurazione del connettore elenca i passaggi del prodotto del partner.
+ Autorizzazione a registrare i fornitori di funzionalità e ad aggiungere funzionalità a un Agent Space nel AWS DevOps Console dell'agente.
+ (Facoltativo) Una connessione privata esistente, se raggiungi l'endpoint del partner tramite una rete privata. Per ulteriori informazioni sulle connessioni private, consulta [Connessione a strumenti ospitati privatamente](configuring-integrations-and-knowledge-connecting-to-privately-hosted-tools.md).

Per ulteriori informazioni sulle considerazioni di sicurezza che si applicano a qualsiasi server MCP, ad esempio consentire l'inserimento di elenchi solo gli strumenti necessari, consultate [Considerazioni sulla sicurezza](configuring-integrations-and-knowledge-connecting-mcp-servers.html#security-considerations).

## Trovare un connettore
<a name="finding-a-connector"></a>

Trova un connettore per visualizzarne la guida alla configurazione e le competenze consigliate prima di registrarlo. Puoi iniziare con **Fornitori di capacità** pagina o da un Agent Space.

### Ricerca di un connettore nella pagina Capability Providers
<a name="finding-a-connector-on-the-capability-providers-page"></a>

Per trovare un connettore su **Fornitori di capacità** pagina, completa i seguenti passaggi:

1. Aprire il AWS DevOps Console dell'agente all'indirizzo [https://console.aws.amazon.com/devops-agent/](https://console.aws.amazon.com/devops-agent/).

1. Nel pannello di navigazione, scegli **Fornitori di capacità**.

1. Nel **Disponibile** sezione, trova il connettore. Per restringere l'elenco, inserisci il suo nome in **Trova funzionalità**o scegli una categoria. Ogni scheda riporta il badge, la descrizione e le categorie del connettore.

1. Scegli il nome del connettore.

Si apre la pagina del connettore. Per saltarla e iniziare la registrazione, puoi scegliere **Registrare** sulla carta invece.

### Trovare un connettore da un Agent Space
<a name="finding-a-connector-from-an-agent-space"></a>

Per trovare un connettore da un Agent Space, completa i seguenti passaggi:

1. Aprite il AWS DevOps Console dell'agente all'indirizzo [https://console.aws.amazon.com/devops-agent/](https://console.aws.amazon.com/devops-agent/), quindi seleziona il tuo Agent Space.

1. Scegli la scheda **Funzionalità**.

1. Nella sezione relativa alla categoria del connettore, ad esempio **Telemetria**, **Comunicazioni**, o **DevOps**, scegli **Inserisci**.

1. Nel **Aggiungere una funzionalità**, sotto **Partner-managed connettori**, scegli **Registrare**.

1. Nell'elenco dei connettori, scegli **Seleziona** per il connettore.

Si apre la pagina del connettore.

### Cosa mostra la pagina del connettore
<a name="what-the-connectors-page-shows"></a>

La pagina del connettore mostra le seguenti informazioni:
+ Il partner, la versione del connettore e le relative categorie
+ Collegamenti alla documentazione e al supporto del partner
+ La guida alla configurazione del connettore
+ Le competenze consigliate dal connettore

Per iniziare la registrazione, scegli **Registrare**. Per istruzioni, vedere [Registrazione di un connettore](#registering-a-connector).

## Registrazione di un connettore
<a name="registering-a-connector"></a>

Quando si registra un connettore, AWS DevOps L'agente crea una registrazione del server MCP nel tuo AWS account dalla definizione del connettore. La registrazione è composta da quattro fasi. La console salta i passaggi non necessari al connettore.

### Fase 1: dettagli del server MCP
<a name="step-1-mcp-server-details"></a>

In questo passaggio, assegnate un nome al server MCP e scegliete dove AWS DevOps L'agente si connette. Il titolo del passaggio include il nome del connettore, ad esempio **Esempio di dettagli del server MCP di Corp**.

Se il passaggio mostra **Guida all'installazione**, espandilo prima di compilare il modulo e completa i passaggi del partner. Mostrano come creare le credenziali che inserisci [Fase 3: configurazione dell'autenticazione](#step-3-authentication-configuration). Per conservare una copia dei passaggi, scegli **Copia**.

Immetti le seguenti informazioni:
+ **Nome** — Inserire un nome breve per questo server MCP. La console inserisce il nome del connettore, che è possibile modificare. Usa lettere, numeri, trattini (`-`) e caratteri di sottolineatura (`_`). Il nome deve essere univoco nel tuo AWS account. AWS DevOps L'agente aggiunge il nome all'inizio del nome di ogni strumento e il nome dello strumento può contenere al massimo 64 caratteri, quindi mantieni il nome breve.
+ **Punto finale** — Alcuni partner offrono più di un endpoint, ad esempio un sito regionale. In tal caso, scegli l'endpoint utilizzato dal tuo account con il partner. Altrimenti, la console mostra l'endpoint del connettore. L'URL dell'endpoint viene visualizzato in AWS CloudTrail accede al tuo account.
+ **Campi del connettore** — Alcuni connettori richiedono più valori, ad esempio il nome dell'istanza con il partner. Ogni campo mostra l'etichetta che gli assegna il connettore. Inserisci il valore del tuo account con il partner.
+ **Connettiti all'endpoint utilizzando una connessione privata** — (Facoltativo) Seleziona questa opzione per indirizzare le richieste all'endpoint del partner tramite una connessione privata esistente. Per un connettore che utilizza OAuth, puoi scegliere una connessione privata separata per lo scambio di token.
+ **Configurazione avanzata** — (Facoltativo) Scegli un cliente gestito AWS Servizio di gestione delle chiavi (AWS chiave KMS) per crittografare la registrazione. Per ulteriori informazioni sulla crittografia, vedere [Crittografia inattiva per DevOps Agente](aws-devops-agent-security-encryption-at-rest-for-devops-agent.md).

Scegli **Avanti**.

### Fase 2: Metodo di autenticazione
<a name="step-2-authentication-method"></a>

In questo passaggio, scegli come AWS DevOps L'agente esegue l'autenticazione sul prodotto del partner. Questo passaggio viene visualizzato solo quando il connettore offre più di un metodo di autenticazione. Il connettore definisce l'ordine dei metodi. Seleziona una delle seguenti opzioni:
+ **Chiave API** — AWS DevOps L'agente si autentica con una chiave che crei nel prodotto del partner, in modo da controllarne le autorizzazioni.
+ **Credenziali del cliente OAuth** — AWS DevOps L'agente si autentica con un ID cliente e un segreto che crei nel prodotto del partner.
+ **Accedi a** *compagno* (ad esempio, **Accedi a Example Corp**) — AWS DevOps L'agente agisce per tuo conto dopo che hai effettuato l'accesso al prodotto del partner.
+ **Accedi con la registrazione dinamica del cliente** — AWS DevOps L'agente registra il proprio client OAuth presso il partner e quindi agisce per tuo conto dopo l'accesso.

Scegli **Avanti**.

### Fase 3: configurazione dell'autenticazione
<a name="step-3-authentication-configuration"></a>

In questo passaggio, inserisci le credenziali necessarie al tuo metodo di autenticazione. Le **Definito dal connettore** la sezione mostra i valori impostati dal connettore, che non è possibile modificare.

La console salta questo passaggio per **Accedi con la registrazione dinamica del cliente**. Inoltre, salta questo passaggio per **Accedi a** *compagno* quando il connettore fornisce il proprio client OAuth.

#### Chiave API
<a name="api-key"></a>

Per una chiave API, immettete un valore per ogni intestazione elencata nel connettore. Il connettore imposta il nome dell'intestazione e qualsiasi prefisso, ad esempio `Bearer `, quindi inserisci solo la chiave.

#### Credenziali del client OAuth
<a name="oauth-client-credentials"></a>

Per le credenziali del client OAuth, completa i seguenti passaggi:

1. Inserisci il **ID cliente** e **Segreto del cliente** che hai creato nel prodotto del partner.

1. (Facoltativo) Aggiungi **Ambiti aggiuntivi** e **Parametri di scambio aggiuntivi**. AWS DevOps L'agente li richiede in aggiunta agli ambiti e ai parametri definiti dal connettore.

#### Accedi al partner
<a name="sign-in-to-the-partner"></a>

Per **Accedi a** *compagno*, completa i seguenti passaggi:

1. Se il connettore non fornisce un proprio client OAuth, inserisci **ID cliente** e **Segreto del cliente** che hai creato nel prodotto del partner. Se il partner supporta Proof Key for Code Exchange (PKCE), puoi lasciare vuoto il segreto del cliente.

1. (Facoltativo) Aggiungi **Ambiti aggiuntivi**.

Scegli **Avanti**.

### Fase 4: Rivedi e registrati
<a name="step-4-review-and-register"></a>

Per completare la registrazione, completa i seguenti passaggi:

1. Rivedi i dettagli. Per modificare un passaggio, scegli **Modifica** nella sezione dedicata a quel passaggio.

1. Scegli **Registrati**.

1. Se hai scelto un metodo di accesso, accedi alla pagina del partner aperta dalla console, quindi approva l'accesso.

La console torna a AWS DevOps Agente, e la registrazione è completa. Se ti sei registrato da un Agent Space, la console apre quindi la procedura per aggiungere il connettore a quell'Agent Space. Se ti sei registrato da **Fornitori di capacità** pagina, vedere [Aggiungere un connettore a un Agent Space](#adding-a-connector-to-an-agent-space).

Se la registrazione non riesce, la console rimane in fase di revisione e mostra l'errore. Correggi i dettagli, quindi scegli **Registrare** di nuovo.

## Aggiungere un connettore a un Agent Space
<a name="adding-a-connector-to-an-agent-space"></a>

Quando si aggiunge un connettore a un Agent Space, si scelgono gli strumenti che gli agenti possono utilizzare e, facoltativamente, si installano le competenze consigliate del connettore. Se il connettore è stato registrato da **Fornitori di capacità** pagina, inizia dal tuo Agent Space:

1. Apri il AWS DevOps Console dell'agente all'indirizzo [https://console.aws.amazon.com/devops-agent/](https://console.aws.amazon.com/devops-agent/), quindi seleziona il tuo Agent Space.

1. Scegli la scheda **Funzionalità**.

1. Nella sezione relativa alla categoria del connettore, scegli **Inserisci**.

1. Nel **Aggiungere una funzionalità**, trova il server MCP che hai registrato dal connettore, quindi scegli **Inserisci**.

### Fase 1: Seleziona gli strumenti
<a name="step-1-select-tools"></a>

In questo passaggio, scegli gli strumenti che l'agente può utilizzare in questo Agent Space. Seleziona solo gli strumenti di cui ha bisogno il tuo Agent Space. Se classifichi gli strumenti come di sola lettura o mutanti, scegli una classificazione per ogni strumento. Per ulteriori informazioni sulla classificazione degli strumenti, vedere [Lavorare con azioni dirette](working-with-devops-agent-working-with-directed-actions.md). Per ulteriori informazioni sul numero massimo di strumenti MCP in un Agent Space, vedere [Quote](quotas.md).

Alcuni connettori mostrano anche **Tipo di autenticazione Webhook**. Scegli in che modo il prodotto del partner si autentica nel webhook di avviso di Agent Space: **HMAC** (impostazione predefinita) o **Chiave API**. I connettori che definiscono i propri avvisi lo impostano per te.

Per saltare la fase delle competenze opzionali, scegli **Passa a Rivedi e salva**. Altrimenti, scegli **Next** (Successivo).

### Fase 2: Seleziona le competenze consigliate (opzionale)
<a name="step-2-select-recommended-skills-optional"></a>

Questo passaggio viene visualizzato solo quando il connettore consiglia le competenze. In questo passaggio, scegli le competenze consigliate da installare. La console elenca le competenze consigliate dal connettore, nessuna selezionata. Viene visualizzata una skill già installata in Agent Space **Abilitata** o **Disabili**e non puoi selezionarlo. Seleziona le competenze che desideri installare, quindi scegli **Avanti**.

### Passaggio 3: Rivedere e salvare
<a name="step-3-review-and-save"></a>

Per salvare il connettore nell'Agent Space, completare i seguenti passaggi:

1. Rivedi gli strumenti, le competenze e **Webhook Alert** digitare. Per modificarli, scegli **Modifica** nella loro sezione.

1. Selezionare **Salva**.

AWS DevOps L'agente aggiunge il server MCP all'Agent Space e quindi installa le competenze selezionate. Se una skill non viene installata, viene elencata una notifica e il server MCP rimane nell'Agent Space. Per riprovare, modifica il connettore nell'Agent Space, quindi seleziona la skill. Per istruzioni, consulta [Modifica di un connettore in un Agent Space](#editing-a-connector-in-an-agent-space).

### Impostazione del webhook di avviso
<a name="setting-up-the-alert-webhook"></a>

Dopo aver scelto **Salva**, si apre la console **Configura un webhook di avviso**. Si apre ogni volta che si aggiunge il connettore a un Agent Space, ma non quando si modifica il connettore. Dopo aver impostato il webhook, ogni avviso inviato avvia un'indagine nell'Agent Space.

Per configurare il webhook, completa i seguenti passaggi:

1. Copia il **URL del webhook**, il **Intestazione** o **Segreto di firma**, e il **Corpo della richiesta** o **Richiedi il formato del corpo**. Per salvare l'URL e il segreto in un file, scegli **Scarica il file .csv**. AWS DevOps L'agente mostra il segreto solo una volta.

1. Seleziona **Ho salvato e archiviato il mio URL e le mie credenziali**, quindi scegli **Fatto**.

1. Configura il webhook nel prodotto del partner. Per istruzioni, consulta la guida alla configurazione del connettore.

I valori funzionano come segue:
+ **URL del webhook** — L'URL a cui il prodotto del partner invia gli avvisi.
+ **- Intestazione** — Per un webhook che utilizza un token al portatore, `Authorization: Bearer` intestazione che il prodotto del partner invia con ogni richiesta.
+ **Firma segreta** — Per un webhook che firma le richieste, il segreto utilizzato dal prodotto del partner per firmare `timestamp:body` con HMAC-SHA256. Il prodotto del partner invia il timestamp nel `x-amzn-event-timestamp` intestazione e firma in `x-amzn-event-signature` intestazione.
+ **Corpo della richiesta** — Per un connettore che definisce i relativi avvisi, il payload degli avvisi. Il prodotto del partner inserisce i valori del modello quando viene attivato un avviso.
+ **Formato del corpo della richiesta** — Per qualsiasi altro connettore, il formato JSON che ogni avviso deve utilizzare. Assegna a ogni avviso un valore univoco `incidentId`.

Quale delle **Intestazione** o **Segreto di firma** come vedi, dipende da come si autentica il webhook. O è il connettore a impostarlo o lo scegli tu **Seleziona strumenti**. Non dipende dal metodo di autenticazione scelto al momento della registrazione del connettore.

Per ulteriori informazioni sull'autenticazione e sul payload del webhook, vedi [Invocando DevOps Agente tramite Webhook](configuring-integrations-and-knowledge-invoking-devops-agent-through-webhook.md). Per ulteriori informazioni sulla sostituzione di un segreto perduto, vedi [Rotazione delle credenziali del webhook](configuring-integrations-and-knowledge-invoking-devops-agent-through-webhook.html#rotating-webhook-credentials).

### Dove appare il connettore
<a name="where-the-connector-appears"></a>

Sul **Capacità** scheda, il connettore viene visualizzato nella sezione relativa alla prima categoria: **Telemetria**, **Gasdotto**, **Comunicazioni**, o **DevOps**. Un connettore la cui prima categoria è **Nuvola**, o che il catalogo non elenca più, viene visualizzato nel **Server MCP** sezione.

## Modifica di un connettore in un Agent Space
<a name="editing-a-connector-in-an-agent-space"></a>

È possibile modificare gli strumenti di un connettore in un Agent Space e installare, abilitare, disabilitare o rimuovere le competenze consigliate. Per modificare un connettore, completa i seguenti passaggi:

1. Aprite il AWS DevOps Console dell'agente all'indirizzo [https://console.aws.amazon.com/devops-agent/](https://console.aws.amazon.com/devops-agent/), quindi seleziona il tuo Agent Space.

1. Sul **Capacità** scheda, seleziona il server MCP nella sua sezione, quindi scegli **Modifica**.

1. Attiva **Seleziona strumenti**, cambia gli strumenti. La console parte dagli strumenti che hai salvato. Se il server MCP non elenca più uno strumento salvato, la console rimuove lo strumento dalla selezione e mostra un avviso.

1. Attivato **Seleziona le competenze consigliate**, seleziona le competenze da conservare o installare. Per rimuovere una skill installata, cancellala.

1. (Facoltativo) Attivato **Imposta lo stato dell'abilità**, attiva o disattiva ogni abilità installata. Gli agenti utilizzano solo le abilità attive. Questo passaggio viene visualizzato solo quando è installata almeno una skill.

1. Attiva **Rivedi e salva**, rivedi le modifiche apportate a ciascuna abilità, quindi scegli **Salva**.

AWS DevOps L'agente salva le modifiche e il webhook di avviso rimane invariato. Prima di salvare, la revisione ti avvisa se la modifica rimuove le competenze. Ti avvisa anche se un altro connettore in Agent Space consiglia un'abilità da disattivare o rimuovere, perché la modifica si applica anche a quel connettore. Puoi installare nuovamente una skill rimossa in un secondo momento.

Se una modifica a una skill fallisce, viene elencata una notifica e le altre modifiche vengono mantenute. Per riprovare, modifica nuovamente il connettore.

## Rimozione di un connettore da un Agent Space
<a name="removing-a-connector-from-an-agent-space"></a>

Per rimuovere un connettore da un Agent Space, completare i seguenti passaggi:

1. Aprire il AWS DevOps Console dell'agente all'indirizzo [https://console.aws.amazon.com/devops-agent/](https://console.aws.amazon.com/devops-agent/), quindi seleziona il tuo Agent Space.

1. Sul **Capacità** scheda, seleziona il server MCP nella sua sezione, quindi scegli **Rimuovi**.

1. Nel **Rimuovi il server MCP**, controlla la conferma, quindi scegli **Rimuovi**.

Il server MCP viene rimosso dall'Agent Space. La sua rimozione comporta anche l'eliminazione delle competenze consigliate del connettore installate nell'Agent Space. Ciò include un'abilità consigliata che hai installato tu stesso. Un'abilità rimane installata se viene consigliata anche da un altro connettore nell'Agent Space. La conferma nomina l'abilità o indica il numero di abilità prima che qualcosa venga eliminato. Questa operazione non può essere annullata.

Se AWS DevOps L'agente non è in grado di verificare quali competenze sono installate, lo dice la conferma. In tal caso, le competenze rimangono installate e **Rimuovi** rimuove solo il server MCP.

## Aggiornamento o annullamento della registrazione di un connettore
<a name="updating-or-deregistering-a-connector"></a>

Per trovare la registrazione di un connettore, completa i seguenti passaggi:

1. Apri il AWS DevOps Console dell'agente all'indirizzo [https://console.aws.amazon.com/devops-agent/](https://console.aws.amazon.com/devops-agent/).

1. Nel pannello di navigazione, scegli **Fornitori di capacità**.

1. Sotto **Attualmente registrato**, trova la scheda del connettore, quindi scegli **Visualizza tutto**.

1. Nel **Registrazioni**, seleziona il server MCP.

Se la registrazione utilizza **Accedi a** *compagno* o **Accedi con la registrazione dinamica del cliente**, puoi accedere nuovamente senza annullare la registrazione, ad esempio dopo che il partner ha revocato l'accesso. Scegli **Azioni**, quindi scegli **Aggiorna**. Nella fase di revisione, esci **URL di autorizzazione** vuoto, scegli **Aggiorna**, quindi accedi alla pagina del partner. AWS DevOps L'agente aggiorna l'accesso e le credenziali del cliente e le associazioni di Agent Space rimangono invariate.

Per modificare una chiave API o le credenziali del client OAuth o per utilizzare una versione più recente del connettore, annulla la registrazione del server MCP e registra nuovamente il connettore. Per annullare la registrazione, rimuovi prima il server MCP da ogni Agent Space che lo utilizza. Per istruzioni, vedere [Rimozione di un connettore da un Agent Space](#removing-a-connector-from-an-agent-space). Quindi seleziona il server MCP, scegli **Azioni**e scegli **Annulla la registrazione**. La console annulla immediatamente la registrazione del server MCP, senza chiedere conferma.

## Risoluzione dei problemi relativi ai connettori gestiti dai partner
<a name="troubleshooting-partner-managed-connectors"></a>

Utilizza le seguenti informazioni per risolvere i problemi più comuni con i connettori gestiti dai partner.

### «Questo connettore non definisce un URL per l'endpoint che hai scelto»
<a name="this-connector-doesnt-define-a-url-for-the-endpoint-you-chose"></a>

Questo errore indica che la definizione del connettore non include l'endpoint scelto. Per risolverlo, scegli un altro endpoint. Se l'errore persiste, contatta l'assistenza del connettore.

### La registrazione non riesce perché il nome è in uso
<a name="registration-fails-because-the-name-is-in-use"></a>

I nomi dei server MCP devono essere univoci nel tuo AWS account. Per risolvere il problema, inserisci un altro nome in [Fase 1: dettagli del server MCP](#step-1-mcp-server-details)e quindi effettuare nuovamente la registrazione.

### La pagina webhook di avviso non mostra alcuna credenziale
<a name="the-alert-webhook-page-shows-no-credential"></a>

Se **Configura un webhook di avviso** mostra un errore al posto dell'intestazione o del segreto di firma, AWS DevOps L'agente non ha restituito una credenziale per il webhook. Per ottenerne una, ruota il webhook. Per istruzioni, consulta [Rotazione delle credenziali del webhook](configuring-integrations-and-knowledge-invoking-devops-agent-through-webhook.html#rotating-webhook-credentials).

### Gli avvisi non avviano le indagini
<a name="alerts-dont-start-investigations"></a>

Il prodotto del partner deve inviare la richiesta esattamente come indicata dalla console. Per risolvere il problema, completala seguente procedura:

1. Nel prodotto del partner, verifica che il webhook utilizzi l'URL del webhook dalla console.

1. Verifica che ogni richiesta includa `Authorization` intestazione o `x-amzn-event-timestamp` e `x-amzn-event-signature` intestazioni per un webhook firmato.

1. Verifica che il corpo della richiesta corrisponda a **Corpo della richiesta** o **Richiedi il formato del corpo** dalla console.

Per ulteriori procedure di risoluzione dei problemi, consulta [Risoluzione dei problemi relativi ai webhook](configuring-integrations-and-knowledge-invoking-devops-agent-through-webhook.html#troubleshooting-webhooks).

## Argomenti correlati
<a name="related-topics"></a>
+ [AWS DevOps Sicurezza degli agenti](aws-devops-agent-security.md)
+ [Connessione dei server MCP](configuring-integrations-and-knowledge-connecting-mcp-servers.md)
+ [Connessione a strumenti ospitati privatamente](configuring-integrations-and-knowledge-connecting-to-privately-hosted-tools.md)
+ [DevOps Competenze degli agenti](about-aws-devops-agent-devops-agent-skills.md)
+ [Invocare DevOps Agente tramite Webhook](configuring-integrations-and-knowledge-invoking-devops-agent-through-webhook.md)
+ [Lavorare con azioni dirette](working-with-devops-agent-working-with-directed-actions.md)