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)

Necessário: tempo de execução do Docker ?Nenhuma credencial adicional necessária

? Gerencia automaticamente sistemas 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 containers Docker”
Não é necessário acesso a rede externa

Conexão direta com o banco de dados MongoDB . Várias opções disponíveis:
– string de conexão configurada
– Prompt de conexão de
tempo de execução – Descoberta de Atlas cluster
– Conexão de implementação local

Requisitos de permissão

Roles da Conta de Serviço (nível de projeto Atlas ):
o (mínimo para operações de Project Read Only leitura)
o Project Owner (para a criação/gerenciamento de clusters)
o Organization Owner (para a 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
DOCKER_HOST de

ambiente:
? (opcional)
Linha de comando:

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

.

– $out $merge
Inserir/Atualizar/Excluir: ❌ desabilitado – Criação de
índice: ❌ desabilitado

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 de internet

Rede Docker Local:
– Acesso ao daemon Docker
– Disponibilidade da Porta Local
– Nenhum requisito de rede externa

Conexão com cluster MongoDB (quando aplicável):
mongodb+srv:// 27017
27016

o Atlas: (porta)
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 do 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 agregação
– Gerenciamento de índices
– Administração de coleções e banco de dados
– Inspeção de esquemas
– Operações de pesquisa vetorial
– Exportação de dados

Error Scenarios

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

Permissões insuficientes:
403 erros HTTP da API 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