O cliente Java da Google para MCP Toolbox for Databases chegou à versão 1.0.0 a 9 de setembro. Num anúnciode 6 de outubro, a empresa detalhou alterações ao transporte, à autenticação e aos parâmetros das ferramentas para equipas que ligam aplicações Java a um servidor Toolbox executado separadamente. O registo de lançamento data a publicação do código quase um mês antes desse anúncio.

A distinção é importante para uma equipa Java que esteja a decidir se adota já o cliente. A Google descreve a versão 1.0 como uma base estável e compatível com versões anteriores, mas o mesmo registo assinala uma alteração incompatível: os parâmetros vinculados são removidos da definição da ferramenta apresentada a um agente. As integrações existentes devem verificar como usam essas definições antes de atualizar. O repositório também indica que o suporte de funcionalidades Java continua em desenvolvimento e não iguala o dos SDK de Python, JavaScript/TypeScript e Go.

A principal mudança

O cliente 1.0 proporciona a uma aplicação Java uma forma definida de descobrir e invocar ferramentas expostas pelo MCP Toolbox. O novo HttpMcpTransport fica atrás de uma interface de transporte, enquanto CredentialsProvider e AuthMethods separam a resolução de credenciais do cliente. A Google afirma que as credenciais são resolvidas de forma assíncrona em cada pedido. O lançamento acrescenta ainda valores predefinidos para parâmetros, avisos HTTP sobre exposição de credenciais, seleção de versões, acompanhamento de sessões e um mapa para cabeçalhos de pedidos personalizados. São funcionalidades documentadas do SDK, não testes de desempenho ou segurança da BIG CHANGE.

O Toolbox é, por si só, um servidor separado. Um operador configura-o com fontes de dados e ferramentas; o cliente Java liga-se ao respetivo URL, carrega definições de ferramentas e envia invocações. Uma dependência Java, por si só, não configura uma base de dados, concede permissões nem implementa esse servidor. A documentação Java oficial descreve os papéis do cliente e do servidor, e o repositório do SDK exige que o servidor esteja em execução antes da configuração do cliente.

O que uma equipa Java pode avaliar

O processo seguinte baseia-se na documentação e no repositório da Google. A BIG CHANGE não executou o código nem ligou uma base de dados.

  1. Prepare um servidor Toolbox e uma fonte de dados separados. A documentação de introdução da Google abrange o servidor, as definições das ferramentas e as integrações suportadas. Para a primeira avaliação, escolha uma ferramenta de base de dados restrita e só de leitura e reveja os controlos de acesso do servidor. O repositório do SDK indica Java 17 ou posterior como ambiente de execução de base.
  2. Fixe a versão da dependência Java. O anúncio do lançamento 1.0 e o repositório apresentam ambos coordenadas Maven com.google.cloud.mcp:mcp-toolbox-sdk-java:1.0.0; o repositório também fornece a forma Gradle. A documentação Java geral continua a usar um VERSION marcador, pelo que o artefacto de lançamento é a referência precisa para esta avaliação.
  3. Ligue-se ao servidor e inspecione uma ferramenta. Aponte McpToolboxClient para o URL do servidor em execução /mcp e, em seguida, use loadToolset, listTools ou loadTool para inspecionar as definições publicadas antes de invocar uma ferramenta. O repositório demonstra uma invocação com Java Map e um resultado de texto devolvido. Uma verificação bem-sucedida é uma resposta de uma ferramenta identificada e configurada, não apenas a criação de um objeto cliente sem erro.
  4. Escolha a autenticação de forma deliberada. O anúncio da versão 1.0 descreve CredentialsProvider e AuthMethods para credenciais do cliente, incluindo um percurso Google Application Default Credentials para OIDC. Também descreve avisos HTTP quando as credenciais seriam transmitidas em texto simples. Um aviso não substitui um ponto final HTTPS nem a autorização do lado do servidor. Os valores vinculados de parâmetros sensíveis devem ser revistos nos limites do servidor e do cliente, sobretudo ao atualizar a partir de uma versão preliminar.

O resultado a procurar é uma definição e uma resposta de ferramenta que correspondam às permissões da base de dados previstas para o agente. Se a descoberta falhar, confirme primeiro o URL do servidor, o nome da ferramenta disponível e a configuração da autenticação. Se a invocação falhar, compare os parâmetros exigidos pela ferramenta com os valores enviados e consulte os registos do servidor. São verificações de diagnóstico baseadas na separação documentada dos componentes, não uma afirmação de que qualquer implementação específica recuperará automaticamente.

Limites e custos

A aplicação de transporte de demonstração da Google mostra o Spring Boot e o LangChain4j a invocar ferramentas Toolbox suportadas pelo AlloyDB. O artigo de outubro chama fictícia à Cymbal Transit. Demonstra um desenho de integração, não uma utilização medida por clientes nem um resultado de fiabilidade.

O repositório do Java SDK está sujeito a uma licença Apache 2.0. Isso não fixa o preço de uma base de dados, implementação na nuvem, chamadas a modelos ou tráfego de rede; as equipas têm de calcular os serviços que escolherem efetivamente. O repositório assinala como experimental a utilização do GraalVM native-image e alerta que o suporte de funcionalidades do Java SDK é incompleto face aos outros clientes Toolbox. Compare esses limites com a estrutura de trabalho e a fonte de dados exatas antes de considerar verificada para um sistema de produção a afirmação da Google sobre a adequação empresarial.

Fontes e leituras adicionais