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 :
- 標準インターネット接続

Local Docker Network:
• Docker デーモンへのアクセス
• ローカル ポートの可用性
• 外部ネットワーク要件なし

MongoDB クラスターへの接続 (該当する場合):
• Atlas: mongodb+srv:// (ポート 27017)
• シャーディングされたクラスター (ポート 27016)
• 自己管理型: カスタム ホスト/ポート
• ローカル配置: Docker ネットワーク
• 必要に応じた VPC/ネットワーク アクセス

利用可能な操作

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

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

・ローカル配置の作成と管理
・コンテナライフサイクル操作
・ローカルクラスター構成
・開発環境設定
・デプロイメントのテスト管理

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






集計パイプラインデータベースマネジメント

Error Scenarios

API 認証情報が見つかりません:
Atlas ツールは、"Atlas API 認証情報が構成されていません" を返します。

権限が不十分です:
Atlas API からの HTTP 403 エラー

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

接続の失敗 (設定時):
ネットワーク タイムアウト、認証の失敗

データベースの許可がない:
MongoDB 承認エラー

一時的な認証情報

適用外:
永続的なサービスアカウントの認証情報を使用

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

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