/ /

Solucionar problemas del servidor MCP de MongoDB

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

Archivos De Registro

Si tiene problemas con el servidor MCP, examine los registros del servidor MCP para obtener información que pueda ayudar a solucionar el problema.

De forma predeterminada, el servidor MCP escribe los registros en el disco y también los envía al cliente MCP. Puede cambiar la configuración. loggers Opción para especificar dónde se envían los registros. Para obtener más información sobre las opciones del servidor MCP, consulte Opciones de configuración del servidor MongoDB MCP.

La siguiente tabla muestra los directorios predeterminados donde el servidor MCP almacena los archivos de registro:

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

Para cambiar la ruta del registro, configure una de estas opciones:

logPath opción en un archivo de configuración JSON o en una línea de comando cuando inicia el servidor MCP
MDB_MCP_LOG_PATH variable de entorno

Problemas con la cadena de conexión

Asegúrese de que su archivo de configuración sea correcto y de que esté utilizando una cadena de conexión válida para su 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á utilizando el 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 (una computadora, un contenedor o una instancia de nube diferente), asegúrese de que el servidor se inicie 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 herramientas Atlas frente a herramientas de base de datos

Overview

El servidor MCP de MongoDB ofrece tres categorías principales de herramientas: herramientas Atlas para gestionar la infraestructura de Atlas, herramientas Atlas locales para gestionar implementaciones locales de forma similar a la CLI de Atlas, 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	Herramientas Atlas	Herramientas de 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 permiso	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 it doesn'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
Escenarios de error	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 bases 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: configure connectionString a través de CLI, variable de entorno o archivo de configuración para acceso persistente a la base de datos.
Conexión de clúster Atlas: utilice atlas-connect-cluster la herramienta con credenciales de API de Atlas para descubrir y conectarse automáticamente a clústeres 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: use atlas-local-connect-deployment con Docker para crear y conectarse a implementaciones de Atlas locales; requiere Docker pero no configuración.

Recomendaciones de seguridad:

Bases de datos de producción: utilice cadenas de conexión preconfiguradas a través de variables de entorno o credenciales de API de Atlas para conexiones seguras y automatizadas.
Desarrollo/prueba: La conexión en tiempo de ejecución o las implementaciones locales brindan flexibilidad sin 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