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 independiente que utiliza variables de entorno
Puede usar npx para iniciar el servidor MCP y usar variables de entorno. Debe definir las variables de entorno del servidor MCP en el sistema operativo antes de ejecutar npx.
Los siguientes ejemplos definen variables de entorno Unix de MCP Server 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, considere estos 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, consulte Definición de variables de entorno del servidor MCP en el sistema operativo.
Para examinar la lista de opciones del servidor MCP, consulte Opciones de configuración del servidor MCP de MongoDB.
Para crear una cuenta de servicio Atlas, consulte Requisitos previos del servidor MongoDB MCP para ejecutar herramientas Atlas.
El siguiente ejemplo utiliza las variables de entorno anteriores que tienen la información de conexión y también establece opciones de línea de comando adicionales:
npx -y mongodb-mcp-server@latest --readOnly --indexCheck --loggers mcp stderr --logPath=<log-path>
Reemplace <log-path> con la ruta del directorio para almacenar los archivos 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 puede utilizar el protocolo de transporte HTTP con el servidor MCP. HTTP es útil si desea interactuar con el servidor MCP desde un cliente web o configurarlo para que responda 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. Úselo solo si es necesario para interactuar con el servidor MCP.
Pautas de seguridad:
Implemente la autenticación. Por ejemplo, utilice una puerta de enlace API o un proxy inverso.
Utilice cifrado HTTPS/TLS.
Implemente el servidor MCP detrás de un firewall o en una red privada.
Implementar limitación de velocidad.
Nunca exponga las credenciales de conexión.
Para ver recomendaciones de seguridad, consulte Seguridad del servidor MongoDB MCP y Mejores prácticas de seguridad del servidor MongoDB MCP.
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 usando --httpHost=0.0.0.0, y el cliente podrá luego conectarse desde otra computadora usando la dirección IP o el nombre de host del servidor.
Advertencia
Con HTTP Streamable, el servidor MCP está vinculado a localhost
(127.0.0.1) por defecto. Esto garantiza que solo acepte conexiones que se originen en el mismo equipo.
La vinculación a 0.0.0.0 expone el servidor MCP a toda la red local, lo que permite que otros dispositivos de la misma red accedan potencialmente a él. Esto supone un riesgo de seguridad y podría permitir el acceso no autorizado al contexto de la base de datos. Si debe exponer el servidor MCP fuera localhost de, implemente una autenticación de seguridad robusta.