Creare e configurare un connettore MCP

La pagina descrive come creare e configurare un connettore MCP in Integration Connectors. Per saperne di più sul connettore MCP, consulta Panoramica del connettore MCP.

Prima di iniziare

Prima di utilizzare il connettore MCP, completa le seguenti attività:

  • Nel tuo Google Cloud progetto:
    • Assicurati che la connettività di rete sia configurata. Per informazioni sui pattern di rete, consulta Connettività di rete.
    • Concedi il ruolo IAM roles/connectors.admin all'utente che configura il connettore.
    • Concedi i seguenti ruoli IAM al account di servizio che vuoi utilizzare per il connettore:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Un account di servizio è un tipo speciale di Account Google destinato a rappresentare un utente "non umano" che deve eseguire l'autenticazione ed essere autorizzato ad accedere ai dati nelle API Google. Se non hai un account di servizio, devi crearne uno. Il connettore e il account di servizio devono appartenere allo stesso progetto. Per saperne di più, consulta Creare un service account.

    • Attiva i seguenti servizi:
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (Connettori API)

      Per scoprire come attivare i servizi, consulta Attivare i servizi. Se questi servizi o queste autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti verrà chiesto di attivarli durante la configurazione del connettore.

Configurare il connettore

Una connessione è specifica per un'origine dati. Ciò significa che, se hai molte origini dati, devi creare una connessione separata per ciascuna di esse. Per creare una connessione:

  1. Nella Google Cloud console, vai alla pagina Integration Connectors > Connessioni.

    Vai a Connessioni

  2. Seleziona o crea un progetto da utilizzare per il connettore.
  3. Fai clic su Crea connessione.

    Viene visualizzata la pagina Crea connessione.

  4. Nella sezione Località :
    1. Fai clic su Regione e seleziona una località per la connessione.

      Per un elenco di tutte le regioni supportate, consulta Località.

    2. Fai clic su Avanti.
  5. Nella sezione Dettagli connessione, fornisci i seguenti dettagli:
    1. Connettore: seleziona MCP (anteprima).
    2. Versione del connettore: seleziona la versione del connettore da utilizzare.
    3. Nome connessione: inserisci un nome per la connessione.
    4. Descrizione: (facoltativo) inserisci una descrizione per la connessione.
    5. (Facoltativo) attiva Cloud Logging, e seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su Error.
    6. Service account: seleziona il account di servizio da utilizzare per la connessione. Assicurati che il account di servizio disponga dei ruoli e delle autorizzazioni IAM pertinenti.
    7. Endpoint MCP: (facoltativo) lascia vuoto per utilizzare l'endpoint predefinito /mcp. Se l'endpoint è uguale all'indirizzo host, impostalo su /. Applicabile solo per il server HTTP Streamable.
    8. Impostazioni nodo di connessione: (facoltativo) configura le impostazioni del nodo di connessione.
      • Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
      • Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.

      Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Più nodi elaborano più transazioni per una connessione e meno nodi elaborano meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta Prezzi dei nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita, il numero minimo di nodi è 2 (per una maggiore disponibilità) e il numero massimo di nodi è 50.

    9. Fai clic su Avanti.
  6. Nella sezione Destinazioni, inserisci i dettagli dell'host remoto (sistema di backend) a cui connetterti.
    1. Tipo di destinazione: seleziona il tipo di destinazione.
      • Per specificare il nome host o l'indirizzo IP di destinazione, seleziona Indirizzo host e inserisci l'indirizzo nel campo Host 1.
      • Per stabilire una connessione privata, seleziona collegamento dell'endpoint. Nell'elenco Collegamento dell'endpoint, seleziona il collegamento dell'endpoint creato per il sistema di backend.

      Se vuoi stabilire una connessione pubblica ai tuoi sistemi di backend con una maggiore sicurezza, puoi considerare la configurazione di indirizzi IP in uscita statici per le tue connessioni, e poi configurare le regole firewall in modo da consentire solo gli indirizzi IP statici specifici.

      Esempi di indirizzi host da utilizzare:

      • https://your-service.example.com/sse (nessuna autenticazione)
      • https://your-oauth-provider.example.com/sse (OAuth 2.0 - Codice di autorizzazione)
      • https://your-api-key-service.example.com/sse (autenticazione con chiave API)
    2. Per inserire altre destinazioni, fai clic su +Aggiungi destinazione.
    3. Fai clic su Avanti.
  7. Nella sezione Autenticazione, seleziona e configura l'autenticazione per la connessione:

    Nessuna autenticazione

    Questo tipo viene utilizzato per gli host senza requisiti di autenticazione specifici.

    OAuth 2.0 - Codice di autorizzazione

    Questo tipo viene utilizzato per gli host che supportano il tipo di concessione del codice di autorizzazione OAuth 2.0.

    1. ID client : inserisci l'ID client fornito dall'applicazione esterna.
    2. Ambiti : inserisci gli ambiti di autorizzazione richiesti.
    3. Client secret: scegli il secret di Secret Manager contenente il client secret.
    4. Versione del secret : seleziona la versione del secret di Secret Manager per il client secret.
    5. Abilita PKCE : (facoltativo) abilita PKCE per il flusso del codice di autorizzazione. Abilita solo se il server supporta PKCE.
    6. URL di autorizzazione: Inserisci l'URL per l'autorizzazione.
    7. URL del token di accesso : inserisci l'URL per ottenere il token di accesso.

    Per l'autenticazione con Authorization code, dopo aver creato la connessione, devi completare alcuni passaggi aggiuntivi per completare la configurazione dell'autenticazione. Per saperne di più, consulta Passaggi aggiuntivi dopo la creazione della connessione.

    Passaggi aggiuntivi dopo la creazione della connessione

    Se hai selezionato OAuth 2.0 - Codice di autorizzazione per l'autenticazione, devi completare i seguenti passaggi aggiuntivi dopo aver creato la connessione:

    1. Nella pagina Connessioni, individua la connessione appena creata.
    2. Lo stato della nuova connessione è Autorizzazione richiesta.
    3. Fai clic su Autorizzazione richiesta.

      Viene visualizzato il riquadro Modifica autorizzazione.

    4. Copia il valore URI di reindirizzamento nell'applicazione esterna.
    5. Verifica i dettagli dell'autorizzazione.
    6. Fai clic su Autorizza.

      Se l'autorizzazione va a buon fine, lo stato della connessione viene impostato su Attiva nella pagina Connessioni.

    Autenticazione con chiave API

    Questo tipo viene utilizzato per gli host che richiedono una chiave API per l'autenticazione.

    • Chiave API : seleziona il secret di Secret Manager contenente la chiave API. Ad esempio, projects/PROJECT_ID/secrets/your-api-key-secret/versions/1.
    • Nome parametro chiave API : il nome del parametro per la chiave API. Ad esempio, Authorization.
    • Località chiave API : la località in cui viene inviata la chiave API. Ad esempio, Header.
  8. Fai clic su Avanti.
  9. Nella sezione Revisione, esamina i dettagli della connessione e dell'autenticazione. Per apportare modifiche, fai clic su una delle sezioni precedenti.
  10. Fai clic su Crea.

    Integration Connectors inizia a creare la connessione con la configurazione fornita. La creazione della connessione richiede alcuni minuti. Una volta creata la connessione, il sistema ti reindirizza alla pagina Connessioni.

