/ /

Opciones de configuración del servidor MongoDB MCP

El Servidor MCP cuenta con varias opciones que puedes configurar para conectarse a un clúster de MongoDB y controlar las operaciones del Servidor MCP. Puede configurar las opciones en un archivo de configuración JSON, a través de una línea de comandos o utilizando variables de entorno del sistema operativo.

Lista de opciones

Utilice las siguientes opciones de configuración para configurar el servidor MCP.

Importante

Si es un usuario de MongoDB Enterprise o MongoDB Atlas y necesita un mecanismo de autenticación específico, consulte la Sección Seguridad del servidor MCP de MongoDB para aprender sobre las opciones de configuración de su método de autenticación.

Nombre de la Opción de CLI	Nombre de la variable de entorno del SO.	Tipo	predeterminado	Descripción
`allowRequestOverrides`	`MDB_MCP_ALLOW_REQUEST_OVERRIDES`	booleano	`false`	Indica si los usuarios pueden anular las configuraciones del servidor MCP por solicitud utilizando encabezados de solicitud y parámetros de consulta. Para conocer el comportamiento específico de anulación de cada opción de configuración, consulta la Tabla de comportamiento de anulación a continuación.
`apiClientId`	`MDB_MCP_API_CLIENT_ID`	string	No establecido	ID de cliente de la API de Atlas para autenticación.
`apiClientSecret`	`MDB_MCP_API_CLIENT_SECRET`	string	No establecido	Secreto del cliente de la API de Atlas para la autenticación.
`config`	`MDB_MCP_CONFIG`	string	No establecido	Ruta completa al archivo de configuración JSON. Se recomienda usar la variable de entorno `MDB_MCP_CONFIG` en lugar de la opción de línea de comandos `--config`.
`connectionString`	`MDB_MCP_CONNECTION_STRING`	string	No establecido	Cadena de conexión para una conexión directa a la base de datos. Establece la cadena de conexión en tiempo de ejecución para permitir que el cliente se conecte directamente a un clúster. Importante El argumento `--connectionString` CLI está en desuso. En su lugar, utilice la variable de entorno `MDB_MCP_CONNECTION_STRING`. Si las variables de entorno no son una opción, utilice el primer argumento posicional. Nota Por lo general, evite proporcionar la cadena de conexión en tiempo de ejecución porque expone las credenciales de conexión al modelo de lenguaje grande. La cadena de conexión se utiliza si el cliente nunca se ha conectado antes, o si el cliente cambia la conexión a un nuevo clúster si estaba conectado previamente. Después de que el cliente llama a la herramienta de conexión o cambio de conexión, el cliente reutiliza la misma conexión para operaciones posteriores. Por lo tanto, solo necesitas llamar a la herramienta de conexión o cambio de conexión una vez o si necesitas cambiar a una conexión diferente.
`dryRun`	`MDB_MCP_DRY_RUN`	booleano	`false`	Utiliza la opción de ejecución en seco para examinar la configuración de tu servidor MCP. Cuando activas la opción de ejecución de prueba, el servidor MCP devuelve la configuración del servidor MCP y la lista de Herramientas de MongoDB MCP Serverhabilitadas. Para habilitar la opción de ejecución en seco, configure `--dryRun` en el archivo de configuración o en la línea de comando, o configure la variable de entorno del sistema operativo `MDB_MCP_DRY_RUN` en `true`. Para obtener más información, consulte Habilitar el modo de prueba en servidor MCP.
`externallyManagedSessions`	`MDB_MCP_EXTERNALLY_MANAGED_SESSIONS`	booleano	`false`	Permite a los clientes omitir la inicialización de la sesión. Cuando está habilitada, los clientes pueden llamar a las herramientas directamente con una ID de sesión auto-generada. Esas sesiones se crean implícitamente en el servidor y se mantienen activas hasta que `idleTimeoutMS` expiré. Esto es generalmente útil para integraciones con AWS Bedrock, donde el framework AgentCore gestiona las sesiones internamente y genera servidores MCP on-demand para cada sesión. Importante Para mejorar la seguridad de la sesión, asegúrese de que los ID de sesión sean únicos e impredecibles.
`loggers`	`MDB_MCP_LOGGERS`	string	`disk mcp`	Ruta donde el Servidor MCP envía los registros. Establece `loggers` en una o más de las siguientes opciones: `disk`que escribe registros en archivos en disco ubicados en la ruta especificada en la opción `logPath`. `mcp`, que envía los registros al cliente de IA, si el cliente admite el protocolo de registro y transporte. `stderr`, que envía los registros a la salida de error estándar. Esta configuración es útil para la depuración o al ejecutar MCP en un contenedor. Por ejemplo, para establecer `loggers` en `mcp` y `stderr` en el archivo de configuración JSON del cliente AI o en la línea de comando del sistema operativo, use `--loggers mcp stderr`. Para establecer la variable de entorno del sistema operativo `MDB_MCP_LOGGERS` en `disk` y `stderr`, utilice `export MDB_MCP_LOGGERS="disk,stderr"`. Para más información sobre las opciones de registro, vea Solucionar problemas del servidor MongoDB MCP.
`logPath`	`MDB_MCP_LOG_PATH`	string	Depende del sistema operativo	Directorio que almacena los registros del Servidor MCP. Nota Bloquea el directorio para que el usuario que ejecuta el servidor MCP sea el dueño y tenga permiso de lectura/escritura. Esto impide que cualquier otro proceso acceda a los directorios o archivos del servidor. Para obtener más información sobre la ruta de registro y las especificidades del sistema operativo, consulta Soluciona problemas del servidor MongoDB MCP.
`disabledTools`	`MDB_MCP_DISABLED_TOOLS`	arreglo	No establecido	Matriz de nombres de herramientas MCP, tipos de operación o categorías de herramientas para deshabilitar. Para obtener más información,consulte Deshabilitar las herramientas del servidor MCP.
`readOnly`	`MDB_MCP_READ_ONLY`	booleano	`false`	Bandera que determina si las operaciones de guardado están permitidas. Para deshabilitar las operaciones de escritura en clúster, establece `--readOnly` en el archivo de configuración o en la línea de comandos, o configura la variable de entorno del sistema operativo `MDB_MCP_READ_ONLY` a `true`. El valor por defecto es permitir las operaciones de escritura del clúster. Por lo general, activa siempre el modo de solo lectura. Para obtener más información, consulta Activar el modo de solo lectura del servidor MCP.
`indexCheck`	`MDB_MCP_INDEX_CHECK`	booleano	`false`	Indicador que indica si se requieren índices para las queries. Si `true`, obliga a que las operaciones de consulta deben usar un índice y rechaza las consultas que realizan escaneos de colecciones. Para obtener más información, consulta Habilitar la verificación de índices.
`telemetry`	`MDB_MCP_TELEMETRY`	string	`enabled`	Marca que indica si el servidor MCP recopila datos de uso. Si es `disabled`, se detiene la recopilación de datos de uso del servidor MCP. Para obtener más información, consulta Desactivar la telemetría del servidor MCP.
`transport`	`MDB_MCP_TRANSPORT`	string	`stdio`	Protocolo de transporte para comunicaciones con el Servidor MCP. Asigna `transport` a una de las siguientes opciones: `stdio`, que es el valor por defecto. Utiliza la entrada y salida estándar para las comunicaciones con el servidor MCP. `stdio` es adecuado para la mayoría de los clientes de IA. `http`, que permite la comunicación HTTP con el servidor MCP. Puede usar HTTP para interactuar con el servidor MCP desde un cliente web o comunicarse con él en un puerto IP HTTP específico. Advertencia NO se recomienda el transporte HTTP para uso en producción sin implementar medidas de seguridad y autenticación adecuadas.
`httpPort`	`MDB_MCP_HTTP_PORT`	entero	`3000`	Número de puerto IP para las comunicaciones HTTP con el servidor MCP.
`httpHost`	`MDB_MCP_HTTP_HOST`	string	`127.0.0.1`	Dirección IP para las comunicaciones HTTP con el Servidor MCP. Con Streamable HTTP, el MCP servidor está vinculado a `localhost (127.0.0.1)` por defecto. Esto garantiza que el MCP servidor sólo acepte conexiones que se originen en el mismo ordenador. Advertencia La vinculación a `0.0.0.0` expone el MCP servidor a toda la red local, lo que permite que otros dispositivos en la misma red puedan acceder potencialmente al MCP servidor. Esto supone un riesgo de seguridad y podría permitir el acceso no autorizado a tu contexto de base de datos. Si es necesario exponer el servidor MCP fuera de `localhost`, implemente una autenticación de seguridadsólida. Para obtener más información, consulta Conexiones remotas.
`httpBodyLimit`	`MDB_MCP_HTTP_BODY_LIMIT`	entero	`102400`	Tamaño máximo del cuerpo de la solicitud HTTP en bytes. Solo se aplica al transporte HTTP.
`httpResponseType`	`MDB_MCP_HTTP_BODY_RESPONSE_TYPE`	string	`sse`	Controla la respuesta del servidor MCP. Los valores válidos son `sse` o `json`. En los casos en que los clientes no puedan establecer una conexión `sse`, pueden optar por utilizar el tipo de respuesta `json`. Cuando eliges el tipo de respuesta `json`, el servidor no puede iniciar la comunicación con el cliente (por ejemplo, notificaciones o registros).
`healthCheckHost`	`MDB_MCP_HEALTH_CHECK_HOST`	string	No establecido	Dirección del host para el servidor HTTP healthCheck independiente. Este es un endpoint HTTP que Kubernetes y Docker pueden usar para comprobar la salud del proceso MCP. Solo aplica al transporte HTTP. Si se proporciona, se requiere el ajuste `healthCheckPort`.
`healthCheckPort`	`MDB_MCP_HEALTH_CHECK_PORT`	entero	No establecido	Número de puerto para el servidor HTTP healthCheck independiente. Este es un endpoint HTTP que Kubernetes y Docker pueden usar para comprobar la salud del proceso MCP. Solo aplica al transporte HTTP. Si se proporciona, se requiere el ajuste `healthCheckHost`.
`idleTimeoutMs`	`MDB_MCP_IDLE_TIMEOUT_MS`	entero	`600000`	Tiempo de espera inactivo para que un cliente se desconecte. Solo se aplica al transporte HTTP.
`notificationTimeoutMs`	`MDB_MCP_NOTIFICATION_TIMEOUT_MS`	entero	`540000`	Tiempo de espera de notificación para que un cliente se percate de la desconexión. Solo aplica al transporte HTTP.
`authenticationMechanism`	`MDB_MCP_AUTHENTICATION_MECHANISM`	string	`SCRAM-SHA-256`	Mecanismo de autenticación que se utilizará al conectarse a sus implementaciones de MongoDB con el servidor MongoDB MCP. SCRAM es el mecanismo de autenticación predeterminado para MongoDB. Para conectarse mediante otros métodos de autenticación, consulte las siguientes páginas: Conectar con OpenID Connect (OIDC) Conéctese con LDAP Conéctate con Kerberos Conéctese con X.509 Certificados Conectar con Proxy
`exportsPath`	`MDB_MCP_EXPORTS_PATH`	string	Depende del sistema operativo	Directorio que almacena archivos de datos exportados. Nota Bloquee el directorio para que el usuario que ejecuta el servidor MCP lo posea con permisos de lectura y escritura. Esto impide que cualquier otro proceso acceda a los directorios o archivos exportados. Para obtener más información sobre la ruta de exportación y las características específicas del sistema operativo,consulte Exportar datos desde el servidor MongoDB MCP.
`exportTimeoutMs`	`MDB_MCP_EXPORT_TIMEOUT_MS`	entero	`300000`	Tiempo en milisegundos después del cual los archivos de datos exportados son elegibles para ser eliminados por el proceso de limpieza del servidor MCP.
`exportCleanupIntervalMs`	`MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS`	entero	`120000`	Periodo de tiempo en milisegundos entre ejecuciones automáticas del proceso de limpieza del Servidor MCP que elimina archivos de datos de exportación caducados. El proceso de limpieza se ejecuta automáticamente.
`voyageApiKey`	`MDB_MCP_VOYAGE_API_KEY`	string	No establecido	Se utiliza la clave API de Voyage AI para habilitar las incrustaciones automáticas nativas en Atlas Vector Search. La clave API de Voyage AI solo se utiliza al crear una implementación de Atlas Local. Para obtener más información, consulte Claves API de Voyage AI en Atlas. Para obtener más información sobre Voyage IA, consulte la documentación de Voyage IA.

