/ /

Opciones de configuración del servidor de 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 eres usuario de MongoDB Enterprise o MongoDB Atlas y requieres un mecanismo de autenticación específico, consulta 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 utilizar 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 Normalmente, se debe evitar proporcionar la cadena de conexión durante el tiempo de ejecución porque se exponen las credenciales de conexión a los grandes modelos de lenguaje. La cadena de conexión se utiliza si el cliente nunca se ha conectado antes, o el cliente cambia la conexión a un nuevo clúster si previamente estaba conectado. 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 simulación, establezca `--dryRun` en el archivo de configuración o en la línea de comandos, o establezca 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`y 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 cuando se ejecuta MCP en un contenedor. Por ejemplo, para establecer `loggers` en `mcp` y `stderr` en el archivo de configuración JSON del cliente de IA o en la línea de comandos del sistema operativo, utilice `--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	Arreglo de nombres de herramientas MCP, tipos de operaciones o categorías de herramientas para desactivar. Para obtener más información, consulta Cómo desactivar las herramientas de 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`	Indicador que muestra si el MCP servidor recopila datos de uso. Si `disabled`, la recopilación de datos de uso del servidor MCP se detiene. 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 las comunicaciones HTTP con el Servidor MCP. Luego, puedes usar HTTP para interactuar con el Servidor MCP desde un cliente web o comunicarte con el Servidor MCP en un puerto IP HTTP específico. Advertencia El transporte HTTP NO se recomienda para uso en producción si no se implementan medidas de autenticación y seguridad 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.
`maxTimeMS`	`MDB_MCP_MAX_TIME_M_S`	entero	No establecido	Tiempo máximo en milisegundos que las operaciones pueden ejecutarse en el servidor de MongoDB. Si se establece esta opción, el servidor MCP pasa este valor como la opción `maxTimeMS` a operaciones de lectura como `find()`, `aggregate()` y `count()`.
`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 a utilizar al conectarse a sus implementaciones de MongoDB con el Servidor MongoDB MCP. SCRAM es el mecanismo de autenticación por defecto para MongoDB. Para conectarte usando otros métodos de autenticación, consulta 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 Asegura el directorio para que el usuario que ejecuta el servidor MCP sea el propietario con permisos de lectura/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 los detalles específicos del sistema operativo, consulta Exportar datos desde MongoDB MCP servidor.
`exportTimeoutMs`	`MDB_MCP_EXPORT_TIMEOUT_MS`	entero	`300000`	Tiempo en milisegundos después del cual los archivos de datos exportados son elegibles para su eliminación 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	Clave de API de Voyage IA utilizada para habilitar los auto-embeddings nativos en Atlas búsqueda vectorial. La clave de API de Voyage AI solo se utiliza al crear una implementación Atlas Local. Para más detalles, consulta Claves API de IA de Voyage 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 sólo 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	Anular comportamiento	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	Se requiere confirmación para herramientas, además de 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.
`maxTimeMS`	Prohibido
`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 inferior a 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 funcionalidades en la configuración existente, no agregar funcionalidades 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