Utilizar activos de Orchestrator en servidores MCP

Los servidores MCP a menudo necesitan secretos (claves de API, credenciales de base de datos, tokens de servicio) para conectarse a sistemas externos. En lugar de codificar estos valores en la configuración del servidor MCP, puedes hacer referencia a los activos de Orchestrator utilizando la sintaxis %ASSETS/AssetName% . En runtime, el robot resuelve estas referencias e inyecta los valores de activos reales como variables de entorno.

El mecanismo es el mismo para los servidores MCP de comando y codificado. Solo donde se configuran las variables de entorno difiere entre los dos.

Crear el activo en Orchestrator

Ve a tu carpeta en Orchestrator > Activos > Crear activo. Por ejemplo:

• Nombre: MyApiKey
• Tipo: Secreto (o Credencial para pares de nombre de usuario/contraseña)
• Valor: sk-abc123...

El activo debe estar en la misma carpeta que el servidor MCP.

Referencia al activo en las variables de entorno del servidor MCP

La sintaxis de referencia de activos es idéntica en todos los tipos de servidor. La ubicación de las variables de entorno difiere:

Tipo de servidor	Dónde configurar las variables de entorno
Servidor MCP de comandos	Directamente en el servidor MCP, en el campo Variables de entorno del formulario de creación o edición en Orchestrator.
Servidor MCP codificado	En el proceso en Orchestrator: Configuración > Variables de entorno.

En ambos casos, %ASSETS/AssetName% KEY=VALUE valor:

API_KEY=%ASSETS/MyApiKey%
DATABASE_URL=%ASSETS/MyDatabaseUrl%
REGION=us-east-1

Las referencias de activos y los valores simples se pueden mezclar. Cada variable va en su propia línea.

Lee las variables en tu código de servidor

Orchestrator almacena las variables de entorno sin procesar, incluidos los marcadores %ASSETS/...% posición, en la base de datos, cifradas en reposo. Cuando se inicia una sesión, Orchestrator las reenvía al tiempo de ejecución sin servidor, que resuelve las referencias de activos a sus valores reales antes de pasarlas al proceso del servidor MCP.

En el código del servidor MCP, las variables están disponibles como variables de entorno estándar. Por ejemplo:

import os
api_key = os.environ.get("API_KEY")  # Resolved to the asset value at runtime

Nota:

Los siguientes comportamientos se aplican a la inferencia de activos en servidores MCP:

• Los nombres de activos no distinguen entre mayúsculas y minúsculas en la sintaxis %ASSETS/...% .
• La clave de variable de entorno determina el enmascaramiento de secretos en la IU. Los patrones de coincidencia de claves como API_KEY, SECRET, PASSWORD, TOKEN o Authorization se enmascaran automáticamente con ****. La referencia %ASSETS/...% en sí siempre está visible (no enmascarada).
• Si un activo no existe o el robot no tiene acceso, la variable de entorno no se resolverá y el servidor recibirá la cadena %ASSETS/...% sin procesar.