Solucionar problemas do servidor MongoDB MCP

Requisitos de autenticação

Necessário: credenciais da API do Atlas
apiClientId (ID da conta de serviço)
?apiClientSecret (segredo da conta de serviço)

Obrigatório: tempo de execução do Docker
• Nenhuma credencial adicional é necessária
• Gerencia automaticamente implantações locais

Opcional: vários métodos de
conexão ? string de conexão
Atlas -configurada?atlas-connect-cluster
connect
atlas-local-connect-deployment

Método de conexão

Conexão baseada em API para a API de gerenciamento do Atlas
? Não é necessária nenhuma conexão direta com o banco de dados -
Utiliza endpoints da API REST do Atlas

Gerenciamento de implantação local
• Usa contêineres Docker
• Não é necessário acesso à rede externa

Conexão direta ao banco de dados MongoDB. Várias opções disponíveis:
• String de conexão configurada
• Prompt de conexão em tempo de execução
• Descoberta de cluster do Atlas
• Conexão de implantação local

Requisitos de permissão

Funções da conta de serviço (nível de projeto do Atlas):
• Project Read Only (mínimo para operações de leitura)
• Project Owner (para criação/gerenciamento de cluster)
• Organization Owner (para criação de projeto)

Requisitos do sistema: Permissões
de tempo de execução do Docker Acesso
ao sistema de arquivos local Recursos
de gerenciamento de contêineres

Funções do utilizador de bancode dados (quando aplicável):
o (readAnyDatabase modo
readWriteAnyDatabase somente leitura)

Opções de configuração

Variáveis de ambiente:
MDB_MCP_API_CLIENT_ID ou
MDB_MCP_API_CLIENT_SECRET

Linha de comando:
• --apiClientId
• --apiClientSecret

Variáveis de ambiente:
• DOCKER_HOST (opcional)

Linha de comando:
• Nenhuma configuração MCP específica necessária
• Detecta automaticamente o tempo de execução do Docker

Variáveis de ambiente (opcional):
MDB_MCP_CONNECTION_STRING

Linha de comando (opcional):
– String de conexão como argumento posicional: Métodos de
--connectionString

tempo de execução:
– Conexão interativa por meio de prompts LLM
– Descoberta baseada em credenciais do Atlas

Impacto do modo somente leitura

– Operações de leitura: ✅ Disponível
– Inspeção de cluster: ✅ Disponível
– Criação de cluster: ❌ Desabilitado
– Gerenciamento de usuários: ❌ Desabilitado

– Criação de implantação local: ✅ Disponível – Inspeção da implantação: ✅ Disponível

– Gerenciamento de contêineres: ✅ Disponível
– Sem restrições de somente leitura

• Operações de leitura: ✅ Disponível
• Operações de query: ✅ Disponível
• Agregações: ✅ Disponível, desde que não tenham um estágio $out ou $merge.
• Inserir/Atualizar/Excluir: ❌ Desativado
• Criação de índice: ❌ Desativado

Categorias de ferramentas

Pode ser desabilitado com:
--disabledTools atlas ou
MDB_MCP_DISABLED_TOOLS="atlas"

Pode ser desabilitado com:
--disabledTools atlas ou
MDB_MCP_DISABLED_TOOLS="atlas"

Pode ser desabilitado com:
--disabledTools mongodb ou
MDB_MCP_DISABLED_TOOLS="mongodb"

Requisitos de rede

HTTPS de saída para Atlas API:
x Conexão padrão com a internet

Rede Docker local:
• Acesso ao daemon do Docker
• Disponibilidade de porta local
• Sem requisitos de rede externa

Conexão ao cluster MongoDB (quando aplicável):
• Atlas: mongodb+srv:// (porta 27017)
• Cluster sharded (porta 27016)
• Autogerenciado: host/porta personalizados
• Implantações locais: rede Docker
• Acesso à VPC/rede conforme necessário

Operações disponíveis

–

Gerenciamento de organização –
Gerenciamento de projetos – Ciclo de vida de cluster (criação, inspeção, exclusão) – Gerenciamento
de usuários do banco de dados – Configuração de lista de acesso
– Recomendações do Performance Advisor
– Gerenciamento de alertas

• Criação e gerenciamento de implantação local
• Operações de ciclo de vida do contêiner
• Configuração de cluster local
• Configuração do ambiente de desenvolvimento
• Gerenciamento de implantação de teste

– Operações CRUD (localizar, inserir, atualizar, excluir)
– Pipelines


de aggregation – Gerenciamento de índices – Administração de collections e banco de dados
– Inspeção de esquemas
– Operações de pesquisa vetorial “Operações de pesquisa lexical”
– Exportação de dados

Error Scenarios

Credenciais de API ausentes:
As ferramentas do Atlas retornam: "Credenciais de API do Atlas não configuradas"

Permissões insuficientes:
Erros HTTP 403 da API do Atlas

Docker indisponível:
"Docker daemon não está em execução" ou "Docker não instalado"

Problemas de contêiner:
Conflitos de porta, restrições de recursos

Falhas de conexão (quando configurado):
Tempos limite de rede, falhas de autenticação

Permissões de banco de dados ausentes:
Erros de autorização do MongoDB

Credenciais temporárias

Não aplicável:
Usa credenciais de conta de serviço persistentes

Não aplicável:
sistemas locais usam autenticação gerenciada por contêiner

Usuários de banco de dados gerados automaticamente (quando aplicável):
ao usar credenciais do Atlas API sem string de conexão:
– Nome de usuário/senha
4aleatórios – expiração de horas por padrão
– Atribuição automática de funções