AI-translated from English; not yet reviewed by a fluent editor.
# Google explica o MCP Toolbox Java SDK 1.0 para agentes de bases de dados
> A Google detalhou em outubro o seu MCP Toolbox Java SDK 1.0, depois de o código ter sido lançado em setembro. O cliente acrescenta interfaces de transporte e autenticação, enquanto o registo da versão assinala uma alteração incompatível e o repositório alerta para uma paridade de funcionalidades incompleta.
By BIG CHANGE Editorial
Published: 2026-10-12T18:00:12.162Z
Updated: 2026-10-12T18:00:12.162Z
Canonical: https://bigchange.ai/blog/google-mcp-toolbox-java-sdk-v1-stable-interfaces
AI-generated conceptual illustration by BIG CHANGE. No MCP Toolbox product interface, database transaction or tested integration is depicted.
O cliente Java da Google para MCP Toolbox for Databases chegou à versão 1.0.0 a 9 de setembro. Num [anúncio](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/)de 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](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) 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](https://github.com/googleapis/mcp-toolbox-sdk-java) 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](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) descreve os papéis do cliente e do servidor, e o [repositório do SDK](https://github.com/googleapis/mcp-toolbox-sdk-java) 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](https://mcp-toolbox.dev/documentation/introduction/) 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](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/) e o [repositório](https://github.com/googleapis/mcp-toolbox-sdk-java) 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](https://github.com/googleapis/mcp-toolbox-sdk-java/tree/main/demo-applications/cymbal-transit) 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](https://github.com/googleapis/mcp-toolbox-sdk-java/blob/main/LICENSE). 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
- [Anúncio da Google Cloud, 6 de outubro de 2026](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/): descrição da Google das funcionalidades da v1.0 e do seu exemplo fictício de transportes. A linguagem sobre adequação à produção é uma afirmação do fornecedor.
- [Lançamento do Java SDK v1.0.0, 9 de setembro de 2026](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0): data de lançamento, funcionalidades e alteração incompatível indicada.
- [Repositório do Java SDK](https://github.com/googleapis/mcp-toolbox-sdk-java): coordenadas de dependências, requisito de Java, chamadas do cliente, licença e aviso atual sobre paridade de funcionalidades. Consultado em 12 de outubro de 2026.
- [Documentação oficial do Java SDK](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/): pré-requisito do servidor e referência de instalação. A página foi modificada pela última vez em 25 de setembro de 2026; o marcador de versão é menos preciso do que o registo do lançamento 1.0.
## Sources
- [Google Cloud Blog: anúncio do MCP Toolbox Java SDK v1.0](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/) — Anúncio posterior e explicação do lançamento de 9 de setembro. A adequação à produção é uma afirmação da Google, não validada de forma independente.
- [Lançamento do MCP Toolbox Java SDK v1.0.0](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) — Data oficial de lançamento do código e funcionalidades, incluindo a alteração incompatível indicada.
- [Google APIs: repositório de código-fonte do MCP Toolbox Java SDK](https://github.com/googleapis/mcp-toolbox-sdk-java) — Fonte oficial de implementação; confirme as etiquetas de lançamento e APIs atuais face à v1.0.0 antes de utilizar exemplos de código.
- [Documentação oficial do MCP Toolbox Java SDK](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) — A referência geral oficial de configuração ainda contém o marcador VERSION; o lançamento 1.0 fixado e o repositório são mais precisos.
Newsletter BIG CHANGE
A perspetiva geral, ao seu ritmo.
Histórias recentes sobre IA e robótica, mudanças que vale a pena acompanhar e ideias práticas para utilizar. Escolha um briefing diário, um resumo semanal ou uma perspetiva mensal.
Próximo envio agendado (UTC): . A sua primeira edição chegará no próximo envio agendado após a confirmação.
A sua privacidade, a sua escolha.
O armazenamento necessário ajuda a proteger o site e a memorizar as suas escolhas. O Google Analytics opcional permanece desativado até que o autorize. Pode ler todos os artigos utilizando apenas o armazenamento necessário. Detalhes de privacidade