Vectara MCP: ligar agentes ao Trusted RAG

Para quem

Se você quer ligar um app de agente ao Trusted RAG da Vectara—rápido, estável e com menos alucinações por recuperação aumentada—este serviço combina. O texto oficial descreve essa capacidade pelo protocolo MCP.

Combina com quem já consegue instalar com pip e tem uma chave de API Vectara. O início padrão é transporte HTTP autenticado. Sem chave, a ferramenta de configuração de sessão não passa na validação.

Na primeira vez, só valide a chave. Não trate como funções conhecidas ferramentas de consulta que não foram nomeadas. A recuperação ainda sai para a rede e também envia sua pergunta à Vectara.

Concluir a primeira tentativa em 3 minutos

O caminho oficial recomendado é instalar pelo PyPI e iniciar com o transporte HTTP seguro padrão. Pré-requisito: você já tem uma chave de API Vectara.

Instalação:

pip install vectara-mcp

Defina a variável de ambiente VECTARA_API_KEY com a chave real emitida pelo console. Os valores de exemplo oficiais são placeholders; não os copie. Depois inicie:

python -m vectara_mcp

O texto oficial diz que o serviço, por padrão, roda em:

http://127.0.0.1:8000

e a autenticação já está ligada. Aponte o cliente MCP para esse serviço HTTP. O texto oficial não escreve os campos de cabeçalho completos a preencher no cliente; não os invente. Conecte como o cliente conecta MCP HTTP autenticado.

Depois faça uma chamada: chame setup_vectara_api_key. O texto oficial diz que configura e valida a chave de API Vectara da sessão; é um ajuste único. Campos de parâmetros não estão escritos; preencha a chave real conforme a definição que o cliente mostra e não escreva strings de exemplo.

Sinal de sucesso: a validação passa e a sessão pode usar essa chave. Se falhar, primeiro confira se a variável de ambiente e o argumento da ferramenta são a chave real.

Não acrescente --stdio. Na primeira vez, fique só no HTTP padrão.

Casos de uso

Caso 1: validar a chave na sessão. Chame setup_vectara_api_key. A nota oficial é Configure and validate your Vectara API key for the session. Não escreve o formato da chave nem se sobrescreve a variável de ambiente. Em sucesso você deve ver a validação passar. Não trate como ferramenta que consulta um corpus.

Caso 2: após validar, uma consulta Trusted RAG. O texto oficial diz que este servidor dá Trusted RAG a apps de agente. Esta página só nomeia a ferramenta de ajuste acima e não escreve nome de função de consulta; abra as ferramentas que este servidor mostra no cliente e escolha o item descrito como recuperação ou perguntas e respostas. Não invente nomes de função que não apareceram. Em sucesso você deve ver resultados de recuperação da Vectara. Consultas saem e também podem expor o texto da sua pergunta.

Limites

O padrão é HTTP autenticado. Também existe python -m vectara_mcp --stdio, que o texto oficial marca como menos seguro, só para desenvolvimento local ou Claude Desktop, não o primeiro caminho.

VECTARA_API_KEY é obrigatório. O texto oficial não escreve limite de taxa nem desfazer. Esta página não nomeia ferramentas de consulta; não trate as palavras Trusted RAG como nome de função. O endereço de loopback local só indica a escuta padrão, não que os dados não saiam da máquina—a recuperação ainda chega à Vectara.