Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

Connettore MCP

Il connettore Model Context Protocol (MCP) ti consente di creare e configurare una connessione MCP in Integration Connectors. Puoi utilizzare questa connessione nelle tue applicazioni aziendali per scambiare dati in modo sicuro ed eseguire operazioni con MCP.

Per l'elenco delle entità e delle operazioni supportate, consulta Esempi di operazioni sulle entità. Per informazioni sulle azioni specifiche del connettore supportate, vedi Azioni.

Tutte le connessioni in Integration Connectors forniscono un livello di astrazione per gli oggetti di servizio sottostanti. Questi oggetti vengono esposti come entità gestibili, consentendoti di eseguire operazioni standard o utilizzare azioni specifiche del connettore.

Versioni del connettore MCP

Il connettore MCP supporta due versioni:

• MCP v1: utilizza questa versione del connettore per accedere all'API MCP v1.
• MCP v2: utilizza questa versione del connettore per accedere all'API MCP v2.

Per informazioni sulla creazione di una connessione MCP, consulta Crea e configura un connettore MCP.

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

Nota:puoi visualizzare le entità, le operazioni e le azioni di un connettore nell'attività Connettori.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione avrà alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Nota: tutte le entità e le azioni avranno uno schema associato. Ad esempio, uno schema di azione avrà i dettagli dei parametri, come i nomi dei parametri e il tipo di dati corrispondente. Lo schema (metadati) per entità e azioni viene recuperato dalla connessione in fase di runtime dal backend. Se vengono apportati aggiornamenti allo schema, questi non verranno riflessi automaticamente nelle connessioni esistenti. Devi aggiornare manualmente lo schema. Per aggiornare lo schema di una connessione, apri la pagina Dettagli connessione della connessione, quindi fai clic su Aggiorna schema connessione.

Entità e operazioni supportate

Il connettore MCP supporta entità e operazioni, con quelle specifiche disponibili a seconda dello strumento connesso tramite MCP.

Esempi di operazioni sulle entità

Questa sezione fornisce esempi di operazioni sulle entità per diversi strumenti.

Elenco entità Problemi Jira

Questo esempio elenca tutti i problemi nell'entità Problemi utilizzando una connessione Jira MCP.

1. Nella finestra Configura attività connettore, fai clic su Entità.
2. Seleziona Problemi dall'elenco Entità.
3. Seleziona l'operazione Elenco, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Valore predefinito:

   {
         "operation": "LIST_ENTITIES",
         "connection_name": "projects/YOUR_PROJECT_ID/locations/YOUR_LOCATION/connections/YOUR_JIRA_CONNECTION_NAME",
         "service_name": "projects/YOUR_TENANT_PROJECT_ID/locations/YOUR_LOCATION/namespaces/cloudrun/services/YOUR_RUNTIME_SERVICE",
         "host": "https://YOUR_TENANT_PROJECT_ID-YOUR_LOCATION.us-west1-runtime-connectors-google.com",
         "entity": "Issues",
         "entity_id": "Issues",
         "page_token": ""
       }

Elenca tutte le richieste

Questo esempio elenca tutte le richieste nell'entità Richieste.

1. Nella finestra Configura attività connettore, fai clic su Entità.
2. Seleziona Richieste dall'elenco Entità.
3. Seleziona l'operazione Elenco e poi fai clic su Fine.

Ottieni un utente per ID

Questo esempio recupera l'utente con AccountId come `6035864ce2020c0070b5285b` dall'entità Users. `AccountId` è la chiave primaria per l'entità Users. Per ottenere un'entità specifica, utilizza l'operazione List con un filterClause sulla chiave primaria, poiché l'operazione Get non è supportata per questa entità.

1. Nella finestra Configura attività connettore, fai clic su Entità.
2. Seleziona Utenti dall'elenco Entità.
3. Seleziona l'operazione Elenco e poi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su filterClause e poi inserisci `AccountId`=6035864ce2020c0070b5285b nel campo Valore predefinito.

Azioni

Il connettore MCP fornisce varie azioni, con quelle specifiche disponibili a seconda dello strumento connesso tramite MCP.

Esempi di azioni

Questa sezione descrive come eseguire alcune delle azioni disponibili tramite il connettore MCP per diversi strumenti.

Azioni Jira: recupera problemi

Questo esempio mostra come elencare i problemi Jira utilizzando una connessione MCP configurata per Jira.

1. Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
2. Seleziona l'azione get_issues, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Valore predefinito:

     {
       "issue_ids": ["YOUR_ISSUE_ID_1", "YOUR_ISSUE_ID_2"]
     }

Linear actions: List issues

Questo esempio mostra come elencare i problemi in Linear utilizzando una connessione MCP configurata per Linear.

1. Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
2. Seleziona l'azione list_issues, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Valore predefinito:

     {
       "limit": 50
     }

Sentry Actions: Whoami

Questo esempio mostra come ottenere le informazioni utente da Sentry utilizzando una connessione MCP configurata per Sentry.

1. Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
2. Seleziona l'azione whoami, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Valore predefinito:

     {
       "name": "example-org"
     }

Trovare organizzazioni

Questo esempio mostra come trovare le organizzazioni in Sentry utilizzando una connessione MCP configurata per Sentry.

1. Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
2. Seleziona l'azione find_organizations, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Valore predefinito:

     {}

Azioni di Intercom: cerca conversazioni

Questo esempio mostra come cercare i dettagli della conversazione in Intercom utilizzando una connessione MCP configurata per Intercom.

1. Nella finestra di dialogo Configura attività connettore, fai clic su Azioni.
2. Seleziona l'azione Cerca e poi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Valore predefinito:

     {
       "query": "object_type:conversations state:open created_at:gt:2024-01-01"
     }

Limitazioni di sistema

Il connettore MCP presenta limitazioni di sistema che possono variare in base allo strumento specifico collegato. Per impostazione predefinita, Integration Connectors alloca due nodi (per una migliore disponibilità) per una connessione.

Per informazioni sui limiti applicabili a Integration Connectors, consulta Limiti.

Nota:il numero di nodi di Integration Connectors verrà scalato automaticamente in modo dinamico in base al tuo utilizzo. Tuttavia, se vuoi riservare capacità per volumi elevati senza attendere la scalabilità automatica, puoi modificare il valore minimo dei nodi per una connessione. Sono necessari più nodi per elaborare più transazioni per una connessione. Al contrario, sono necessari meno nodi se una connessione elabora meno transazioni. Per configurare i valori del nodo, procedi nel seguente modo:

• Se sei un cliente con pagamento a consumo, configura il valore minimo e massimo dei nodi nella pagina di modifica della connessione.
• Se sei un cliente con abbonamento, contatta l'assistenza.

Il numero massimo di transazioni che un nodo può gestire dipende da vari fattori. Pertanto, prima di modificare i nodi minimi per migliorare il throughput, ti consigliamo di verificare che i sistemi di backend siano configurati in modo ottimale per gestire il traffico richiesto.