El servidor MCP de MongoDB le permite interactuar con sus datos y implementaciones de MongoDB desde clientes de IA en lenguaje natural.
Puede utilizar el servidor MCP de MongoDB con cualquier implementación de MongoDB, incluyendo MongoDB Atlas, MongoDB Atlas Local, MongoDB Community Edition y MongoDB Enterprise Advanced.
MongoDB ofrece dos tipos de implementación de servidor MCP: MCP local para servidor MCP de MongoDB, que usted ejecuta y gestiona, y servidor MCP gestionado de MongoDB Atlas, que MongoDB aloja y gestiona para usted en Atlas. Para obtener más información, consulte ¿Qué es el servidor MCP de MongoDB? a continuación.
Esta página describe conceptos clave y casos de uso. Si ya conoce MCP, puede comenzar.
¿Qué es el Protocolo de Contexto de Modelo (MCP)?
El Model Context Protocol (MCP) es un estándar abierto desarrollado por Anthropic para estandarizar cómo los LLM se conectan e interactúan con recursos y servicios externos. MCP consta de una arquitectura cliente-servidor con los siguientes componentes clave:
Host de MCP: La aplicación o entorno donde quieres usar MCP, como una interfaz de chat o un IDE. Por ejemplo, Claude Desktop o VS Code.
Clientes MCP: Componentes dentro del host que gestionan las conexiones con servidores MCP. Para obtener una lista de clientes que admiten MCP, consulte Clientes MCP.
Servidores MCP: Programas que exponen capacidades específicas al cliente. Por ejemplo, el servidor MongoDB MCP.
La forma principal en que los servidores MCP exponen capacidades a los clientes es a través de herramientas. Las herramientas son funciones ejecutables predefinidas que permiten a los LLM realizar acciones específicas, como interactuar con fuentes de datos externas como MongoDB.
Para obtener más información, consulta Documentación de MCP.
¿Qué es el servidor MCP de MongoDB?
El servidor MCP de MongoDB es nuestra implementación oficial del servidor MCP que proporciona a tu cliente de IA un conjunto de herramientas que pueden utilizarse para interactuar con tus datos y despliegues de MongoDB. Estas herramientas incluyen diversas acciones administrativas, como la gestión de recursos del clúster, operaciones de base de datos como consultas e indexación, y la optimización del rendimiento a través de Performance Advisor (asesor de rendimiento).
MongoDB ofrece dos tipos de implementación para MongoDB MCP Server:
MCP local para MongoDB MCP Server: Usted mismo ejecuta el servidor MCP y gestiona directamente sus conexiones de agente de IA y la infraestructura del servidor MCP.
Servidor MCP gestionado de MongoDB Atlas: MongoDB ejecuta el servidor MCP en Atlas y gestiona las conexiones del agente de IA y la infraestructura del servidor MCP por usted.
Puedes configurar cualquiera de los dos tipos de implementación con el plugin MongoDB MCP o mediante un archivo de configuración:
Plugin MCP de MongoDB para clientes de IA: Instala MongoDB desde el marketplace de un cliente de IA. Un cliente de IA es una interfaz que se utiliza para solicitar un modelo de IA. El plugin MCP de MongoDB para el servidor MCP gestionado de MongoDB Atlas proporciona acceso delegado por el usuario para clientes de IA interactivos.
Configuración manual del archivo de configuración: agregue manualmente la configuración del servidor MCP de MongoDB y las credenciales de cliente de OAuth a un archivo de configuración para su cliente de IA. Esta ruta para configurar es la mejor para trabajar con agentes programáticos. Los agentes programáticos son agentes automatizados y basados en flujos de trabajo que pueden ejecutar flujos de trabajo de varios pasos sin la entrada o la orientación del usuario.
En la siguiente tabla se compara Local MCP para MongoDB MCP servidor y MongoDB Atlas gestionado MCP servidor. Utilice esto para ayudarle a seleccionar el tipo de implementación que mejor se adapte a sus necesidades:
MCP local para el servidor MCP de MongoDB | Servidor MCP gestionado de MongoDB Atlas | |
|---|---|---|
Modelo de hosting | Usted mismo instala, ejecuta y mantiene el servidor MCP de MongoDB. Usted es responsable de las actualizaciones del servidor, la conectividad y la rotación de credenciales. | MongoDB aloja, ejecuta y mantiene el servidor MCP de MongoDB en Atlas. No hay infraestructura de servidor MCP para implementar, actualizar u operar. |
Implementaciones de bases de datos compatibles | Autogestionado (on-premises) y Atlas (nube) | Atlas (nube) solamente |
Nivel de control de acceso | Acceso al plano de datos hasta el nivel de colección | Acceso al plano de datos a nivel de proyecto |
Mejor para | Usuarios que desean un control directo y granular sobre dónde se ejecuta el servidor MCP de MongoDB y cómo se conecta a las implementaciones de MongoDB. | Usuarios que utilizan implementaciones de Atlas que desean que MongoDB aloje y gestione el servidor por ellos. |
Servidor MCP gestionado de MongoDB Atlas
Con MongoDB Atlas gestionado MCP servidor, MongoDB aloja y gestiona el MongoDB MCP servidor en Atlas en lugar de requerir que ejecute el servidor en su propia máquina o infraestructura. Debido a que MongoDB opera el servidor, no implementa, actualiza ni mantiene ninguna infraestructura de MCP, y no gestiona cadenas de conexión, secretos o certificados para la conexión a su implementación de Atlas.
El servidor MCP gestionado de MongoDB Atlas ofrece las siguientes ventajas:
Acceso optimizado a la implementación: al utilizar el MongoDB MCP Plugin para conectarse al MongoDB Atlas Managed MCP Server, puede acceder a las implementaciones de su base de datos directamente mediante Atlas App Connections sin necesidad de gestionar las credenciales de la cuenta de servicio.
Amplio soporte para usuarios: MongoDB Atlas Managed MCP servidor es compatible tanto con usuarios que trabajan con clientes de IA interactivos como con usuarios que utilizan agentes programáticos.
Controles de gobernanza del administrador: Incluye la aceptación a nivel de organización y la aplicación de solo lectura para clientes de IA y roles por configuración, listas de acceso IP y configuraciones de solo lectura para agentes programáticos.
MCP local para el servidor MCP de MongoDB
MCP local para el servidor MCP de MongoDB es la ruta del servidor MCP de MongoDB autogestionado. Usted mismo ejecuta el servidor MCP y lo conecta manualmente a su implementación y herramientas de MongoDB.
Utilice MCP local cuando desee un control directo sobre cómo y dónde se ejecuta el servidor MCP. A cambio de este control, usted asume el alojamiento y el mantenimiento del servidor, incluidas las actualizaciones del servidor y la gestión de credenciales.
También utiliza MCP local cuando desea utilizar el servidor MCP de MongoDB con tipos de implementación local, como MongoDB Atlas Local, MongoDB Community Edition y MongoDB Enterprise Advanced.
Casos de uso
El servidor MongoDB MCP te permite interactuar con tus datos e implementaciones de MongoDB utilizando lenguaje natural, agilizando los flujos de trabajo de desarrolladores y facilitando la realización de tareas complejas desde interfaces de IA. Por ejemplo, el servidor MongoDB MCP habilita los siguientes casos de uso:
Caso de uso | Descripción | Ejemplo de solicitud. |
|---|---|---|
Exploración de datos | Aprende y explica el esquema de tu base de datos y sus relaciones. |
|
Operaciones de bases de datos | Crear, leer, actualizar y borrar datos en tus colecciones de MongoDB. |
|
Gestión de bases de datos | Realiza tareas administrativas para gestionar tus clústeres, usuarios de bases de datos y más. |
|
Generación de código | Describe los datos que necesitas y luego genera queries relevantes de MongoDB y código de la aplicación. |
|
Optimización del rendimiento | Analiza el rendimiento de las consultas y obtén recomendaciones para mejorar los índices y el esquema. |
|
Para obtener una lista de las herramientas específicas disponibles en el servidor MCP de MongoDB, consulta las herramientas del servidor MCP de MongoDB.
Métodos de configuración
Puede configurar Local MCP para el servidor MCP de MongoDB y el servidor MCP gestionado de MongoDB Atlas mediante el plugin MCP de MongoDB de un marketplace de clientes de IA o configurando manualmente el servidor MCP de MongoDB en un archivo de configuración para su cliente de IA.
Plugin MCP de MongoDB para acceso delegado por el usuario
El plugin MongoDB MCP ayuda a los usuarios a dar a los clientes de IA acceso delegado por el usuario para explorar las implementaciones de MongoDB. Este método utiliza Atlas Aplicación Connections, que le permite autorizar a un cliente de IA a acceder a sus recursos de Atlas a través de un flujo de OAuth vinculado a su identidad de Atlas.
Este método no requiere infraestructura ni credenciales de MCP para gestionar. Con el plugin MongoDB MCP:
Encontrará MongoDB como conector o plugin en el marketplace de un cliente de IA y lo autorizará mediante Atlas App Connections.
El cliente de IA actúa en su nombre utilizando su identidad de Atlas.
La actualización del token es automática. No gestiona una cadena de conexión, un secreto o un certificado.
Puedes ver y revocar los clientes de IA a los que te conectaste en cualquier momento.
Para obtener más información, consulte Descripción general de las conexiones de aplicaciones de Atlas.
Configurar el archivo de configuración mediante credenciales de cliente de OAuth
Puede agregar manualmente una configuración del servidor MCP de MongoDB al archivo de configuración de su cliente de IA. Este método de configurar es especialmente útil para el acceso de agentes programáticos.
Las credenciales que utiliza dependen de su tipo de implementación
Para MCP local para MongoDB MCP Server, agregue sus propias credenciales para conectarse a su implementación de MongoDB, incluidas las cadenas de conexión de clúster y las credenciales de API de Atlas opcionales para las herramientas de Atlas.
Para MongoDB Atlas gestionado MCP servidor, un Organization Owner o Project Owner de Atlas crea una configuración de MongoDB Atlas gestionado MCP servidor a través de Atlas. Esta configuración:
Proporciona una cuenta de servicio y devuelve un ID de cliente, un secreto de cliente y la URL del servidor MCP gestionado de MongoDB Atlas (
https://mcp.mongodb.com) que proporciona a su agente.Utiliza cuentas de servicio de Atlas de entrada y salida separadas. El cliente de IA recibe credenciales de entrada que otorgan acceso solo al servidor MCP gestionado de MongoDB Atlas. Luego, el servidor utiliza una cuenta de servicio de salida separada, configurada con los permisos de Atlas necesarios, para realizar llamadas a la API en nombre del cliente de IA. Las credenciales de salida no se exponen al cliente de IA.
Autentica al cliente de IA con la cuenta de servicio y utiliza los roles que asigna el administrador, en lugar de la identidad de un usuario individual.
Los administradores obtienen un control granular por configuración sobre MongoDB Atlas Managed MCP Server, que incluye:
Los roles de Atlas concedidos
Una lista de acceso IP
Una flag de solo lectura (activada por defecto)
Paquete MCP gestionado de Atlas para cuentas de servicio de configuración de MCP
Algunos clientes de IA no admiten de forma nativa el flujo de credenciales de cliente de OAuth de la cuenta de servicio de configuración de MCP que utiliza el servidor MCP gestionado de MongoDB Atlas para el acceso programático. Para conectar estos clientes, utiliza el paquete npm mongodb-atlas-mcp-remote. Ejecutas este paquete utilizando npx en el archivo de configuración de tu cliente. El paquete adquiere un token de acceso de las credenciales de tu cuenta de servicio de configuración de MCP y reenvía las solicitudes al servidor MCP gestionado de MongoDB Atlas, gestionando el almacenamiento en caché y la actualización de tokens por ti. Esto te permite conectar sin problemas clientes de IA al servidor MCP gestionado de MongoDB Atlas.
Utilice este paquete solo para clientes de IA que se conecten a través de un archivo de configuración. Las instrucciones específicas del cliente en la página Empezar a utilizar el servidor MongoDB MCP ya utilizan el paquete.
Si compila un agente programático con un marco de IA como LangChain, no utilice este paquete. En su lugar, obtenga un token de acceso y llame a MongoDB Atlas gestionado MCP servidor directamente desde el código de su aplicación. Para obtener más información, consulte Introducción a MongoDB MCP servidor y seleccione AI Framework Clients en el menú desplegable AI CLIENT.
Obtén más información
Para configurar el servidor MongoDB MCP y aprender a utilizarlo, consulta los siguientes recursos:
Comienza rápidamente con el servidor MongoDB MCP. | |
Consulta los requisitos previos para configurar el servidor MCP de MongoDB. | |
Ver todas las opciones de configuración y conexión disponibles. | |
Vea todas las herramientas disponibles en el MongoDB MCP Server. | |
Ejemplo de prompts de prueba para utilizar con el Servidor MCP de MongoDB. | |
Aprenda sobre las mejores prácticas de seguridad para el servidor MCP de MongoDB. | |
Consulta el código fuente del servidor MCP de MongoDB y las directrices para contribuir. |