Puede iniciar el servidor MCP como un servicio independiente, lo que le permite ejecutarse independientemente de un cliente AI. Para iniciar el servidor MCP como un servicio independiente, utilice el npx dominio.
Servicio autónomo usando variables de entorno
Puedes usar npx para iniciar el servidor MCP y usar variables de entorno. Debes definir las variables de entorno del servidor MCP en el sistema operativo antes de ejecutar npx.
Los siguientes ejemplos definen variables de entorno UNIX del servidor MCP para conectarse a un clúster Atlas:
export MDB_MCP_API_CLIENT_ID="<atlas-service-account-client-id>" export MDB_MCP_API_CLIENT_SECRET="<atlas-service-account-client-secret>" export MDB_MCP_CONNECTION_STRING="mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/<database-name>"
Para utilizar el ejemplo, tenga en cuenta los siguientes puntos:
Reemplace los valores de las opciones con su información de conexión y otros detalles.
Para definir variables de entorno para otros sistemas operativos, consulta Definición de variables de entorno del servidor MCP en el sistema operativo.
Para examinar la lista de opciones del servidor MCP, consulta Opciones de configuración del servidor MongoDB MCP.
Para crear una cuenta de servicio de Atlas, consulte Requisitos previos del servidor MCP de MongoDB para ejecutar las herramientas de Atlas.
El siguiente ejemplo utiliza las variables de entorno anteriores que contienen la información de conexión y también configura opciones adicionales de línea de comandos:
npx -y mongodb-mcp-server@latest --readOnly --indexCheck --loggers mcp stderr --logPath=<log-path>
Reemplace <log-path> con la ruta del directorio donde almacenará las entradas de registro.
Servicio autónomo ejecutándose como un servidor HTTP
El protocolo de transporte del servidor MCP predeterminado es stdio, que es adecuado para la integración con la mayoría de los clientes MCP.
También puedes usar el protocolo de transporte HTTP con el servidor MCP. HTTP es útil si desea interactuar con el MCP servidor desde un cliente Web o configurar el MCP servidor para responder a solicitudes en un puerto específico.
Nota
No se recomienda el transporte HTTP para uso en producción sin implementar medidas de autenticación y seguridad. Solo utilice el transporte HTTP si debe usar HTTP para interactuar con el servidor MCP.
Pautas de seguridad:
Implementar la autenticación. Por ejemplo, utiliza una pasarela API o un proxy inverso.
Utiliza cifrado HTTPS/TLS.
Implemente el servidor MCP detrás de un firewall o en una red privada.
Implementar limitación de velocidad.
Nunca expongas las credenciales de la conexión.
Para ver recomendaciones de seguridad, consulte MongoDB MCP Server Security y MongoDB MCP Server Security mejores prácticas.
Para iniciar el servidor MCP con transporte HTTP, utilice --transport http. Por ejemplo:
npx -y mongodb-mcp-server@latest --transport http --readOnly
De forma predeterminada, el servidor MCP responde a las solicitudes en http://127.0.0.1:3000 y solo acepta conexiones locales.
URL de conexión del cliente
Si se conecta un cliente MCP al servidor HTTP, la URL de conexión del cliente debe incluir la ruta de endpoint /mcp. Por ejemplo:
http://127.0.0.1:3000/mcp
Conexiones remotas
Para permitir conexiones remotas desde otras computadoras o contenedores, vincule el servidor a todas las interfaces de red utilizando --httpHost=0.0.0.0, y el cliente luego puede conectarse desde otra computadora usando la IP o el hostname del servidor.
Advertencia
Con Streamable HTTP, el MCP servidor está vinculado a localhost
(127.0.0.1) por defecto. Esto garantiza que el MCP servidor sólo acepte conexiones que se originen en el mismo ordenador.
La vinculación a 0.0.0.0 expone el MCP servidor a toda la red local, lo que permite que otros dispositivos en la misma red puedan acceder potencialmente al MCP servidor. Esto supone un riesgo de seguridad y podría permitir el acceso no autorizado a tu contexto de base de datos. Si es necesario exponer el servidor MCP fuera de localhost, implemente una autenticación de seguridadsólida.