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à.
Integrazione con Model Context Protocol (MCP)
Con l'integrazione del Model Context Protocol (MCP) in Amazon Quick Suite, puoi connetterti ai server MCP sia per l'esecuzione delle attività che per le funzionalità di accesso ai dati. MCP offre un modo standardizzato per connettere i sistemi di intelligenza artificiale con strumenti e fonti di dati esterne.
Cosa puoi fare
Con l'integrazione MCP, è possibile connettersi ai server MCP sia per l'esecuzione delle azioni che per l'accesso ai dati tramite protocolli standardizzati.
- Connettore d'azione
-
Connect ai server MCP per eseguire azioni ed eseguire attività tramite protocolli MCP standardizzati.
- Integrazione dell'accesso ai dati
-
Accedi alle fonti di dati tramite server MCP per creare basi di conoscenza e recuperare informazioni.
Prima di iniziare
Prima di configurare l'integrazione MCP, assicurati di disporre di quanto segue:
-
Endpoint del server MCP con accesso appropriato.
-
Credenziali di autenticazione per il server MCP.
-
Amazon Quick Suite Author o versione successiva per Action Connectors.
-
Abbonamento Amazon Quick Suite Professional
Nota
L'integrazione MCP supporta solo server remoti. Lo streaming HTTP è preferito rispetto a Server-Sent Events (SSE). Le connessioni studio locali non sono supportate. La connettività VPC non è supportata.
Server MCP più diffusi
Di seguito sono riportati alcuni esempi di server MCP più diffusi utilizzati con Amazon Quick Suite e il server MCP remoto: URLs
:
| Provider | URL del server MCP |
|---|---|
| Asana | https://mcp.asana.com/sse |
| Atlassian | https://mcp.atlassian.com/v1/sse |
|
AWS Knowledge MCP Server |
|
| Box (Cubo) | http://mcp.box.com/ |
| HubSpot | https://mcp.hubspot.com |
| HuggingFace | https://huggingface.co/mcp |
| Intercom | https://mcp.intercom.com/mcp |
| Linear (Lineare) | https://mcp.linear.app/mcp |
| Lunedì | https://mcp.monday.com/sse |
| Nozione | https://mcp.notion.com/mcp |
| PagerDuty | https://identity.pagerduty.com/global/oauth/anonymous/.well-known/openid-configuration |
| Workat | https:// |
| Zapier |
La tabella seguente mostra solo alcuni dei molti MCPs supportati per l'uso con Amazon Quick Suite.
Nota
Questi server richiedono credenziali di autenticazione appropriate. Consulta la documentazione di ciascun provider per i requisiti di autenticazione specifici.
Preparare la configurazione e l'autenticazione del server MCP
Prima di configurare l'integrazione in Amazon Quick Suite, prepara la configurazione del server MCP e le credenziali di autenticazione. L'integrazione MCP supporta diversi metodi di autenticazione e approcci di configurazione. Scegliete il metodo che corrisponde ai requisiti del vostro server MCP:
- Autenticazione utente () OAuth
-
I server MCP supportano due approcci di configurazione per OAuth l'autenticazione:
- Registrazione dinamica del client (DCR)
-
Quando il server MCP pubblicizza il supporto per la registrazione dinamica dei client, non è richiesta alcuna configurazione manuale. Il client MCP si registra automaticamente sul server e riceve le credenziali necessarie durante il processo di connessione. Questo approccio semplificato elimina la necessità di raccogliere manualmente client IDs, segreti ed endpoint. URLs
- Configurazione manuale
-
Per i server MCP che non supportano DCR, raccogliete le seguenti informazioni dalla configurazione del server MCP:
ID client: OAuth ID client.
Client Secret: segreto OAuth del cliente.
URL del token: endpoint OAuth del token.
URL di autenticazione - endpoint di OAuth autorizzazione.
URL di reindirizzamento: OAuth URI di reindirizzamento.
- Autenticazione del servizio (da servizio a servizio)
-
Raccogli le seguenti informazioni dalla configurazione del tuo server MCP:
ID client: ID client del servizio.
Segreto del cliente: segreto del cliente del servizio.
URL del token: endpoint del token di servizio.
- Autenticazione tramite chiave API
-
Raccogli le seguenti informazioni dall'amministratore del server MCP:
Chiave API: chiave API del server MCP.
- Autenticazione con nome utente/password
-
Raccogli le seguenti informazioni dall'amministratore del server MCP:
Nome utente: nome utente del server MCP.
Password: password del server MCP.
Configura l'integrazione MCP
Dopo aver preparato la configurazione del server MCP e le credenziali di autenticazione, segui questi passaggi per creare l'integrazione MCP:
-
Nella console Amazon Quick Suite, scegli Integrazioni.
-
Fai clic su Aggiungi (più il pulsante «+»).
-
Nella pagina Crea integrazione, inserisci i dettagli dell'integrazione:
-
Nome: nome descrittivo per l'integrazione MCP.
-
Descrizione (opzionale): scopo dell'integrazione.
-
Endpoint del server MCP: URL del server MCP.
-
-
Fare clic su Avanti.
-
Seleziona il metodo di autenticazione (utente o servizio).
-
Fornisci i dettagli di configurazione appropriati.
-
Seleziona Crea e continua.
-
Rivedi i dettagli dell'integrazione.
-
Seleziona Avanti.
-
Condividi l'integrazione con altri utenti, se necessario.
Dopo aver creato l'integrazione MCP, al termine della creazione dell'integrazione viene creata automaticamente una knowledge base.
Gestisci le basi di conoscenza
Dopo aver configurato l'integrazione MCP, puoi creare e gestire le knowledge base dalle tue fonti di dati MCP.
Modifica le basi di conoscenza esistenti
È possibile modificare le knowledge base MCP esistenti:
-
Nella console Amazon Quick Suite, scegli Knowledge base.
-
Seleziona la tua knowledge base MCP dall'elenco.
-
Scegli Azioni, quindi scegli Modifica knowledge base.
-
Aggiorna le impostazioni di configurazione secondo necessità e scegli Salva.
Crea basi di conoscenza aggiuntive
Puoi creare più basi di conoscenza dalla stessa integrazione MCP:
-
Nella console Amazon Quick Suite, scegli Integrazioni.
-
Scegli la tua integrazione MCP esistente dall'elenco.
-
Scegli Azioni, quindi scegli Crea knowledge base.
-
Configura le impostazioni della knowledge base e scegli Crea.
Per informazioni dettagliate sulle opzioni di configurazione della knowledge base, consultaImpostazioni di configurazione comuni.
Rivedi l'integrazione
Dopo aver configurato l'autenticazione, esamina le funzionalità di integrazione MCP:
-
Il sistema si connette al server MCP e rileva le funzionalità disponibili.
-
Esamina l'elenco delle azioni e delle attività disponibili fornite dal server MCP.
-
Verifica le capacità di accesso ai dati se il server MCP fornisce fonti di dati.
-
Conferma la configurazione e le funzionalità di integrazione.
Scoperta delle capacità
L'integrazione MCP rileva ed elenca automaticamente:
Strumenti e azioni disponibili.
Fonti e risorse di dati.
Protocolli e metodi supportati.
Metadati e funzionalità del server.
Gestisci le integrazioni MCP
Dopo aver creato l'integrazione MCP, puoi gestirla utilizzando queste opzioni:
-
Condividi l'integrazione: rendi l'integrazione disponibile ad altri utenti della tua organizzazione.
-
Strumenti di revisione: verifica gli strumenti abilitati.
Nota
Le integrazioni MCP dipendono dalla disponibilità e dalla configurazione del server MCP di destinazione. Le modifiche al server o ai requisiti di autenticazione possono influire sulla funzionalità di integrazione.
Limitazioni
Quando utilizzi integrazioni MCP in Amazon Quick Suite, tieni presente le seguenti limitazioni:
-
Le operazioni MCP hanno un timeout fisso di 60 secondi. Le operazioni che superano questo limite falliscono automaticamente con un errore HTTP 424.
-
Le intestazioni HTTP personalizzate non sono supportate nelle operazioni MCP. Vengono trasmesse solo le intestazioni di sistema standard.
-
Gli elenchi degli strumenti rimangono statici dopo la registrazione iniziale. È necessario aggiornare manualmente le azioni per rilevare le modifiche sul lato server.
-
La creazione del connettore potrebbe non riuscire se l'URI di callback di Amazon Quick Suite non è consentito da provider di terze parti.
-
I problemi di connettività del server provocano un errore immediato senza tentativi di riprova.
