Nexus MCP サーバーへの接続方法

本記事では、Claude Desktop、Cursor、VS Code などの MCP 対応 AI クライアントから Autify Nexus の MCP サーバーへ接続するための手順を説明します。MCP サーバーの概要や提供されているツールについては、Nexus MCP サーバーとはを参照してください。

前提条件

• Nexus のリモートワークスペースを利用していること

• API クライアントを発行できる権限を持つアカウントを保有していること (通常はワークスペース管理者)

• MCP に対応した AI クライアント (Claude Desktop / Cursor / VS Code など) がインストールされていること

ステップ 1: API クライアントシークレットを発行する

MCP サーバーへの接続には、Nexus の API クライアントシークレットを Bearer トークンとして使用します。API クライアントの作成方法とシークレットの取得方法については、Obtain the client secretを参照してください。

ステップ 2: MCP エンドポイント URL を確認する

MCP サーバーへの接続 URL は、ワークスペースのサーバー URL に /nexus/mcp パスを付与したものです。

1. デスクトップアプリの左下にある歯車アイコンから設定を開きます。

2. 「アカウント」セクションに表示されている 「サーバー URL」 をコピーします。

3. コピーした URL の末尾に /nexus/mcp を付与した URL が、MCP サーバーの接続先となります。
   例: https://<organization-id>.cloud.autify.com/nexus/mcp

以降の手順では、サーバー URL のサブドメインを <your-org-id>、ステップ 1 で取得した API クライアントシークレットを <your-client-secret> として表記します。実際に設定する際は、ご自身の値に置き換えてください。

ステップ 3: AI クライアントを設定する

利用する AI クライアントの設定ファイルに、MCP サーバーの URL と認証情報を登録します。

Claude Desktop

設定ファイル:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Desktop のメニューから設定 → 開発者 → 設定を編集 をクリックすると、設定ファイルが作成・展開されます。以下のエントリを追加します。

{
  "mcpServers": {
    "nexus": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<your-org-id>.cloud.autify.com/nexus/mcp",
        "--header",
        "Authorization: Bearer <your-client-secret>"
      ]
    }
  }
}

補足:

• 設定を保存後、アプリを再起動してください。

Cursor

設定ファイル:

• プロジェクト単位: プロジェクトルート直下の .cursor/mcp.json

• ユーザー単位 (全プロジェクト共通): ~/.cursor/mcp.json

Cursor の「Cursor Settings」→「MCP」から「Add new MCP server」を選択して GUI で追加することもできます。以下のエントリを追加します。

{
  "mcpServers": {
    "nexus": {
      "url": "https://<your-org-id>.cloud.autify.com/nexus/mcp",
      "headers": {
        "Authorization": "Bearer <your-client-secret>"
      }
    }
  }
}

VS Code

設定ファイル:

• ワークスペース単位: ワークスペースルート直下の .vscode/mcp.json

• ユーザー単位: ユーザー settings.json の "mcp" セクション

コマンドパレット (Cmd/Ctrl + Shift + P) から「MCP: Add Server」を実行して追加することもできます。以下のエントリを追加します。

{
  "mcp": {
    "servers": {
      "nexus": {
        "type": "http",
        "url": "https://<your-org-id>.cloud.autify.com/nexus/mcp",
        "headers": {
          "Authorization": "Bearer <your-client-secret>"
        }
      }
    }
  }
}

補足:

• VS Code から MCP サーバーを利用するには、GitHub Copilot Chat 拡張機能 (または同等の MCP 対応拡張機能) のインストールが必要です。

ステップ 4: 接続を確認する

接続が成功すると、AI クライアントから Nexus の MCP ツールが利用可能になります。最初の動作確認には、読み取り専用の list_workspaces ツールが便利です。AI クライアントに次のように依頼してみてください。

「Nexus の list_workspaces ツールを実行して、アクセスできるワークスペースの一覧を表示してください。」

ワークスペースの一覧が返ってくれば、接続は正常に確立されています。

制限事項

• レート制限: IP アドレスごとに 1 秒あたり 10 リクエストまでです。これを超えた場合、HTTP 429 が返されます。

• モバイルアプリテスト関連のツールは、対応するライセンスが付与されている場合のみ利用可能です。

• ローカルワークスペースに対する MCP 接続はサポートされていません。

トラブルシューティング

関連記事

• Nexus MCP サーバーとは