MongoDB MCP Server のトラブルシューティング

認証要件

必須: Atlas API認証情報
-apiClientId （サービス アカウントID）
-apiClientSecret （サービス アカウントのシークレット）

必要: Dockerランタイム。追加の認証情報は必要ありません。ローカル配置を自動的に管理します。

任意: 複数の接続方法
事前構成された接続文字列 の Atlas 認証情報 ランタイム接続（
atlas-connect-cluster
connectツールによるランタイム接続）
経由のローカル配置atlas-local-connect-deployment

接続方法

Atlas Management APIへのAPIベースの接続
直接データベース接続は必要ありません 。
Atlas REST APIエンドポイントを使用します

ローカル配置管理 -
Dockerコンテナを使用 -
外部ネットワーク アクセスは必要ありません

MongoDBデータベースへの直接接続。複数のオプションを使用できます:

設定された接続文字列ランタイム接続プロンプト
- Atlas クラスター検出
- ローカル配置接続

権限要件

サービス アカウント ロール（Atlas プロジェクトレベル）:
|Project Read Only
Project Owner（読み取り操作の最小値）
Organization Owner（クラスターの作成および管理用）たとえば （プロジェクト作成用）

システム要件:
. Dockerランタイム権限
.
ローカルファイルシステムへのアクセス . コンテナ管理機能

データベースユーザー ロール（該当する場合）:
|readAnyDatabase （読み取り専用モード）
readWriteAnyDatabase（フル操作）・特定のデータベースおよびコレクションのカスタムロール

設定オプション

環境変数:
MDB_MCP_API_CLIENT_ID または
MDB_MCP_API_CLIENT_SECRET

コマンドライン:
+--apiClientId
---apiClientSecret

環境変数:
-DOCKER_HOST （任意）

コマンドライン:
- 特定の MCP 構成は必要ない
- Dockerランタイムを自動的に検出

環境変数（任意）:
MDB_MCP_CONNECTION_STRING

コマンドライン（任意）:
=
--connectionString

位置引数としての接続文字列:
ランタイム メソッド: =
LM プロンプトによるインタラクティブ接続 + Atlas 認証情報ベースの検出

読み取り専用モードの影響

-

読み取り操作:
✅ 使用可能 - クラスター検査: ✅ 使用可能

ローカル配置の作成: ✅ 利用可能

*
読み取り操作: ✅$out $merge
利用可能挿入/更新/削除: ❌ 無効化
- インデックス作成: ❌ 無効化

ツールカテゴリ

次の方法で無効にできます:
--disabledTools atlas または
MDB_MCP_DISABLED_TOOLS="atlas"

次の方法で無効にできます:
--disabledTools atlas または
MDB_MCP_DISABLED_TOOLS="atlas"

次の方法で無効にできます:
--disabledTools mongodb または
MDB_MCP_DISABLED_TOOLS="mongodb"

ネットワーク要件

Atlas APIへのアウトバウンド HTTPS :
- 標準インターネット接続

ローカルDockerネットワーク:
= Dockerデーモンアクセス、ローカル ポートの可用性、外部ネットワークは不要

MongoDBクラスターへの接続（該当する場合）:
[] Atlas:mongodb+srv:// （ポート27017
）}シャーディングされたクラスター（ポート27016
）}自己管理型: カスタム ホスト/ポート
$ ローカル配置: Dockerネットワーク
$ VPC/ ネットワーク アクセス必須:

利用可能な操作

組織マネジメント プロジェクトマネジメント

クラスターのライフサイクル（作成、検査、削除）。データベースユーザーのマネジメント。アクセスリストの構成。Performance Advisor
の推奨事項。アラートマネジメント

ローカル配置の作成と管理
コンテナのライフサイクル操作

ローカルクラスターの構成開発環境のセットアップ
配置管理のテスト

. CRUD操作（検索、挿入、更新、削除）




. 集計パイプライン
. インデックスデータベース

Error Scenarios

API認証情報の欠落:
Atlas ツールは返します: 「Atlas API認証情報が構成されていません」権限が十分ではありません:


403Atlas APIからのHTTP エラー

Dockerは使用できません:
「Dockerデーモンが実行中いない」または「Dockerがインストールされていない」コンテナの問題：ポート競合、リソースの制約

接続の失敗（構成されている場合）:
ネットワーク

タイムアウト、認証の失敗。データベース権限の欠落:
MongoDB認可エラー

一時的な認証情報

該当なし:
永続的なサービス アカウントの認証情報を使用します

該当なし:
ローカル配置ではコンテナ管理認証が使用されます

自動生成データベースユーザー（該当する場合）:接続文字列なしで
Atlas API認証情報を使用する場合:
ランダムのユーザー名とパスワード
4
有効期限はデフォルトで 時間、 ロールの自動割り当て