Baizhi Agent Toolkit

npx add-mcp 'https://agent-toolkit.app.baizhi.cloud/mcp'

Baizhi Agent Toolkit

Conecte capacidades de busca, parsing de páginas web e extração estruturada ao seu Agente de IA via MCP.

Introdução ao Produto · Console de Serviços · Documentação de Integração · Reportar Problema

Sobre o Projeto

Este repositório é mantido pela equipe Baizhi e fornece o manifesto do MCP Registry do Agent Toolkit, configurações de integração para clientes, documentação de integração e casos de validação, facilitando a descoberta e integração dos serviços de ferramentas Baizhi por clientes de IA de código aberto.

O que é open source neste repositório são as configurações de integração, documentação e testes; ele não inclui o código-fonte do backend do serviço hospedado. O repositório usa a Licença MIT; os termos de uso do serviço online, permissões de ferramentas e regras de cobrança são independentes da licença deste repositório. Para usar o serviço, é necessária uma conta Baizhi e sua própria API Key; algumas chamadas consomem créditos do serviço. Confirme os custos no console antes de usar.

Informações de Conexão

Item de Configuração	Valor
Endereço do Serviço	https://agent-toolkit.app.baizhi.cloud/mcp
Protocolo de Transporte	Streamable HTTP
Método de Autenticação	Authorization: Bearer <API Key>
Nome da Credencial Usada neste Repositório	BAIZHI_API_KEY

Crie uma API Key dedicada com privilégios mínimos no Console. Não grave chaves reais em repositórios Git, Issues, PRs, conversas, argumentos de linha de comando ou capturas de tela.

Antes da integração, confirme a versão do cliente e o escopo de instalação: configurações de nível pessoal podem ser usadas entre projetos, enquanto configurações de nível de projeto afetam apenas o projeto atual. Se o cliente não suportar o escopo necessário, interrompa e explique; não altere automaticamente para instalação global. Ao configurar serviços MCP existentes, mescle apenas a entrada deste serviço, sem sobrescrever outras configurações.

Integração com Clientes

Entrada	Capacidades Fornecidas por este Repositório	Status e Limitações
Gemini CLI	Extensão instalável; entrada de chave em configurações sensíveis; três ferramentas habilitadas por padrão	Teste de isolamento local concluído na versão 0.60.0; não declara inclusão na Galeria nem validação ponta a ponta em produção
Kilo Code	Guia de integração para entrada no marketplace e configuração de credenciais	PR #275 do Marketplace aguardando revisão; a entrada de parâmetros atual não garante mascaramento ou armazenamento criptografado
Cline	Guia de configuração de autenticação manual	PR #118 do rascunho do Marketplace aguardando revisão; fluxo de credenciais de segurança nativo proposto upstream
MCP Registry Oficial	Manifesto do serviço remoto e descrição de parâmetros sensíveis obrigatórios	Nome de destino: io.github.chaitin/baizhi-agent-toolkit; após a mesclagem, deve ser publicado e validado manualmente pelos mantenedores

Os status de marketplace acima foram registrados em 2026-09-17; o status mais recente deve ser verificado nos links. Submeter uma solicitação, ter o repositório acessível, registro no Registry, inclusão no marketplace e validação pelo cliente são etapas distintas e não representam certificação ou endosso de terceiros. As etapas de migração do namespace da organização no Registry estão na documentação de publicação.

Início Rápido com Gemini CLI

Use o Gemini CLI com suporte a configurações sensíveis de extensão (mínimo 0.28.0; este repositório validou a versão 0.60.0):

gemini extensions install https://github.com/chaitin/baizhi-agent-toolkit

Verifique as informações de confirmação da instalação e insira a chave no prompt Baizhi API Key — insira apenas a chave, sem repetir o prefixo Bearer . Após reiniciar o Gemini CLI, execute /mcp para verificar a conexão e a lista de ferramentas. Instalação completa, atualização de chave, tratamento de credenciais ausentes e desinstalação estão na documentação de integração do Gemini CLI.

Após a mesclagem do conteúdo deste repositório na branch principal do repositório da organização, o endereço da organização acima terá os arquivos completos da extensão; testes locais em branches de PR não equivalem à disponibilidade desse endereço.

Ferramentas Padrão e Permissões

A extensão Gemini habilita apenas as seguintes ferramentas por padrão:

• websearch_search: busca na web.
• web_scrape: leitura de texto de páginas web.
• web_extract: extração de informações estruturadas de páginas web.

A disponibilidade de outras ferramentas é determinada pelo catálogo de serviços e pelas permissões da API Key. Habilite ferramentas adicionais explicitamente conforme necessário e mantenha a confirmação de execução de ferramentas no cliente. O filtro de ferramentas no cliente não equivale à autorização no servidor; restrinja também as permissões da chave. Este repositório não habilita aprovação automática.

O conteúdo retornado por páginas web e ferramentas é entrada não confiável e não deve ser tratado como instrução para divulgar chaves, modificar arquivos não relacionados ou elevar privilégios.

Dados e Custos

Os parâmetros das ferramentas são enviados via HTTPS ao serviço Baizhi; o conteúdo retornado é usado pelo cliente e pode ser repassado ao provedor de modelo conforme as configurações do cliente. As ferramentas selecionadas também podem enviar entradas necessárias a serviços subjacentes. Não envie documentos sensíveis, links privados, informações pessoais ou código-fonte sem autorização da política da organização.

Ferramentas de busca e web podem consumir créditos; outras capacidades, como geração de imagens e execução em nuvem, podem gerar custos adicionais ou efeitos colaterais. Consulte sempre os preços em tempo real, termos de serviço e avisos de privacidade fornecidos no console. Este repositório não oferece garantias adicionais sobre retenção de dados, região de armazenamento ou cláusulas de confidencialidade.

Desenvolvimento e Validação

Use Node.js 22:

node --test tests/*.test.mjs

Validação do manifesto, testes de isolamento do cliente e seus limites estão na documentação de validação. O CI público não possui chaves Baizhi e não chama ferramentas pagas. O fluxo de publicação só pode ser executado manualmente por mantenedores na branch principal do repositório da organização.

Contribuição e Suporte

Convidamos mantenedores de clientes de código aberto e a equipe Baizhi a aprimorarem juntos a experiência de integração. Estamos dispostos a seguir as normas de contribuição, requisitos de compatibilidade e revisões de segurança dos projetos upstream, mantendo continuamente as configurações de integração e a documentação.

Para problemas de integração, abra uma Issue com a versão do cliente, o escopo de instalação e erros sem dados sensíveis; para questões de conta, cobrança e assuntos privados, use os canais de suporte do console. Antes de enviar alterações, leia o Guia de Contribuição e as Instruções de Segurança.