Para configurar el servidor MCP de MongoDB para conectarse a su clúster MongoDB y configurar otras opciones del servidor MCP, utilice cualquiera de estos métodos:
Archivo de configuración JSON con opciones del servidor MCP
Opciones de línea de comandos
Variables de entorno del sistema operativo
El servidor MCP utiliza las credenciales de la API de Atlas o una cadena de conexión para acceder a un clúster.
Métodos y opciones de conexión del clúster de servidores MCP
Para configurar el servidor MCP para conectarse a un clúster y configurar otras opciones del servidor MCP, utilice un método descrito en esta sección.
Nota
Los ejemplos de archivos de configuración del servidor MCP incluyen --readOnly
Para garantizar el acceso de solo lectura a los datos. Normalmente, se habilita el modo de solo lectura para evitar modificaciones de datos.
Para habilitar las operaciones de escritura, omita --readOnly o establezca la variable de entorno del sistema operativo MDB_MCP_READ_ONLY en false. Para obtener más información, consulte
Habilitación del modo de solo lectura del servidor MCP.
Los ejemplos del archivo de configuración del servidor MCP establecen el campo type en "stdio".
type puede configurarse con una de las siguientes opciones:
"stdio", que utiliza la entrada y salida estándar para las comunicaciones con el servidor MCP.stdioes adecuado para la mayoría de los clientes de IA. Normalmente se utilizastdio."http", que permite las comunicaciones HTTP con el servidor MCP. Se puede entonces utilizar HTTP para la interacción con el servidor MCP desde un cliente web.Advertencia
NO se recomienda HTTP para uso en producción sin implementar autenticación y seguridad.
Los ejemplos de archivos de configuración del servidor MCP también establecen el nombre del servidor MCP como "MongoDB". Se puede cambiar el nombre del servidor para que coincida con el nombre del servidor MCP después de iniciarlo. El nombre del servidor identifica al servidor MCP para el cliente de IA.
Conexión con las credenciales de la API de Atlas
Puede utilizar las credenciales de API de Atlas obtenidas en Requisitos previos del servidor MongoDB MCP para ejecutar herramientas de Atlas para conectarse a un clúster de Atlas.
Nota
Como verás en la sección siguiente, también puedes conectarte a un clúster de Atlas usando una cadena de conexión de MongoDB si no deseas utilizar credenciales de la API de Atlas por motivos de seguridad u otra razón.
Utilice variables de entorno en lugar de argumentos de línea de comandos para configuraciones sensibles, como credenciales de inicio de sesión e información de conexión. Por ejemplo, utilice MDB_MCP_API_CLIENT_ID y MDB_MCP_API_CLIENT_SECRET para la configuración del cliente API y MDB_MCP_CONNECTION_STRING para las cadenas de conexión.
Las variables de entorno son más seguras que los argumentos en la línea de comandos. Los argumentos en la línea de comandos pueden ser rastreados, almacenados en caché, incluidos en listas de procesos y registrados en diversas ubicaciones.
Para conectarse con las credenciales de la API de Atlas, configure las variables de entorno MDB_MCP_API_CLIENT_ID y MDB_MCP_API_CLIENT_SECRET en la sección env del archivo de configuración JSON para el cliente de AI:
... "args": [ "-y", "mongodb-mcp-server@latest", "--readOnly" ], "env": { "MDB_MCP_API_CLIENT_ID": "<atlas-service-account-client-id>", "MDB_MCP_API_CLIENT_SECRET": "<atlas-service-account-client-secret>" } ...
Reemplaza <atlas-service-account-client-id> y <atlas-service-account-client-secret> por tu información de Atlas.
Para obtener ejemplos completos de archivos de configuración JSON para varios clientes de IA, consulte Introducción al servidor MongoDB MCP.
Conexión con cadena de conexión de clúster
Si no desea utilizar las credenciales de la API de Atlas por seguridad u otro motivo, puede conectarse a un clúster mediante una cadena de conexión de MongoDB.
El siguiente ejemplo muestra una cadena de conexión para conectarse a un clúster Atlas:
... "args": [ "-y", "mongodb-mcp-server@latest", "--readOnly" ], "env": { "MDB_MCP_CONNECTION_STRING": "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/<database-name>" } ...
Reemplace <user-name>, <password>, <cluster-name> y <database-name> con su información de Atlas.
También puedes conectarte a un clúster local con una cadena de conexión. Por ejemplo:
... "args": [ "-y", "mongodb-mcp-server@latest", "--readOnly" ], "env": { "MDB_MCP_CONNECTION_STRING": "mongodb://127.0.0.1:27019/?directConnection=true" } ...
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.
Definición de variables de entorno del servidor MCP en el sistema operativo
Puede definir variables de entorno para establecer varias opciones de configuración para el servidor MCP.
Para definir variables de entorno del sistema operativo para el servidor MCP, utilice el prefijo MDB_MCP_ seguido del nombre de la variable en mayúsculas y guiones bajos. Por ejemplo, utilice MDB_MCP_CONNECTION_STRING para configurar la opción connectionString.
Utilice variables de entorno en lugar de argumentos de línea de comandos para configuraciones sensibles, como credenciales de inicio de sesión e información de conexión. Por ejemplo, utilice MDB_MCP_API_CLIENT_ID y MDB_MCP_API_CLIENT_SECRET para la configuración del cliente API y MDB_MCP_CONNECTION_STRING para las cadenas de conexión.
Las variables de entorno son más seguras que los argumentos en la línea de comandos. Los argumentos en la línea de comandos pueden ser rastreados, almacenados en caché, incluidos en listas de procesos y registrados en diversas ubicaciones.
En los ejemplos de las siguientes secciones, reemplace <atlas-service-account-client-id>, <atlas-service-account-client-secret>, <user-name>, <password>, <cluster-name> y <database-name> con su información de Atlas.
Variables de entorno de Unix
Los siguientes ejemplos muestran cómo definir variables de entorno del servidor MCP en un sistema operativo basado en Unix:
# Set Atlas API credentials for a service account export MDB_MCP_API_CLIENT_ID="<atlas-service-account-client-id>" export MDB_MCP_API_CLIENT_SECRET="<atlas-service-account-client-secret>" # Set a MongoDB connection string export MDB_MCP_CONNECTION_STRING="mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/<database-name>" # Change the MCP Server log path from the default export MDB_MCP_LOG_PATH="/mcp/logs"
Variables de entorno de la línea de comandos de Windows
Los siguientes ejemplos configuran las variables utilizando una línea de comandos de Windows:
:: Set Atlas API credentials for a service account set MDB_MCP_API_CLIENT_ID=<atlas-service-account-client-id> set MDB_MCP_API_CLIENT_SECRET=<atlas-service-account-client-secret> :: Set a MongoDB connection string set MDB_MCP_CONNECTION_STRING="mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/<database-name>" :: Change the MCP Server log path from the default set MDB_MCP_LOG_PATH="C:\mcp\logs"
Variables de entorno de Windows PowerShell
Los siguientes ejemplos establecen las variables en una sesión de Windows PowerShell:
# Set Atlas API credentials for a service account $env:MDB_MCP_API_CLIENT_ID="<atlas-service-account-client-id>" $env:MDB_MCP_API_CLIENT_SECRET="<atlas-service-account-client-secret>" # Set a MongoDB connection string $env:MDB_MCP_CONNECTION_STRING="mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/<database-name>" # Change the MCP Server log path from the default $env:MDB_MCP_LOG_PATH="C:\mcp\logs"