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

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

Molly Exten
  • 更新

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

前提条件

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

セットアップ

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

  • OAuth - クラウドMCPをmablユーザーアカウントに接続し、そのユーザーが所属するすべてのワークスペースにアクセスできます。どちらの方式を選べばよいかわからない場合は、こちらから始めてください。
  • APIキー- mabl APIキーを使用してクラウドMCPに接続します。アクセスは、キーが生成された単一のワークスペースに限定されます。エージェント間のユースケースに最適です。

OAuthのセットアップ

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

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

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

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

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

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

すべてのクライアントがJSON設定を使用するわけではありません。リモートMCPサーバーの追加方法については、お使いのAIクライアントのドキュメントをご参照ください。お使いのAIクライアントがHTTPをサポートしていない場合は、他のセットアップ方法について代替トランスポートのセクションをご覧ください。

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

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

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

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

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

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

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

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

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

APIキーのセットアップ

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の文字列については、クライアントのドキュメントを確認してください。

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}"のように指定します。

お使いのAIクライアントがHTTPをサポートしていない場合は、他のセットアップ方法について代替トランスポートのセクションをご覧ください。

代替トランスポート

お使いのAIクライアントがHTTPをサポートしていない場合は、SSEまたはstdioブリッジをお試しください。たとえば、Claude Desktopはstdioブリッジをサポートしています。どちらのオプションも、OAuthおよびAPIキー認証方式に対応しています。

SSE設定

クライアントのMCP設定に以下を追加してください。

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

APIキー認証を使用する場合は、urlと並べてheadersオブジェクトを追加し、APIキーのセットアップパターンに従ってください。

stdio ブリッジ

HTTP または SSE トランスポートを使用できない場合は、mcp-remote などのパッケージを使用して、クライアントの stdio トランスポートとサーバーの SSE トランスポートをブリッジできます。mcp-remote は mabl が管理するものではなく、サードパーティのオープンソースパッケージです。

クライアントのMCP設定に以下を追加してください。

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

APIキー認証を使用する場合は、argsの配列に追加エントリとして"--header"と"x-api-key:YOUR_API_KEY_HERE"を追加し、YOUR_API_KEY_HEREを編集者または閲覧者のmabl APIキーに置き換えてください。

次のステップ

関連記事