O cliente Java do Google para MCP Toolbox for Databases chegou à versão 1.0.0 em 9 de setembro. Em um anúnciode 6 de outubro, a empresa detalhou mudanças de transporte, autenticação e parâmetros das ferramentas para equipes que conectam aplicativos Java a um servidor Toolbox executado separadamente. O registro da versão diz que o código foi lançado quase um mês antes daquele anúncio.

Essa diferença importa para uma equipe Java que decide se deve adotar o cliente agora. O Google chama a versão 1.0 de base estável e compatível com versões anteriores, mas o mesmo registro lista uma mudança incompatível: parâmetros vinculados são removidos da definição da ferramenta exposta a um agente. As integrações existentes devem verificar como usam essas definições antes de atualizar. O repositório também diz que o suporte a recursos Java continua em andamento e não alcança o nível dos SDKs Python, JavaScript/TypeScript e Go.

A principal mudança

O cliente 1.0 oferece a um aplicativo Java uma forma definida de descobrir e invocar ferramentas expostas pelo MCP Toolbox. O novo HttpMcpTransport fica por trás de uma interface de transporte, enquanto CredentialsProvider e AuthMethods separam a resolução das credenciais do cliente. Segundo o Google, as credenciais são resolvidas de forma assíncrona a cada solicitação. A versão também adiciona valores padrão para parâmetros, alertas HTTP sobre exposição de credenciais, seleção de versão, acompanhamento de sessões e um mapa para cabeçalhos personalizados de solicitação. São recursos documentados do SDK, não testes de desempenho ou segurança do BIG CHANGE.

O Toolbox em si é um servidor separado. Um operador o configura com fontes de dados e ferramentas; o cliente Java se conecta à URL, carrega definições de ferramentas e envia chamadas. Uma dependência Java, por si só, não configura um banco de dados, concede permissões nem implanta esse servidor. A documentação oficial de Java 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 equipe Java pode avaliar

O processo a seguir se baseia na documentação e no repositório do Google. O BIG CHANGE não executou o código nem se conectou a um banco de dados.

  1. Prepare um servidor Toolbox e uma fonte de dados separados. A documentação de introdução do Google cobre o servidor, as definições das ferramentas e as integrações compatíveis. Para a primeira avaliação, escolha uma ferramenta de banco de dados restrita e somente leitura e revise os controles de acesso do servidor. O repositório do SDK lista Java 17 ou mais recente como ambiente básico de execução.
  2. Fixe a versão da dependência Java. O anúncio da versão 1.0 e o repositório mostram as 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 geral de Java ainda usa um VERSION marcador, por isso o artefato da versão é a referência exata para esta avaliação.
  3. Conecte-se ao servidor e inspecione uma ferramenta. Aponte McpToolboxClient para a URL do servidor em execução /mcp e use loadToolset, listTools ou loadTool para inspecionar as definições publicadas antes de invocar uma ferramenta. O repositório demonstra uma chamada com Java Map e um resultado de texto retornado. 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 deliberadamente. O anúncio da versão 1.0 descreve CredentialsProvider e AuthMethods para credenciais do cliente, incluindo um caminho do Google Application Default Credentials para OIDC. Também descreve alertas HTTP quando as credenciais seriam transmitidas em texto simples. Um alerta não substitui um endpoint HTTPS nem a autorização no servidor. Valores vinculados de parâmetros sensíveis devem ser revistos nos limites do servidor e do cliente, especialmente ao atualizar de uma versão prévia.

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

Limites e custos

O aplicativo de transporte de exemplo do Google mostra Spring Boot e LangChain4j chamando ferramentas Toolbox apoiadas pelo AlloyDB. O artigo de outubro diz que Cymbal Transit é fictícia. Ele demonstra um desenho de integração, não uso medido por clientes nem um resultado de confiabilidade.

O repositório do Java SDK tem uma licença Apache 2.0. Isso não define o preço de banco de dados, implantação em nuvem, chamadas de modelo ou tráfego de rede; as equipes precisam estimar os serviços que realmente escolherem. O repositório marca o uso do GraalVM native-image como experimental e alerta que o suporte a recursos do Java SDK é incompleto em comparação com os outros clientes Toolbox. Confira esses limites com o framework e a fonte de dados exatos antes de considerar comprovada para um sistema de produção a afirmação do Google sobre adequação empresarial.

Fontes e leituras adicionais