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

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

Molly Exten
  • 更新

クラウドMCPサーバーを使用すると、mabl CLIを使わずにAIクライアントをmablに接続できます。サーバーオプションの概要については、mablのMCP概要を参照してください。

前提条件

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

セットアップ

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

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

設定

多くの 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では、ターミナルで次のコマンドを実行することもできます。

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

すべてのクライアントがJSON設定を使用するわけではありません。リモートMCPサーバーの追加手順については、お使いのAIクライアントのドキュメントを参照してください。

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

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

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

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

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

利用可能なすべてのワークスペースを一覧表示するには、get_workspaces ツールを使用してください。例：

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

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

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

設定

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

{
  "mcpServers": {
    "mabl": {
      "url": "https://mcp.mabl.com/mcp",
      "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"

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

設定

mabl MCPサーバーをClaude Desktopに追加するには、システムのメニューバーからClaude Desktopの設定を開いてください：Claude＞Settings…

claude_settings.png

Claude で設定にアクセスする

Settingsウィンドウで、Developerタブをクリックします。Edit configをクリックすると、Claude Desktopの設定ファイルが開きます。この操作により、claude_desktop_config.jsonファイルが新規作成されるか、既存のファイルが開かれます。ご利用のOSによって、このファイルは次のいずれかの場所に保存されています。

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%Claudeclaude_desktop_config.json

Claude Desktop は現在、stdio トランスポートのみをサポートしており、リモート HTTP エンドポイントにはネイティブで接続できません。Claude Desktop で mabl クラウド MCP を使用するには、mcp-remote などのブリッジを使用して、Claude のローカル stdio とリモート HTTP サーバー間の通信を変換してください。mcp-remote は mabl が管理するものではなく、サードパーティのオープンソースパッケージであり、stdio ブリッジが必要です。

OAuth 設定の場合は、Claude Desktop の MCP 設定に以下を追加してください。

"mcpServers": {
  "mabl": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://mcp.mabl.com/mcp"
    ]
  }
}

API キー認証の設定の場合は、API キーをヘッダーとして含めてください。次の設定ブロックを使用するには、YOUR_API_KEY_HERE を編集者または閲覧者の mabl API キーに置き換えてください。

"mcpServers": {
  "mabl": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://mcp.mabl.com/mcp",
      "--header",
      "x-api-key:YOUR_API_KEY_HERE"
    ]
  }
}

サーバーを開始する

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

mabl_mcp_tools_in_claude.png

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

次のステップ

関連記事