Un server Model Context Protocol (MCP) funge da proxy tra un servizio esterno che fornisce contesto, dati o funzionalità a un modello linguistico di grandi dimensioni (LLM) o a un'applicazione AI. I server MCP collegano le applicazioni di AI a sistemi esterni come database e servizi web, traducendo le loro risposte in un formato che l'applicazione di AI può comprendere.
Configurazione del server
Prima dell'uso, devi abilitare i server MCP e configurare l'autenticazione. Per saperne di più sull'utilizzo dei server MCP remoti di Google e Google Cloud, consulta la panoramica dei server MCP di Google Cloud.
Endpoint server
Un endpoint di servizio MCP è l'indirizzo di rete e l'interfaccia di comunicazione (di solito un URL) del server MCP che un'applicazione AI (l'host per il client MCP) utilizza per stabilire una connessione sicura e standardizzata. È il punto di contatto per l'LLM per richiedere il contesto, chiamare uno strumento o accedere a una risorsa. Gli endpoint Google MCP possono essere globali o regionali.
Il server MCP dell'API App Lifecycle Manager ha il seguente endpoint MCP:
- https://saasservicemgmt.googleapis.com/mcp
Strumenti MCP
Uno strumento MCP è una funzione o una funzionalità eseguibile che un server MCP espone a un LLM o a un'applicazione AI per eseguire un'azione nel mondo reale.
Il server MCP saasservicemgmt dispone dei seguenti strumenti:
| Strumenti MCP | |
|---|---|
| list_saas | Elenca le risorse SaaS. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_saas | Recupera una risorsa SaaS. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/saas/my-saas). |
| create_saas | Crea una risorsa SaaS. Parametri obbligatori: "parent" (ad es. projects/my-project/locations/us-central1), "saas_id", "saas". Parametri facoltativi: "validate_only", "request_id". |
| list_tenants | Elenca le risorse tenant. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_tenant | Recupera una risorsa Tenant. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/tenants/my-tenant). |
| create_tenant | Crea una risorsa Tenant. Parametri obbligatori: "parent" (ad es. projects/my-project/locations/us-central1), "tenant_id", "tenant". Parametri facoltativi: "validate_only", "request_id". |
| list_unit_kinds | Elenca le risorse UnitKind. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_unit_kind | Recupera una risorsa UnitKind. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/unitKinds/my-unitkind). |
| create_unit_kind | Crea una risorsa UnitKind. Parametri obbligatori: "parent" (ad es. projects/my-project/locations/us-central1), "unit_kind_id", "unit_kind". Parametri facoltativi: "validate_only", "request_id". |
| list_units | Elenca le risorse Unit. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_unit | Recupera una risorsa Unit. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/units/my-unit). |
| create_unit | Crea una risorsa Unit. Parametri obbligatori: "parent" (ad es. projects/my-project/locations/us-central1), "unit_id", "unit". Parametri facoltativi: "validate_only", "request_id". |
| list_unit_operations | Elenca le risorse UnitOperation. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_unit_operation | Recupera una risorsa UnitOperation. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/unitOperations/my-unitoperation). |
| list_releases | Elenca le risorse di rilascio. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_release | Recupera una risorsa Release. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/releases/my-release). |
| create_release | Crea una risorsa Release. Parametri obbligatori: "parent" (ad es. projects/my-project/locations/us-central1), "release_id", "release". Parametri facoltativi: "validate_only", "request_id". |
| list_rollouts | Elenca le risorse Rollout. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_rollout | Recupera una risorsa Rollout. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/rollouts/my-rollout). |
| list_rollout_kinds | Elenca le risorse RolloutKind. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_rollout_kind | Recupera una risorsa RolloutKind. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/rolloutKinds/my-rolloutkind). |
| create_rollout_kind | Crea una risorsa RolloutKind. Parametri obbligatori: "parent" (ad es. projects/my-project/locations/us-central1), "rollout_kind_id", "rollout_kind". Parametri facoltativi: "validate_only", "request_id". |
| list_maintenances | Elenca le risorse di manutenzione. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_maintenance | Recupera una risorsa Maintenance. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/maintenances/my-maintenance). |
| create_maintenance | Crea una risorsa di manutenzione. Parametri obbligatori: "parent" (ad es. projects/my-project/locations/us-central1), "maintenance_id", "maintenance". Parametri facoltativi: "validate_only", "request_id". |
| list_resource_maintenances | Elenca le risorse ResourceMaintenance. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_resource_maintenance | Recupera una risorsa ResourceMaintenance. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/resourceMaintenances/my-resourcemaintenance). |
| list_flags | Elenca le risorse Flag. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_flag | Recupera una risorsa Flag. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/flags/my-flag). |
| create_flag | Crea una risorsa Flag. Parametri obbligatori: "parent" (ad es. projects/my-project/locations/us-central1), "flag_id", "flag". Parametri facoltativi: "validate_only", "request_id". |
| list_flag_revisions | Elenca le risorse FlagRevision. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_flag_revision | Recupera una risorsa FlagRevision. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/flagRevisions/my-flagrevision). |
| create_flag_revision | Crea una risorsa FlagRevision. Parametri obbligatori: "parent" (ad es. projects/my-project/locations/us-central1), "flag_revision_id", "flag_revision". Parametri facoltativi: "validate_only", "request_id". |
| list_flag_releases | Elenca le risorse FlagRelease. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_flag_release | Recupera una risorsa FlagRelease. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/flagReleases/my-flagrelease). |
| create_flag_release | Crea una risorsa FlagRelease. Parametri obbligatori: "parent" (ad es. projects/my-project/locations/us-central1), "flag_release_id", "flag_release". Parametri facoltativi: "validate_only", "request_id". |
| list_flag_attributes | Elenca le risorse FlagAttribute. Parametro obbligatorio: "parent" (ad es. projects/my-project/locations/us-central1). Parametri facoltativi: "page_size", "page_token", "filter", "order_by". |
| get_flag_attribute | Recupera una risorsa FlagAttribute. Parametro obbligatorio: "name" (ad es. projects/my-project/locations/us-central1/flagAttributes/my-flagattribute). |
| create_flag_attribute | Crea una risorsa FlagAttribute. Parametri obbligatori: "parent" (ad es. projects/my-project/locations/us-central1), "flag_attribute_id", "flag_attribute". Parametri facoltativi: "validate_only", "request_id". |
Ottenere le specifiche dello strumento MCP
Per ottenere le specifiche dello strumento MCP per tutti gli strumenti di un server MCP, utilizza il metodo tools/list. L'esempio seguente mostra come utilizzare curl per elencare tutti gli strumenti e le relative specifiche attualmente disponibili nel server MCP.
| Curl Request |
|---|
curl --location 'https://saasservicemgmt.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |