/ /

Soluciona problemas del servidor MongoDB MCP

Utiliza la información de esta página para ayudar a resolver problemas con el servidor MongoDB MCP.

entradas de registro

Si tenés problemas con el servidor MCP, revisá los registros del servidor MCP para obtener información que pueda ayudar a solucionar el problema.

Por defecto, el servidor MCP escribe los registros en el disco y también los envía al cliente MCP. Puedes cambiar la opción loggers para especificar dónde se envían los registros. Para obtener detalles sobre las opciones del MCP Server, consulta Opciones de configuración del servidor MCP de MongoDB.

La siguiente tabla muestra los directorios por defecto donde el Servidor MCP almacena las entradas de registro:

Sistema operativo	Directorio de registros por defecto
Windows	`%LOCALAPPDATA%\mongodb\mongodb-mcp\.app-logs`
macOS y Linux	`~/.mongodb/mongodb-mcp/.app-logs`

Para cambiar la ruta del registro, configure uno de los siguientes:

logPath opción en un archivo de configuración JSON o en una línea de comandos cuando inicias el Servidor MCP
MDB_MCP_LOG_PATH variable de entorno

Problemas con la cadena de conexión

Asegúrate de que tu archivo de configuración sea correcto y de que estés utilizando una cadena de conexión válida para tu implementación de MongoDB.

Para dar formato a la cadena de conexión y ver ejemplos, consulta Cadenas de conexión.

Problemas de transporte HTTP

Si está usando transporte HTTP y experimenta problemas de conexión:

Verifique que la URL de la conexión del cliente incluya la ruta de endpoint /mcp:
http://<server-address>:3000/mcp
Si se conecta a un servidor remoto (ordenador diferente, contenedor o instancia en la nube), asegúrese de que el servidor esté iniciado con --httpHost=0.0.0.0 para aceptar conexiones remotas:
npx -y mongodb-mcp-server@latest --transport http --httpHost=0.0.0.0 --readOnly
Asegúrate de que el puerto especificado esté abierto y accesible desde tu computadora cliente.

Guía de configuración de Atlas Tools vs Database Tools

Overview

El Servidor MCP de MongoDB proporciona tres categorías principales de herramientas: Herramientas de Atlas para gestionar la infraestructura de Atlas, Herramientas locales de Atlas para gestionar implementaciones locales de manera similar a lo que ofrece la Atlas CLI y Herramientas de base de datos para operaciones de datos. La siguiente tabla compara la configuración de cada herramienta.

Tabla de comparación de configuraciones

