Para configurar el servidor MCP de MongoDB para conectarse a tu clúster de MongoDB y establecer otras opciones del servidor MCP, utiliza 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 MCP servidor utiliza credenciales de Atlas API 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 establecer otras opciones del Servidor MCP, utiliza uno de los métodos descritos 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 guardar, omite --readOnly o configura la variable de entorno del sistema operativo MDB_MCP_READ_ONLY en false. Para más información, consulta
Habilitar el 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
Puedes usar las credenciales de la API de Atlas obtenidas en Requisitos previos del servidor MCP de MongoDB para ejecutar herramientas de Atlas para conectarte 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.
Utiliza 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, use MDB_MCP_API_CLIENT_ID y MDB_MCP_API_CLIENT_SECRET para la configuración del cliente de 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 Atlas, establezca 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 IA:
... "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 diversos clientes de IA, consulta Comenzar con el servidor MongoDB MCP.
Conexión con cadena de conexión de clúster
Si no quieres usar las credenciales de la API de Atlas por motivos de seguridad u otra razón, puedes conectarte a un clúster usando 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 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.
Definir 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.
Utiliza 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, use MDB_MCP_API_CLIENT_ID y MDB_MCP_API_CLIENT_SECRET para la configuración del cliente de 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 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"