/ /

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. Puede cambiar el loggers opción para especificar dónde se envían los registros. Para obtener detalles sobre las opciones del servidor MCP, consulta Opciones de Configuración del Servidor MongoDB MCP.

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 conocer el formato de la cadena de conexión y ejemplos, consulte Cadenas de conexión.

Problemas de transporte HTTP

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

Verifique que la URL de conexión de su cliente incluya la ruta del punto final /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úrese de que el puerto especificado esté abierto y accesible desde su 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	Required: Atlas API credentials • `apiClientId` (Service Account ID) • `apiClientSecret` (Service Account Secret)	Required: Docker runtime • No additional credentials needed • Automatically manages local deployments	Optional: Multiple connection methods • Pre-configured connection string • Atlas credentials for `atlas-connect-cluster` • Runtime connection via `connect` tool • Local deployment via `atlas-local-connect-deployment`
Método de conexión	API-based connection to Atlas Management API • No direct database connection needed • Uses Atlas REST API endpoints	Local deployment management • Uses Docker containers • No external network access required	Direct connection to MongoDB database. Multiple options available: • Configured connection string • Runtime connection prompt • Atlas cluster discovery • Local deployment connection
Requisitos de permisos	Service Account Roles (Atlas project-level): • `Project Read Only` (minimum for read operations) • `Project Owner` (for cluster creation/management) • `Organization Owner` (for project creation)	System Requirements: • Docker runtime permissions • Local file system access • Container management capabilities	Database User Roles (when applicable): • `readAnyDatabase` (read-only mode) • `readWriteAnyDatabase` (full operations) • Custom roles for specific databases/collections
Opciones de configuración	Environment Variables: `MDB_MCP_API_CLIENT_ID` or `MDB_MCP_API_CLIENT_SECRET` Command Line: • `--apiClientId` • `--apiClientSecret`	Environment Variables: • `DOCKER_HOST` (optional) Command Line: • No specific MCP configuration required • Automatically detects Docker runtime	Environment Variables (optional): `MDB_MCP_CONNECTION_STRING` Command Line (optional): • Connection string as positional argument: `--connectionString` Runtime Methods: • Interactive connection via LLM prompts • Atlas credential-based discovery
Impacto del modo de solo lectura	• Read operations: ✅ Available • Cluster inspection: ✅ Available • Cluster creation: ❌ Disabled • User management: ❌ Disabled	• Local deployment creation: ✅ Available • Deployment inspection: ✅ Available • Container management: ✅ Available • No read-only restrictions	• Read operations: ✅ Available • Query operations: ✅ Available • Aggregations: ✅ Available as long as they don't have a `$out` or `$merge` stage. • Insert/Update/Delete: ❌ Disabled • Index creation: ❌ Disabled
Categorías de herramientas	Can be disabled with: `--disabledTools atlas` or `MDB_MCP_DISABLED_TOOLS="atlas"`	Can be disabled with: `--disabledTools atlas` or `MDB_MCP_DISABLED_TOOLS="atlas"`	Can be disabled with: `--disabledTools mongodb` or `MDB_MCP_DISABLED_TOOLS="mongodb"`
Requisitos de red	Outbound HTTPS to Atlas API: • Standard internet connection	Local Docker Network: • Docker daemon access • Local port availability • No external network requirements	Connection to MongoDB cluster (when applicable): • Atlas: `mongodb+srv://` (port 27017) • Sharded clusters (port 27016) • Self-managed: Custom host/port • Local deployments: Docker network • VPC/network access as required
Operaciones disponibles	• Organization management • Project management • Cluster lifecycle (create, inspect, delete) • Database user management • Access list configuration • Performance Advisor recommendations • Alert management	• Local deployment creation and management • Container lifecycle operations • Local cluster configuration • Development environment setup • Testing deployment management	• CRUD operations (find, insert, update, delete) • Aggregation pipelines • Index management • Collection and database administration • Schema inspection • Vector search operations • Data export
Error Scenarios	Missing API Credentials: Atlas tools return: "Atlas API credentials not configured" Insufficient Permissions: HTTP 403 errors from Atlas API	Docker Unavailable: "Docker daemon not running" or "Docker not installed" Container Issues: Port conflicts, resource constraints	Connection Failures (when configured): Network timeouts, authentication failures Missing Database Permissions: MongoDB authorization errors
Credenciales temporales	Not applicable: Uses persistent service account credentials	Not applicable: Local deployments use container-managed authentication	Auto-generated database users (when applicable): When using Atlas API credentials without connection string: • Random username/password • 4-hour expiration by default • Automatic role assignment

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 adaptarse a 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: utilice la connect herramienta para proporcionar cadenas de conexión de forma interactiva durante las conversaciones LLM, sin necesidad de configuración previa.
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: evite los métodos de conexión en tiempo de ejecución a menos que esté seguro de que el historial de chat no se almacenará ni se compartirá con terceros.

Obtén más información

Volver

Desbordamiento de memoria

Herramientas