Aspecto de configuración	Atlas Tools	Herramientas Mod Atlas Local	Database Tools
Requisitos de autenticación	Obligatorio: credenciales de la API de Atlas • `apiClientId` (ID de cuenta de servicio) • `apiClientSecret` (Secreto de cuenta de servicio)	Obligatorio: Docker runtime • No se necesitan credenciales adicionales • Gestiona automáticamente las implementaciones locales	Opcional: Múltiples métodos de conexión • Cadena de conexión preconfigurada • Credenciales de Atlas para `atlas-connect-cluster` • Conexión en `connect` tiempo de ejecución mediante la herramienta • Implementación local mediante `atlas-local-connect-deployment`
Método de conexión	Conexión basada en API a la API de administración de Atlas • No se necesita conexión directa a la base de datos • Utiliza los puntos finales de la API REST de Atlas	Gestión de implementación local • Utiliza contenedores Docker • No se requiere acceso a la red externa	Conexión directa a la base de datos de MongoDB. Múltiples opciones disponibles: • Cadena de conexión configurada • Solicitud de conexión en tiempo de ejecución • Detección de clúster de Atlas • Conexión de implementación local
Requisitos de permisos	Roles de cuenta de servicio (nivel de proyecto de Atlas): • `Project Read Only` (mínimo para operaciones de lectura) • `Project Owner` (para la creación/gestión de clústeres) • `Organization Owner` (para la creación de proyectos)	Requisitos del sistema: • Permisos de tiempo de ejecución de Docker • Acceso al sistema de archivos local • Capacidades de gestión de contenedores	Roles de usuario de la base de datos (cuando corresponda): • `readAnyDatabase` (modo de solo lectura) • `readWriteAnyDatabase` (operaciones completas) • Roles personalizados para bases de datos/colecciones específicas
Opciones de configuración	Variables de entorno: `MDB_MCP_API_CLIENT_ID` o `MDB_MCP_API_CLIENT_SECRET` Línea de comandos: • `--apiClientId` • `--apiClientSecret`	Variables de entorno: • `DOCKER_HOST` (opcional) Línea de comandos: • No se requiere una configuración de MCP específica • Detecta automáticamente el tiempo de ejecución de Docker	Variables de entorno (opcional): `MDB_MCP_CONNECTION_STRING` Línea de comandos (opcional): • Cadena de conexión como argumento posicional: `--connectionString` Métodos de tiempo de ejecución: • Conexión interactiva a través de indicaciones de LLM • Detección basada en credenciales de Atlas
Impacto del modo de solo lectura	• Operaciones de lectura: ✅ Disponible • Inspección de clúster: ✅ Disponible • Creación de clúster: ❌ Deshabilitada • Gestión de usuarios: ❌ Deshabilitada	• Creación de implementaciones locales: ✅ Disponible • Inspección de implementaciones: ✅ Disponible • Gestión de contenedores: ✅ Disponible • Sin restricciones de solo lectura	• Operaciones de lectura: ✅ Disponible • Operaciones de query: ✅ Disponible • Agregaciones: ✅ Disponible siempre que no tengan una etapa `$out` o `$merge`. • Insertar/Actualizar/Borrar: ❌ Deshabilitado • Creación de índices: ❌ Deshabilitado
Categorías de herramientas	Se puede desactivar con: `--disabledTools atlas` o `MDB_MCP_DISABLED_TOOLS="atlas"`	Se puede desactivar con: `--disabledTools atlas` o `MDB_MCP_DISABLED_TOOLS="atlas"`	Se puede desactivar con: `--disabledTools mongodb` o `MDB_MCP_DISABLED_TOOLS="mongodb"`
Requisitos de red	HTTPS saliente a la API de Atlas: • Conexión a Internet estándar	Red local de Docker: • Acceso al demonio de Docker • Disponibilidad de puertos locales • No se requieren redes externas	Conexión al clúster de MongoDB (cuando corresponda): • Atlas: `mongodb+srv://` 27017(puerto) • Clústeres fragmentados 27016 (puerto) • Autogestionado: Host/puerto personalizado • Implementaciones locales: Red Docker • Acceso a VPC/red según sea necesario
Operaciones disponibles	• gestión de la organización • gestión de proyectos • ciclo de vida del clúster (crear, inspeccionar, borrar) • gestión de usuarios de base de datos • configuración de la lista de acceso • recomendaciones de Performance Advisor • gestión de alertas	• Creación y gestión de implementaciones locales • Operaciones del ciclo de vida del contenedor • Configuración del clúster local • Configuración del entorno de desarrollo • Gestión de implementaciones de prueba	• Operaciones CRUD (buscar, insertar, actualizar, eliminar) • Pipelines de agregación • Gestión de índices • Administración de colecciones y bases de datos • Inspección de esquemas • Operaciones de búsqueda vectorial • Operaciones de búsqueda léxica • Exportación de datos
Error Scenarios	Faltan credenciales de API: Las herramientas de Atlas devuelven: "Atlas API credentials not configured" Permisos insuficientes: HTTP 403 errores de Atlas API	Docker no disponible: "El demonio de Docker no se está ejecutando" o "Docker no está instalado" Problemas del contenedor: Conflictos de puertos, restricciones de recursos	Errores de conexión (cuando está configurado): Tiempos de espera de red, errores de autenticación Faltan permisos de base de datos: Errores de autorización de MongoDB
Credenciales Temporales	No aplicable: Utiliza credenciales de cuenta de servicio persistentes	No aplicable: Las implementaciones locales utilizan autenticación gestionada por contenedor	Usuarios de base de datos autogenerados (cuando corresponda): Cuando se utilizan credenciales de la API de Atlas sin cadena de conexión: • Nombre de usuario/contraseña aleatorios • Caducidad de 4horas por defecto • Asignación automática de roles

Métodos de conexión a la base de datos

Las herramientas de base de datos admiten múltiples métodos de conexión para satisfacer diferentes casos de uso y requisitos de seguridad:

Cadena de conexión preconfigurada: Configura connectionString a través de la interfaz de línea de comandos (CLI), una variable de entorno o un archivo de configuración para el acceso persistente a la base de datos.
Conexion de Atlas Cluster: Usa la herramienta atlas-connect-cluster con credenciales de API de Atlas para descubrir y conectar automáticamente con clusters de Atlas.
Conexión en tiempo de ejecución: Utiliza la herramienta connect para proporcionar cadenas de conexión de manera interactiva durante las conversaciones con LLM, sin requerir preconfiguración.
Conexión de implementación local: Utilice atlas-local-connect-deployment con Docker para crear y conectarse a implementaciones locales de Atlas: requiere Docker, pero no necesita configuración.

Recomendaciones de seguridad:

Bases de datos de producción: utiliza cadenas de conexión preconfiguradas a través de variables de entorno o credenciales de la API Atlas para conexiones seguras y automatizadas.
Desarrollo/pruebas: La conexión en tiempo de ejecución o las implementaciones locales proporcionan flexibilidad sin necesidad de una configuración persistente.
Seguridad del chat: Evita los métodos de conexión en tiempo de ejecución a menos que estés seguro de que el historial de chat no se almacenará ni compartirá con terceros.

Obtén más información

Volver

Desbordamiento de memoria

Seguridad