/ /

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	Requisitos: Credenciales de la API de Atlas • `apiClientId` (ID de cuenta de servicio) • `apiClientSecret` (Secreto de cuenta de servicio)	Requisitos: 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 despliegue local • Utiliza contenedores Docker • No requiere acceso a la red externa	Conexión directa a la base de datos MongoDB. Varias opciones disponibles: • Cadena de conexión configurada • Solicitud de conexión en tiempo de ejecución • Detección de clúster Atlas • Conexión de implementación local
Requisitos de permisos	Roles de cuenta de servicio (a nivel de proyecto Atlas): • (mínimo para operaciones de `Project Read Only` lectura) • `Project Owner` (para creación/gestión de clústeres) • `Organization Owner` (para creación de proyectos)	Requisitos del sistema: • Permisos 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 ninguna configuración específica de MCP • Detecta automáticamente el entorno 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: Métodos `--connectionString` de tiempo de ejecución: • Conexión interactiva mediante 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 despliegue local: ✅ Disponible • Inspección de despliegue: ✅ Disponible • Gestión de contenedores: ✅ Disponible • Sin restricciones de solo lectura	• Operaciones de lectura: ✅ Disponibles • Operaciones de consulta: ✅ Disponibles • Agregaciones: ✅ Disponibles siempre que no tengan una `$out` `$merge` etapa o. • Inserción/Actualización/Eliminación: ❌ Deshabilitadas • Creación de índices: ❌ Deshabilitadas
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 Docker local: • Acceso al demonio Docker • Disponibilidad de puerto local • Sin requisitos de red externa	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 (creación, inspección, eliminación) • Gestión de usuarios de la base de datos • Configuración de listas de acceso • Recomendaciones del Asesor de rendimiento • Gestión de alertas	• Creación y gestión de despliegues locales • Operaciones del ciclo de vida de los contenedores • Configuración de clústeres locales • Configuración del entorno de desarrollo • Gestión de despliegues 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 • Exportación de datos
Error Scenarios	Credenciales de API faltantes: Las herramientas de Atlas devuelven: "Credenciales de API de Atlas no configuradas". Permisos insuficientes: Errores HTTP 403 de la API de Atlas.	Docker no disponible: "El demoniode Docker no se está ejecutando" o "Docker no está instalado". Problemas con los contenedores: conflictos de puertos, limitaciones de recursos.	Fallos de conexión (cuando está configurado): Tiempos de espera de red agotados, fallos de autenticación. Permisos de base de datos faltantes: 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 administrada por el contenedor.	Usuarios de base de datos generados automáticamente (cuando corresponda): Al usar credenciales de la API de Atlas sin cadena de conexión: • Nombre 4de usuario/contraseña aleatorios • Caducidad de horas 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