/ /

Opciones de configuración del servidor MongoDB MCP

El servidor MCP ofrece varias opciones que puede configurar para conectarse a un clúster de MongoDB y controlar sus operaciones. Puede configurar las opciones en un archivo de configuración JSON, mediante la línea de comandos o mediante 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 de Seguridad del servidor MongoDB MCP para conocer las opciones de configuración para su método de autenticación.

Nombre de la opción CLI	Nombre de la variable de entorno del sistema operativo	Tipo	predeterminado	Descripción
`allowRequestOverrides`	`MDB_MCP_ALLOW_REQUEST_OVERRIDES`	booleano	`false`	Indicador que indica si los usuarios pueden anular las configuraciones del servidor MCP por solicitud con encabezados de solicitud y parámetros de consulta. Para conocer el comportamiento específico de anulación de cada opción de configuración, consulte la tabla de comportamientos 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 de base de datos directa. 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 `--connectionString` argumento CLI está `MDB_MCP_CONNECTION_STRING` obsoleto. En su lugar, utilice la variable de entorno. 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, reutiliza la misma conexión para operaciones posteriores. Por lo tanto, solo necesita llamar a la herramienta de conexión una vez o si necesita cambiar a otra conexión.
`dryRun`	`MDB_MCP_DRY_RUN`	booleano	`false`	Utilice la opción de simulacro para examinar la configuración de su servidor MCP. Al habilitarla, el servidor MCP devuelve su configuración y la lista de herramientas de MongoDB MCP Server habilitadas. 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 Habilitación del modo de ejecución en seco del servidor MCP.
`loggers`	`MDB_MCP_LOGGERS`	string	`disk mcp`	Ruta donde el Servidor MCP envía los registros. Establezca `loggers` en una o más de las siguientes opciones: `disk`, que escribe registros en archivos de 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 obtener más información sobre las opciones de registro, consulte 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 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 del servidor. Para obtener más información sobre la ruta de registro y las características específicas del sistema operativo,consulte Solucionar 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`	Indicador que determina si se permiten las operaciones de escritura. Para deshabilitar las operaciones de escritura en clúster, configure `--readOnly` en el archivo de configuración o la línea de comandos, o configure la variable de entorno del sistema operativo `MDB_MCP_READ_ONLY` en `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`	Marca que indica si se requieren índices para las consultas. Si es `true`, exige que las operaciones de consulta usen un índice y rechaza las consultas que realizan análisis de colección. Para obtener más información, consulte Habilitar la comprobación de índice.
`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,consulte Deshabilitar la telemetría del servidor MCP.
`transport`	`MDB_MCP_TRANSPORT`	string	`stdio`	Protocolo de transporte para comunicaciones con el servidor MCP. Establezca `transport` en una de las siguientes opciones: `stdio`, que es el valor predeterminado. 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 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 HTTP Streamable, el servidor MCP está vinculado a `localhost (127.0.0.1)` por defecto. Esto garantiza que solo acepte conexiones que se originen en el mismo equipo. Advertencia La vinculación a `0.0.0.0` expone el servidor MCP a toda la red local, lo que permite que otros dispositivos de la misma red accedan potencialmente a él. Esto supone un riesgo de seguridad y podría permitir el acceso no autorizado al contexto de la base de datos. Si debe exponer el servidor MCP fuera `localhost` de, implemente una autenticación de seguridad robusta. Para obtener más información,consulte 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.
`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 sea consciente de la desconexión. Solo se 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: Conectarse con OpenID Connect (OIDC) Conéctese con LDAP Conéctate con Kerberos Conéctese con X.509 Certificados Conectarse 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 los archivos de datos de exportación caducados. El proceso de limpieza se ejecuta automáticamente.
`previewFeatures`	`MDB_MCP_PREVIEW_FEATURES`	string	No establecido	Valores separados por comas de las funciones de vista previa habilitadas. Valores válidos: `search`.

Opciones de búsqueda de vectores

Importante

El soporte de búsqueda de vectores en MCP está disponible como Función devista previa. Para habilitar esta función, configure el previewFeatures indicador o la MDB_MCP_PREVIEW_FEATURES variable de entorno en search en la configuración de MCP.

Las siguientes opciones configuran el comportamiento del servidor MCP cuando lo utiliza para trabajar con MongoDB Vector Search.

Nombre de la opción CLI	Nombre de la variable de entorno del sistema operativo	Tipo	predeterminado	Descripción
`voyageApiKey`	`MDB_MCP_VOYAGE_API_KEY`	string	No establecido	Clave API de Voyage AI para generación automática de incrustaciones. Al configurar esta opción, el servidor MCP genera automáticamente incrustaciones para: Documentos que insertas con la herramienta `insert-many` El `queryVector` parámetro en las consultas de `$vectorSearch` agregación El servidor MCP también valida que los campos con índices de búsqueda vectorial contengan vectores de incrustación válidos para evitar romper los índices de búsqueda vectorial. El servidor MongoDB MCP admite los siguientes modelos de Voyage AI: `voyage-3-large` `voyage-3.5` `voyage-3.5-lite` `voyage-code-3` Para obtener más información sobre Voyage AI, consulte la documentación de Voyage AI. Para obtener opciones de configuración de búsqueda vectorial adicionales, consulte Opciones de búsqueda vectorial.
`embeddingsValidation`	`MDB_MCP_EMBEDDINGS_VALIDATION`	booleano	`true`	Indicador que indica si los vectores de incrustación están validados. Cuando se establece en `true`, habilita la validación de las dimensiones de incrustación. De forma predeterminada, el servidor MCP valida que los campos con índices de búsqueda vectorial contengan vectores de incrustación válidos con las dimensiones correctas para evitar la interrupción de dichos índices. Desactive esta opción para permitir la inserción de valores sin procesar en campos de incrustación sin validación. Advertencia Deshabilitar la validación de incrustaciones puede generar documentos con incrustaciones no válidas que no se pueden usar con índices de búsqueda vectorial.
`vectorSearchDimensions`	`MDB_MCP_VECTOR_SEARCH_DIMENSIONS`	entero	`1024`	Número predeterminado de dimensiones para incrustaciones de búsqueda vectorial. Este valor se utiliza al crear índices de búsqueda vectorial y validar incrustaciones.
`vectorSearchSimilarityFunction`	`MDB_MCP_VECTOR_SEARCH_SIMILARITY_FUNCTION`	string	`euclidean`	Función de similitud por defecto para la búsqueda vectorial. Establecer en uno de los siguientes valores: `euclidean`:Distancia euclidiana `cosine`: Similitud de coseno `dotProduct`:Similitud del producto escalar El servidor MCP utiliza este valor como predeterminado al crear índices de búsqueda vectorial, a menos que se especifique lo contrario. Para obtener más información, consulte Cómo indexar campos para la búsqueda vectorial.

Comportamientos de anulación de opciones 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`	Combinar	Desactiva herramientas adicionales a las de la configuración existente.
`confirmationRequiredTools`	Combinar	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
`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 marca CLI. El primer argumento posicional se interpreta como la cadena de conexión para la 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

Configurar

Métodos

Lista de opciones

Importante

Importante

Nota

Nota

Advertencia

Advertencia

Nota

Opciones de búsqueda de vectores

Importante

Advertencia

Comportamientos de anulación de opciones de configuración

Argumentos posicionales

Obtén más información