Utilizzare la connessione MCP in un'integrazione

Dopo aver creato la connessione, questa diventa disponibile in Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

  • Per scoprire come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.

Creare un'integrazione utilizzando il connettore MCP

Per creare un'integrazione utilizzando il connettore MCP:

  1. Aggiungi un trigger API all'integrazione:
    1. Nella Google Cloud console, vai alla pagina Application Integration.

      Vai ad Application Integration

    2. Nel menu di navigazione, fai clic su Integrazioni. Viene visualizzata la pagina Elenco integrazioni.
    3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.
    4. Se stai creando una nuova integrazione:
      1. Inserisci un nome e una descrizione dell'integrazione nel riquadro Crea integrazione.
      2. Seleziona una regione per l'integrazione.
      3. (Facoltativo) Seleziona un account di servizio per l'integrazione.
      4. Fai clic su Crea. La nuova integrazione si apre nell'editor di integrazione.
    5. Nella barra di navigazione dell'editor di integrazione, fai clic su Trigger per visualizzare l'elenco dei trigger disponibili.
    6. Fai clic sull'elemento Trigger API e posizionalo nel designer.
  2. Aggiungi Mappatura dati , se necessario.
  3. Vai a Attività e scegli uno dei connettori elencati sopra o quello che hai creato, se applicabile.
  4. Fai clic su Configura connettore e scegli le azioni. Le impostazioni predefinite sono preselezionate.

    Un menu a discesa mostrerà varie azioni, che in questo contesto sono strumenti.

    Screenshot che mostra le azioni disponibili nella configurazione del connettore MCP.

    1. Configura i parametri di input richiesti per l'azione. Puoi impostarli come input di integrazione, utilizzare le variabili delle attività precedenti o specificare direttamente i valori predefiniti.
    2. Trasmetti gli argomenti richiesti e testa la connessione.

      Screenshot che mostra l'input dell'attività nella configurazione del connettore MCP.

Per un elenco delle entità e delle operazioni supportate, consulta Entità e operazioni supportate. Per informazioni sulle azioni specifiche del connettore supportate, consulta Azioni supportate.

Esempio di caso d'uso in Application Integration

Gli esempi seguenti mostrano come utilizzare l'attività Connettori in Application Integration per eseguire operazioni utilizzando la connessione MCP configurata.

Esempio: Jira - Crea problema

Per creare un problema in Jira utilizzando una connessione MCP:

  1. Nella finestra di dialogo dell'attività Configura connettore , seleziona la connessione MCP Jira (ad es. jira-connection).
  2. Fai clic su Azioni.
  3. Seleziona l'azione create_issue.
  4. Fai clic su Fine.
  5. Nella sezione Input attività, trasmetti i seguenti argomenti: 
    {
  "fields": {
    "project": {
      "key": "YOUR_PROJECT_KEY"
    },
    "summary": "New issue created from Integration Connectors",
    "issuetype": {
      "name": "Task"
    },
    "description": "This is a test issue created via the MCP Jira connector."
  }
}

Creare connessioni utilizzando Terraform

Puoi utilizzare la risorsa Terraform per creare una nuova connessione.

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

Per visualizzare un template Terraform di esempio per la creazione di connessioni, consulta Template di esempio.

Quando crei questa connessione utilizzando Terraform, devi impostare le seguenti variabili nel file di configurazione Terraform:

Nome parametro Tipo di dati Obbligatorio Descrizione
proxy_enabled BOOLEANO Falso Imposta su true per configurare un server proxy per la connessione.
proxy_auth_scheme ENUM Falso Il tipo di autenticazione da utilizzare per l'autenticazione al proxy ProxyServer. I valori supportati sono: BASIC, DIGEST, NONE
proxy_user STRING Falso Un nome utente da utilizzare per l'autenticazione al proxy ProxyServer.
proxy_password SECRET Falso Una password da utilizzare per l'autenticazione al proxy ProxyServer.
proxy_ssltype ENUM Falso Il tipo di SSL da utilizzare per la connessione al proxy ProxyServer. I valori supportati sono: AUTO, ALWAYS, NEVER, TUNNEL