Use as informações desta página para ajudar a solucionar problemas com o Local MCP.
arquivos de log
Se você tiver problemas com o Local MCP, examine os logs do servidor para obter informações que possam ajudar a solucionar o problema.
Por padrão, o Local MCP grava os logs em disco e também os envia para o cliente MCP. Você pode alterar a opção loggers para especificar para onde os logs são enviados. Para obter detalhes sobre as opções do Local MCP, consulte Opções de configuração do servidor MongoDB MCP.
A tabela a seguir mostra os diretórios padrão onde o Local MCP armazena os arquivo de log:
Sistema operacional | Diretório de registro padrão |
|---|---|
Windows |
|
macOS e Linux |
|
Para alterar o caminho do registro, defina um destes:
logPathopção em um arquivo de configuração JSON ou na linha de comando ao iniciar o Local MCPMDB_MCP_LOG_PATHVariável de ambiente
Problemas com a cadeia de conexão
Verifique se o arquivo de configuração está correto e se você está usando uma string de conexão válida para o MongoDB deployment.
Para formatação e exemplos de string de conexão, consulte Cadeias de conexão.
Problemas de transporte HTTP
Se você estiver usando o transporte HTTP e tiver problemas de conexão:
Verifique se o URL de conexão do cliente inclui o caminho do endpoint
/mcp:http://<server-address>:3000/mcpSe estiver conectando a um servidor remoto (computador diferente, contêiner ou instância de nuvem), verifique se o servidor foi iniciado com
--httpHost=0.0.0.0para aceitar conexões remotas:npx -y mongodb-mcp-server@latest --transport http --httpHost=0.0.0.0 --readOnlyCertifique-se de que a porta especificada esteja aberta e acessível a partir do seu computador cliente .
Guia de Configuração do Atlas FERRAMENTAS versus Database Tools
Visão geral
O Local MCP fornece três categorias principais de FERRAMENTAS:
FERRAMENTAS do Atlas para gerenciar a infraestrutura do Atlas
FERRAMENTAS locais do Atlas para gerenciar implantações locais, semelhantes ao que a Atlas CLI oferece
FERRAMENTAS de banco de dados para operações de dados
A tabela a seguir compara a configuração de cada ferramenta.
Tabela de comparação de configurações
Aspecto de configuração | Ferramentas do Atlas | Ferramentas locais do Atlas | Ferramentas de banco de dados |
|---|---|---|---|
Requisitos de autenticação | Obrigatório: credenciais da Atlas API | Obrigatório: tempo de execução do Docker | Opcional: Vários métodos de conexão |
Método de conexão | Conexão baseada em API para a Atlas Gerenciamento API | Gerenciamento de implantação local | Conexão direta ao banco de dados MongoDB. Várias opções disponíveis: |
Requisitos de permissão | Funções da conta de serviço (nível de projeto do Atlas): | Requisitos do sistema: | Funções de usuários de banco de dados (quando aplicável): |
Opções de configuração | Variáveis de ambiente: | Variáveis de ambiente: | Variáveis de ambiente (opcional): |
Impacto do modo somente leitura | • operações de leitura: ✅ Disponível | • Criação de implantação local: ✅ Disponível | • Operações de leitura: ✅ Disponível |
Categorias de ferramentas | Pode ser desativado com: | Pode ser desativado com: | Pode ser desativado com: |
Requisitos de rede | HTTPS de saída para a API do Atlas: | Rede Docker local: | Conexão ao cluster MongoDB (quando aplicável): |
Operações disponíveis | • Gerenciamento da organização | • Criação e gerenciamento de implantação local | • Operações CRUD (localizar, inserir, atualizar, excluir) |
Error Scenarios | Credenciais de API ausentes: | Docker Indisponível: | Falhas de conexão (quando configurado): |
Credenciais temporárias | Não aplicável: | Não aplicável: | Usuários de banco de dados gerados automaticamente (quando aplicável): |
Métodos de conexão do banco de dados
As ferramentas de banco de dados oferecem suporte a vários métodos de conexão para acomodar diferentes casos de uso e requisitos de segurança:
String de conexão pré-configurada: configure o
connectionStringvia CLI, variável de ambiente ou arquivo de configuração para acesso persistente ao banco de dados.Atlas Cluster Connect: utilize a ferramenta
atlas-connect-clustercom credenciais Atlas API para descobrir e conectar automaticamente a Atlas clusters.Conexão de tempo de execução: use a ferramenta
connectpara fornecer connection strings interativamente durante conversas LLM - nenhuma pré-configuração necessária.Conexão de implantação local: use o
atlas-local-connect-deploymentcom Docker para criar e conectar-se a implantações locais do Atlas - requer Docker, mas nenhuma configuração.
Recomendações de segurança:
Bancos de dados de produção: use connection strings pré-configuradas por meio de variáveis de ambiente ou credenciais do Atlas API para conexões seguras e automatizadas.
Desenvolvimento/teste: A conexão de tempo de execução ou implantações locais fornecem flexibilidade sem configuração persistente.
Segurança de chat: evite métodos de conexão de tempo de execução, a menos que tenha certeza de que o histórico de chat não será armazenado ou compartilhado com terceiros.