MCP Reference: saasservicemgmt

Um servidor do Protocolo de Contexto de Modelo (MCP) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos a um modelo de linguagem grande (LLM) ou aplicativo de IA. Os servidores MCP conectam aplicativos de IA a sistemas externos, como bancos de dados e serviços da Web, traduzindo as respostas em um formato que o aplicativo de IA possa entender.

Configuração do servidor

É preciso ativar os servidores MCP e configurar a autenticação antes de usar. Para mais informações sobre como usar servidores remotos do MCP do Google e do Google Cloud, consulte Visão geral dos servidores do MCP no Google Cloud.

Endpoints de servidor

Um endpoint de serviço do MCP é o endereço de rede e a interface de comunicação (geralmente um URL) do servidor do MCP que um aplicativo de IA (o host do cliente do MCP) usa para estabelecer uma conexão segura e padronizada. É o ponto de contato para o LLM solicitar contexto, chamar uma ferramenta ou acessar um recurso. Os endpoints do Google MCP podem ser globais ou regionais.

O servidor MCP da API App Lifecycle Manager tem o seguinte endpoint MCP:

  • https://saasservicemgmt.googleapis.com/mcp

Ferramentas do MCP

Uma ferramenta do MCP é uma função ou capacidade executável que um servidor do MCP expõe a um LLM ou aplicativo de IA para realizar uma ação no mundo real.

O servidor MCP saasservicemgmt tem as seguintes ferramentas:

Ferramentas do MCP
list_saas Lista recursos do SaaS. Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_saas Recebe um recurso do SaaS. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/saas/my-saas).
create_saas Cria um recurso Saas. Parâmetros obrigatórios: "parent" (por exemplo, projects/my-project/locations/us-central1), "saas_id" e "saas". Parâmetros opcionais: "validate_only", "request_id".
list_tenants Lista os recursos do locatário. Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_tenant Recebe um recurso de locatário. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/tenants/my-tenant).
create_tenant Cria um recurso "Tenant". Parâmetros obrigatórios: "parent" (por exemplo, projects/my-project/locations/us-central1), "tenant_id" e "tenant". Parâmetros opcionais: "validate_only", "request_id".
list_unit_kinds Lista recursos UnitKind. Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_unit_kind Recebe um recurso UnitKind. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/unitKinds/my-unitkind).
create_unit_kind Cria um recurso UnitKind. Parâmetros obrigatórios: "parent" (por exemplo, projects/my-project/locations/us-central1), "unit_kind_id", "unit_kind". Parâmetros opcionais: "validate_only", "request_id".
list_units Lista recursos de unidade. Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_unit Recebe um recurso de unidade. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/units/my-unit).
create_unit Cria um recurso de unidade. Parâmetros obrigatórios: "parent" (por exemplo, projects/my-project/locations/us-central1), "unit_id", "unit". Parâmetros opcionais: "validate_only", "request_id".
list_unit_operations Lista os recursos UnitOperation. Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_unit_operation Recebe um recurso UnitOperation. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/unitOperations/my-unitoperation).
list_releases Lista recursos de lançamento. Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_release Recebe um recurso Release. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/releases/my-release).
create_release Cria um recurso "Release". Parâmetros obrigatórios: "parent" (por exemplo, projects/my-project/locations/us-central1), "release_id", "release". Parâmetros opcionais: "validate_only", "request_id".
list_rollouts Lista recursos de lançamento. Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_rollout Recebe um recurso de lançamento. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/rollouts/my-rollout).
list_rollout_kinds Lista recursos RolloutKind. Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_rollout_kind Recebe um recurso RolloutKind. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/rolloutKinds/my-rolloutkind).
create_rollout_kind Cria um recurso RolloutKind. Parâmetros obrigatórios: "parent" (por exemplo, projects/my-project/locations/us-central1), "rollout_kind_id" e "rollout_kind". Parâmetros opcionais: "validate_only", "request_id".
list_maintenances Lista recursos de manutenção. Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_maintenance Recebe um recurso de manutenção. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/maintenances/my-maintenance).
create_maintenance Cria um recurso de manutenção. Parâmetros obrigatórios: "parent" (por exemplo, projects/my-project/locations/us-central1), "maintenance_id" e "maintenance". Parâmetros opcionais: "validate_only", "request_id".
list_resource_maintenances Lista recursos ResourceMaintenance. Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_resource_maintenance Recebe um recurso ResourceMaintenance. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/resourceMaintenances/my-resourcemaintenance).
list_flags Lista recursos de flag. Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_flag Recebe um recurso de flag. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/flags/my-flag).
create_flag Cria um recurso de flag. Parâmetros obrigatórios: "parent" (por exemplo, projects/my-project/locations/us-central1), "flag_id" e "flag". Parâmetros opcionais: "validate_only", "request_id".
list_flag_revisions Lista recursos "FlagRevision". Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_flag_revision Recebe um recurso FlagRevision. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/flagRevisions/my-flagrevision).
create_flag_revision Cria um recurso FlagRevision. Parâmetros obrigatórios: "parent" (por exemplo, projects/my-project/locations/us-central1), "flag_revision_id" e "flag_revision". Parâmetros opcionais: "validate_only", "request_id".
list_flag_releases Lista recursos FlagRelease. Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_flag_release Recebe um recurso FlagRelease. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/flagReleases/my-flagrelease).
create_flag_release Cria um recurso FlagRelease. Parâmetros obrigatórios: "parent" (por exemplo, projects/my-project/locations/us-central1), "flag_release_id", "flag_release". Parâmetros opcionais: "validate_only", "request_id".
list_flag_attributes Lista recursos "FlagAttribute". Parâmetro obrigatório: "parent" (por exemplo, projects/my-project/locations/us-central1). Parâmetros opcionais: "page_size", "page_token", "filter", "order_by".
get_flag_attribute Recebe um recurso FlagAttribute. Parâmetro obrigatório: "name" (por exemplo, projects/my-project/locations/us-central1/flagAttributes/my-flagattribute).
create_flag_attribute Cria um recurso FlagAttribute. Parâmetros obrigatórios: "parent" (por exemplo, projects/my-project/locations/us-central1), "flag_attribute_id", "flag_attribute". Parâmetros opcionais: "validate_only", "request_id".

Receber especificações da ferramenta MCP

Para receber as especificações de ferramentas do MCP de todas as ferramentas em um servidor MCP, use o método tools/list. O exemplo a seguir demonstra como usar curl para listar todas as ferramentas e especificações disponíveis no servidor MCP.

Solicitação curl
                      
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
}'