mabl MCPサーバーの開始方法

設定

mabl MCPサーバーをClaude Desktopに追加するには、システムのメニューバーからClaude Desktopの設定を開いてください：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": {
      "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 に mabl MCP をインストールするには、セットアップページにアクセスして、次のいずれかのオプションを選択してください。

• Install - VS Code のユーザー プロファイルに mabl MCP をインストールし、ローカル マシン上のすべてのプロジェクトで使えるようにします。
• Install in Workspace - 共有プロジェクトなど、特定のワークスペース向けに mabl MCP を構成します。

または、mabl MCP を手動でインストールしたい場合は、次の設定ブロックを使用してください。

{
    "inputs": [],
    "servers": {
        "mabl": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "@mablhq/mabl-cli@latest",
                "mcp",
                "start"
            ]
        }
    }
}

サーバーを開始する

mabl MCP サーバーを開始するには、"servers" オブジェクト内の開始ボタンをクリックしてください。

mabl MCP を使い始める前に、GitHub Copilot チャットが「エージェント」モードに設定されていることを確認してください。
VS Code で MCP サーバーを管理する詳細については、公式ドキュメントを参照してください。

設定

Cursor でユーザープロファイル向けに mabl MCP をインストールするには、セットアップページにアクセスし、Installボタンをクリックしてください。

または、共有プロジェクトなど特定のプロジェクトで mabl MCP を設定したい場合は、プロジェクトディレクトリのルートに.cursor/mcp.json という名前のファイルを作成し、次の設定ブロックを追加してください。

{
    "mcpServers": {
        "mabl": {
            "command": "npx",
            "args": [
                "@mablhq/mabl-cli@latest",
                "mcp",
                "start"
            ]
        }
    }
}

ファイルを保存すると、Cursor が mabl MCP を自動検出し、有効化できます
Cursor で MCP サーバーを管理する詳細については、公式ドキュメントを参照してください。

設定

MCP サーバーをサポートする任意の AI クライアントから接続することもできます。セットアップについてはクライアントの MCP ドキュメントに従い、mab MCP サーバーを追加する際は以下の設定を使用してください:

{
  "mcpServers": {
    "mabl": {
      "command": "npx",
      "args": ["@mablhq/mabl-cli@latest", "mcp", "start"],
      "env": {}
    }
  }
}