メインコンテンツへスキップ

クラウドMCPサーバーのセットアップ

Molly Exten
  • 更新

mablクラウドMCPサーバーを使用すると、AIクライアントが会話形式のプロンプトを通じて、テストの作成と実行、結果の照会、失敗の分析、テスト品質レポートの生成を行えます。

前提条件

Claude Code、Cursor、Windsurf、Gemini CLI、Claude Desktop、RovoなどのMCPサーバーをサポートするAIクライアントが必要です。

セットアップ

mabl クラウド MCP サーバーは、2 つの認証方法をサポートしています。

  • OAuth - クラウドMCPをmablユーザーアカウントに接続し、ユーザーが所属するすべてのワークスペースにアクセスできます。mablのログイン情報を使用するため、mablアプリと同様に、定期的に再認証が必要になる場合があります。どの方法を選べばよいかわからない場合は、こちらから始めてください。
  • APIキー - mabl APIキーを使用してクラウドMCPに接続します。アクセスはキーが生成された単一のワークスペースに限定され、キー自体が期限切れになるか削除されるまで有効です。エージェント間のユースケースに最適です。

この記事の設定では、「mabl」という名前でMCPサーバーを作成します。必要に応じて別の名前を使用することもできます。たとえば、組織が厳格なセキュリティホワイトリスト、企業プロキシ、または内部IDEレジストリを使用している場合、組織のホワイトリスト要件に準拠するために「mabl」という名前を変更する必要があるかもしれません。不明な点がある場合は、MCPに関する具体的なガイドラインについて、社内のITチームまたはセキュリティチームに確認してください。また、すべてのクライアントがJSON設定を使用するわけではありません。リモートMCPサーバーの追加手順については、お使いのAIクライアントのドキュメントを参照してください。

設定

多くの AI クライアントは、MCP サーバーに JSON 設定ファイルを使用します。次の設定ブロックを使用してください。

{
  "mcpServers": {
    "mabl": {
      "url": "https://mcp.mabl.com/mcp",
      "type": "http"
    }
  }
}

typeの文字列は異なる場合があります

CursorやWindsurfなど一部のクライアントでは、"type": "http"の代わりに"type": "streamable-http"を使用します。期待されるtypeの文字列については、クライアントのドキュメントを確認してください。

デュアルエンドポイント SSE パターンを必要とするレガシー MCP クライアントの場合は、代わりに次の設定を使用してください。"type": "sse" および "url": "https://mcp.mabl.com/sse"。

Claude Codeでは、ターミナルで次のコマンドを実行してmabl MCPをセットアップすることもできます。

claude mcp add --transport http mabl https://mcp.mabl.com/mcp

このコマンドは、現在のプロジェクトに対してのみクラウドMCPサーバーを登録します。すべてのプロジェクトでmablを利用できるようにするには、--scope userを追加してください。サーバーが設定されていることを確認するには、claude mcp listを実行してください。

Gemini CLIでは、mabl MCPを拡張機能として利用できます。設定ファイルを編集する代わりに、次のコマンド1つでインストールできます。

gemini extensions install https://github.com/mablhq/mabl-mcp-server

この拡張機能は、クラウドMCPサーバーを設定し、mablツールの使い方に関するガイダンスをエージェントに提供するコンテキストファイルを追加します。拡張機能がインストールされていることを確認するには、gemini extensions listを実行してください。

サーバーを追加したら、ブラウザーの同意フローを通じて認証を完了してください。

  • クライアント主導：クライアントがログインしていないことを認識し、プロセスを開始するためのボタンまたはプロンプトを表示する場合があります。
  • ユーザー主導：エージェントが自動的に認証を促さない場合は、「mabl MCPの認証を手伝ってください」のようなプロンプトを使用してプロセスを開始してください。

クラウドMCPは同意ページをブラウザウィンドウで開きます。内容を確認し、承認をクリックしてください。この時点でmablウェブアプリにまだログインしていない場合は、mablへのサインインも必要です。

