Você pode iniciar o Servidor MCP como um serviço autônomo , o que permite que o Servidor MCP seja executado independentemente de um cliente de IA. Para iniciar o Servidor MCP como um serviço autônomo , utilize o comando npx.
Serviço autônomo usando variáveis de ambiente
Você pode utilizar o npx para iniciar o Servidor MCP e utilizar variáveis de ambiente. Você deve definir as variáveis de ambiente do Servidor MCP no sistema operacional antes de executar o npx.
Os exemplos a seguir definem variáveis de ambiente do MCP Server Unix para se conectar a um cluster 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 usar o exemplo, considere estes pontos:
Substitua os valores das opções pelas informações de conexão e outros detalhes.
Para definir variáveis de ambiente para outros sistemas operacionais, consulte Definindo variáveis de ambiente do servidor MCP no sistema operacional.
Para examinar a lista de opções do servidor MCP, consulte Opções de configuração do servidor MongoDB MCP.
Para criar uma conta de serviço do Atlas, consulte Pré-requisitos do servidor MongoDB MCP para executar o Atlas FERRAMENTAS.
O exemplo a seguir usa as variáveis de ambiente anteriores que contêm as informações de conexão e também define opções de linha de comando adicionais:
npx -y mongodb-mcp-server@latest --readOnly --indexCheck --loggers mcp stderr --logPath=<log-path>
Substitua <log-path> pelo caminho do diretório para armazenar os arquivos de log.
Serviço independente em execução como servidor HTTP
O protocolo de transporte padrão do servidor MCP é stdio, adequado para integração com a maioria dos clientes MCP.
Você também pode usar o protocolo de transporte HTTP com o servidor MCP. O HTTP é útil para interagir com o Servidor MCP a partir de um cliente web ou para configurar o Servidor MCP para responder a solicitações em uma porta específica.
Observação
O transporte HTTP não é recomendado para uso de produção sem implementar medidas de autenticação e segurança. Use o transporte HTTP apenas se precisar usar HTTP para interagir com o servidor MCP.
Diretivas de segurança:
Implementar autenticação. Por exemplo, use um gateway de API ou um proxy reverso.
Use criptografia HTTPS/TLS.
Implemente o servidor MCP atrás de um firewall ou em uma rede privada.
Implementar limitação de taxa.
Nunca exponha credenciais de conexão.
Para visualizar recomendações de segurança, consulte MongoDB MCP Server Segurança e MongoDB MCP Server Segurança Melhores práticas.
Para iniciar o servidor MCP com transporte HTTP, utilize o --transport http. Por exemplo:
npx -y mongodb-mcp-server@latest --transport http --readOnly
Por padrão, o servidor MCP responde a solicitações no http://127.0.0.1:3000 e aceita somente conexões locais.
URL de conexão do cliente
Se você conectar um cliente MCP ao servidor HTTP, o URL de conexão do cliente deverá incluir o caminho do endpoint do /mcp. Por exemplo:
http://127.0.0.1:3000/mcp
Conexões remotas
Para permitir conexões remotas de outros computadores ou containers, vincule o servidor a todas as interfaces de rede usando --httpHost=0.0.0.0, e o cliente poderá então se conectar de outro computador usando o endereço IP ou nome do host do servidor.
Aviso
Com o Streamable HTTP, o servidor MCP é vinculado a localhost
(127.0.0.1) por padrão. Isso garante que o servidor MCP aceite somente conexões originadas no mesmo computador.
A vinculação ao 0.0.0.0 expõe o servidor MCP a toda a rede local, o que permite que outros dispositivos na mesma rede acessem potencialmente o servidor MCP. Isso é um risco à segurança e pode permitir o acesso não autorizado ao contexto do seu banco de dados . Se você precisar expor o servidor MCP fora de localhost, implemente uma autenticação de segurança forte.