Comportamientos de anulación de la opción de configuración

La siguiente tabla describe el comportamiento de anulación de cada opción de configuración. Estos comportamientos de anulación solo se aplican si la opción de configuración allowRequestOverrides está establecida en true. Si un usuario intenta anular una opción de configuración que prohíbe las anulaciones, el servidor MCP rechaza la conexión.

Config Key	Comportamiento de anulación	Condición adicional
`apiBaseUrl`	Prohibido
`apiClientId`	Prohibido
`apiClientSecret`	Prohibido
`allowRequestOverrides`	Prohibido
`connectionString`	Prohibido
`config`	Prohibido
`loggers`	Prohibido
`logPath`	Prohibido
`disabledTools`	Unir	Desactiva herramientas además de las que ya está en la configuración existente.
`confirmationRequiredTools`	Unir	Requiere confirmación para herramientas adicionales a las de la configuración existente.
`readOnly`	Condicional	Solo se puede sobrescribir una configuración existente de `false` a `true`.
`indexCheck`	Condicional	Solo se puede sobrescribir una configuración existente de `false` a `true`.
`telemetry`	Prohibido
`transport`	Prohibido
`httpPort`	Prohibido
`httpHost`	Prohibido
`httpHeaders`	Prohibido
`healthCheckHost`	Prohibido
`healthCheckPort`	Prohibido
`idleTimeoutMs`	Condicional	Solo se puede anular con un tiempo de espera menor que la configuración existente.
`notificationTimeoutMs`	Condicional	Solo se puede anular con un tiempo de espera menor que la configuración existente.
`maxBytesPerQuery`	Prohibido
`maxDocumentsPerQuery`	Prohibido
`exportsPath`	Prohibido
`exportTimeoutMs`	Condicional	Solo se puede anular con un tiempo de espera menor que la configuración existente.
`exportCleanupIntervalMs`	Prohibido
`atlasTemporaryDatabaseUserLifetimeMs`	Condicional	Solo se puede anular con una vida útil menor que la configuración existente.
`voyageApiKey`	Prohibido
`embeddingsValidation`	Condicional	Solo se puede sobrescribir una configuración existente de `false` a `true`.
`vectorSearchDimensions`	Sobrescribir
`vectorSearchSimilarityFunction`	Sobrescribir
`previewFeatures`	Condicional	Solo se pueden deshabilitar funciones en la configuración existente, no agregar funciones adicionales.

Argumentos posicionales

El servidor MCP acepta un argumento posicional que puede proporcionarse sin especificar una bandera CLI. El primer argumento posicional se interpreta como la cadena de conexión para tu implementación de MongoDB.

Como mejor práctica de seguridad, utiliza la variable de entorno MDB_MCP_CONNECTION_STRING para establecer la cadena de conexión. Si las variables de entorno no son una opción, utiliza el primer argumento posicional. Por ejemplo:

"args": [
   "-y",
   "mongodb-mcp-server",
   "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/",
   "--readOnly"
]

Obtén más información

Volver

Configuración manual de archivos

Métodos

Lista de opciones

Importante

Importante

Nota

Importante

Nota

Advertencia

Advertencia

Nota

Comportamientos de anulación de la opción de configuración

Argumentos posicionales

Obtén más información