MCP

Vectara MCP: conectar agentes a Trusted RAG

Para quien quiere que un agente use Vectara Trusted RAG; instala con pip, arranca por HTTP predeterminado y primero llama setup_vectara_api_key para validar la clave.

Official source · Vectara-MCP

Install

pip install vectara-mcp

Para quién

Si quieres conectar una app de agente al Trusted RAG de Vectara—rápido, estable y con menos alucinaciones por recuperación aumentada—este servicio encaja. El texto oficial describe esa capacidad por el protocolo MCP.

Encaja si ya puedes instalar con pip y tienes una clave API de Vectara. El arranque predeterminado es transporte HTTP autenticado. Sin clave, la herramienta de configuración de sesión no pasa la validación.

La primera vez solo valida la clave. No trates como funciones conocidas herramientas de consulta que no se han nombrado. La recuperación igual sale a la red y también envía tu pregunta a Vectara.

Completar el primer intento en 3 minutos

La vía oficial recomendada es instalar desde PyPI y arrancar con el transporte HTTP seguro predeterminado. Requisitos: ya tienes una clave API de Vectara.

Instalación:

pip install vectara-mcp

Pon la variable de entorno VECTARA_API_KEY con la clave real emitida por la consola. Los valores de ejemplo oficiales son marcadores; no los copies. Luego arranca:

python -m vectara_mcp

El texto oficial dice que el servicio, por defecto, corre en:

http://127.0.0.1:8000

y la autenticación ya está activa. Apunta el cliente MCP a ese servicio HTTP. El texto oficial no escribe los campos de cabecera completos a poner en el cliente; no los inventes. Conecta como el cliente conecta un MCP HTTP autenticado.

Luego haz una llamada: llama setup_vectara_api_key. El texto oficial dice que configura y valida la clave API de Vectara de la sesión; es un ajuste de una vez. No escribe campos de parámetros; rellena la clave real según la definición que muestre el cliente y no escribas cadenas de ejemplo.

Señal de éxito: la validación pasa y la sesión puede usar esa clave. Si falla, comprueba primero que la variable de entorno y el argumento de la herramienta sean la clave real.

No añadas --stdio. La primera vez solo HTTP predeterminado.

Casos de uso

Caso 1: validar la clave en la sesión. Llama setup_vectara_api_key. La nota oficial es Configure and validate your Vectara API key for the session. No escribe el formato de clave ni si pisa la variable de entorno. Si acierta deberías ver que la validación pasa. No lo trates como una herramienta que pueda consultar un corpus.

Caso 2: tras validar, una consulta Trusted RAG. El texto oficial dice que este servidor da Trusted RAG a apps de agente. Esta página solo nombra la herramienta de ajuste de arriba y no escribe un nombre de función de consulta; abre las herramientas que este servidor muestra en el cliente y elige la descrita como recuperación o preguntas y respuestas. No inventes nombres de función que no aparecieron. Si acierta deberías ver resultados de recuperación de Vectara. Las consultas salen y también pueden exponer el texto de tu pregunta.

Límites

Por defecto es HTTP autenticado. También existe python -m vectara_mcp --stdio, que el texto oficial marca como menos seguro, solo para desarrollo local o Claude Desktop, no la primera vía.

VECTARA_API_KEY es obligatorio. El texto oficial no escribe límite de ritmo ni deshacer. Esta página no nombra herramientas de consulta; no trates las palabras Trusted RAG como nombre de función. La dirección de bucle local solo indica la escucha predeterminada, no que los datos no salgan de la máquina: la recuperación sigue llegando a Vectara.