デフォルトでは、クラウド MCP サーバーは mabl ユーザーアカウントに関連付けられたプライマリワークスペースに接続します。デフォルトのワークスペースが不明な場合は、クライアントに確認してください。

「デフォルトのワークスペースは何ですか？」

利用可能なすべてのワークスペースを一覧表示するには、次のように確認してください。

「アクセスできるワークスペースはどれですか？」

プライマリ以外のワークスペースで mabl クラウド MCP ツールを使用するには、ツールを呼び出す際にワークスペース名またはワークスペース ID を指定してください。例：

「mabl prod tests ワークスペースから最近作成したテストを取得してください。」

設定

APIキーのセットアップでは、ブラウザーの同意フローなしで接続を認証します。以下の設定ブロックを使用し、YOUR_API_KEY_HEREを「編集者」または「閲覧者」タイプのmabl APIキーに置き換えてください。

{
  "mcpServers": {
    "mabl": {
      "url": "https://mcp.mabl.com/mcp",
      "type": "http",
      "headers": {
        "x-api-key": "YOUR_API_KEY_HERE"
      }
    }
  }
}

typeの文字列は異なる場合があります

CursorやWindsurfなど一部のクライアントでは、"type": "http"の代わりに"type": "streamable-http"を使用します。期待されるtypeの文字列については、クライアントのドキュメントを確認してください。

デュアルエンドポイント SSE パターンを必要とするレガシー MCP クライアントの場合は、代わりに次の設定を使用してください。"type": "sse" および "url": "https://mcp.mabl.com/sse"。

Claude Codeでは、ターミナルで次のコマンドを実行することもできます。

claude mcp add --transport http mabl https://mcp.mabl.com/mcp --header "x-api-key: YOUR_API_KEY_HERE"

このコマンドは、現在のプロジェクトに対してのみクラウドMCPサーバーを登録します。すべてのプロジェクトでmablを利用できるようにするには、--scope userを追加してください。サーバーが設定されていることを確認するには、claude mcp listを実行してください。

Gemini CLIのmabl拡張機能はOAuthを使用します。代わりにAPIキーで接続する場合は、Gemini CLIの設定にサーバーを手動で追加し、urlの代わりにhttpUrlを使用して、キーをheadersオブジェクトで指定してください。

設定ファイルをバージョン管理にチェックインしたり、他のユーザーと共有したりする場合は、キーを直接貼り付けるのではなく、環境変数から参照してください。たとえば、"x-api-key": "${MABL_API_KEY}" のように指定します。

APIキーは、生成されたワークスペースに限定されます。OAuthとは異なり、APIキーで認証した場合はワークスペースを切り替えられません。別のワークスペースで作業するには、そのワークスペースでキーを生成し、設定を更新してください。

カスタムコネクタとしてmabl MCPサーバーを追加する

Claude DesktopをmablクラウドMCPサーバーに接続するには、カスタムコネクタとして追加します。Settings > Connectors > Add > Add custom connectorを開き、次の項目を入力してください。

  • Name: mabl
  • Remote MCP server URL: https://mcp.mabl.com/mcp

ClaudeのTeamプランおよびEnterpriseプランでは、コネクタを追加すると組織内で利用できるようになりますが、全員に自動的に接続されるわけではありません。mabl MCPサーバーを使用するユーザーは、それぞれ自分のClaude Desktopで接続する必要がある場合があります。Settings > Connectorsを開き、mablのConnectボタンをクリックしてください。

Connect to mabl in Claude Desktop

コネクタを追加できない場合

コネクタの設定ページにAddボタンが表示されない場合は、組織がカスタムコネクタの追加をアカウントのオーナーに限定している可能性があります。その場合は、組織でClaudeを管理している担当者に、代わりにコネクタを追加するよう依頼してください。

接続を確認する

mablクラウドMCPが接続されていることを確認するには、会話入力ボックスの下部にある設定アイコンをクリックします。利用可能なMCPツールが表示されます。

mabl_mcp_tools_in_claude.png

Claude Desktop で mabl MCP ツールを表示する

次のステップ

関連記事