ローカルMCPサーバーを使用すると、AIクライアントをmablのテストツールに接続でき、テストをローカルで作成・実行することから、クラウド実行での失敗を分析することまで対応しています。
前提条件
mabl MCP を設定して使用するには、MCP サーバーをサポートする AI クライアントをシステムにインストールしておく必要があります。
セットアップ
mabl MCP は、MCP サーバーをサポートするあらゆる AI クライアントと互換性があります。MCP のセットアップ手順については、使用している AIクライアントのドキュメントを参照してください。以下のタブセクションでは、特定のクライアント向けに mabl MCP を構成する方法を案内します。
設定
システムのメニューバーから Claude Desktop の設定を開き、Claude Desktop に mabl MCP サーバーを追加するには、Claude > Settings… を選択してください。
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
mabl MCP サーバーを設定するには、次の JSON を追加してください。
{
"mcpServers": {
"mabl-local": {
"command": "npx",
"args": ["@mablhq/mabl-cli@latest", "mcp", "start"],
"env": {}
}
}
}サーバーを開始する
mabl MCP サーバーがインストールされていることを確認するには、Claude Desktop を一度終了して再起動してください。会話入力ボックス下部の設定アイコンをクリックすると、利用可能な mabl MCP ツールが表示されます。
Claude Desktop で mabl MCP ツールを表示する
トラブルシューティング
セットアップが完了しなかった場合は、次のステップでトラブルシューティングしてください。
Claude Desktop のエラーを確認する
起動時に、Claude はエラーをトーストメッセージとして表示します。トーストメッセージをクリックすると、エラーの詳細や開発者設定からログを確認できます。または、Claude デスクトップのメニューバーからもアクセスできます：Settings > Developer。
「mabl」または「MCP」を含むエラーメッセージを探してください。よくある課題は次のとおりです:
- 「Command not found」もしくは「No such file or directory」
- 「Permission denied」
- 接続タイムアウトエラー
構成を確認する
claude_desktop_config.json ファイルで、パスが存在し、実行可能であることを確認してください。
競合する Node のバージョンを確認する
複数のバージョンの Node をインストールしている場合、mabl MCP サーバーを開始するときに、Claude がサポートされていないバージョンを選択することがあります。この場合は、すべてのNode のバージョンをアンインストールし、LTS バージョンを再インストールしてください。
Claude DesktopでのMCPサーバーの管理の詳細については、公式ドキュメントを参照してください。
開始する前に、GitHub Copilotが有効になっており、VS CodeでGitHubアカウントにサインインしていることを確認してください。
設定
VS CodeにmaблのMCPをインストールするには、セットアップページにアクセスし、以下のオプションのいずれかを選択してください。
- Install - VS Code のユーザー プロファイルに mabl MCP をインストールし、ローカル マシン上のすべてのプロジェクトで使えるようにします。
- Install in Workspace - 共有プロジェクトなど、特定のワークスペース向けに mabl MCP を構成します。
または、mabl MCPを手動でインストールする場合は、次の設定ブロックを使用してください。
{
"inputs": [],
"servers": {
"mabl-local": {
"type": "stdio",
"command": "npx",
"args": [
"@mablhq/mabl-cli@latest",
"mcp",
"start"
]
}
}
}サーバーを開始する
mabl MCP サーバーを開始するには、"servers" オブジェクト内の開始ボタンをクリックしてください。
mabl MCPの使用を開始する前に、GitHub Copilotのチャットがエージェントモードになっていることをご確認ください。
VS CodeでのMCPサーバーの管理の詳細については、公式ドキュメントを参照してください。
設定
Cursorのユーザープロファイルにmabl MCPをインストールするには、セットアップページにアクセスし、インストールボタンをクリックしてください。
または、共有プロジェクトなど特定のプロジェクトで mabl MCP を設定したい場合は、プロジェクトディレクトリのルートに.cursor/mcp.json という名前のファイルを作成し、次の設定ブロックを追加してください。
{
"mcpServers": {
"mabl-local": {
"command": "npx",
"args": [
"@mablhq/mabl-cli@latest",
"mcp",
"start"
]
}
}
}ファイルを保存すると、Cursor が mabl MCP を自動検出し、有効化できます
CursorでのMCPサーバーの管理の詳細については、公式ドキュメントを参照してください。
設定
MCPサーバーをサポートする任意のAIクライアントから接続することもできます。セットアップについてはクライアントのMCPドキュメントを参照し、mabl MCPサーバーを追加する際は以下の設定を使用してください。
{
"mcpServers": {
"mabl-local": {
"command": "npx",
"args": ["@mablhq/mabl-cli@latest", "mcp", "start"],
"env": {}
}
}
}認証
mabl MCPを使用する前に、mabl CLIでユーザーのクレデンシャルを使ってログインしている必要があります。まだmabl CLIで認証されていない場合は、AIクライアントがその手順を案内します。
または、mabl auth loginコマンドを使ってターミナルから手動で認証することもできます。
使用状況
MCP を使うと、技術的なコマンドではなく、対話形式でタスクを進められます。AI チャットで、次のように mabl MCP と対話するための自然言語のプロンプトを送信し始めてください。
- 「自分のmablワークスペースに、…を検証するテストはありますか？」
- 「そのテストの最新結果を取得します。」
- 「そのテストをローカルで実行できますか？このURLを使ってください…」
サポートされているアクションの完全なリストについては、mabl local MCPツールに関する記事をご覧ください。