DXT よくある質問

DXT（Desktop Extensions）に関するよくある質問をまとめました。

DXT とは何ですか？

DXT（Desktop Extensions）は、Claude デスクトップアプリケーションを拡張するためのフレームワークです。MCP サーバーをベースにしており、Claude に新しい機能やツールを追加できます。

DXT の設定方法

1. Claude Desktop アプリのインストール

まず、Claude Desktopをダウンロードしてインストールします。

2. 設定ファイルの場所

Claude Desktop の設定ファイルは以下の場所にあります：

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

3. DXT の追加

設定ファイルに以下のような形式で DXT を追加します：

json
{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": [
        "/path/to/google-analytics/server/index.js",
        "--key-file=/path/to/service-account.json",
        "--property-id=123456789"
      ]
    }
  }
}

トラブルシューティング

Q: DXT が認識されません

A: 以下を確認してください：

  1. パスが正しいか確認

    bash
    # ファイルの存在確認
ls -la /path/to/your/dxt/server/index.js

  2. Node.js のバージョン確認

    bash
    node --version
# v18.0.0以上が必要

  3. 依存関係のインストール

    bash
    cd /path/to/your/dxt
npm install

Q: 権限エラーが発生します

A: 以下を試してください：

  1. 実行権限の付与

    bash
    chmod +x /path/to/your/dxt/server/index.js

  2. 設定ファイルの権限確認

    bash
    ls -la ~/Library/Application\ Support/Claude/claude_desktop_config.json

Q: 環境変数が読み込まれません

A: 環境変数の設定方法：

  1. 設定ファイルで直接指定

    json
    {
  "mcpServers": {
    "your-dxt": {
      "command": "node",
      "args": ["server/index.js"],
      "env": {
        "API_KEY": "your-api-key",
        "DATABASE_URL": "your-database-url"
      }
    }
  }
}

  2. dotenv ファイルの使用

    bash
    # .envファイルを作成
echo "API_KEY=your-api-key" > .env

人気の DXT

1. Google Analytics MCP

  • 機能: GA4 データの取得・分析
  • 用途: ウェブサイトの分析、レポート作成
  • 設定: サービスアカウントキーが必要

2. Chrome AppleScript

  • 機能: Chrome ブラウザの制御
  • 用途: タブ管理、ページ操作
  • 設定: macOS のみ対応

3. File System MCP

  • 機能: ファイル操作、ディレクトリ管理
  • 用途: ファイル検索、テキスト処理
  • 設定: パス権限の設定が必要

セキュリティについて

データの安全性

  • ローカル実行: DXT はローカルで実行され、データは外部に送信されません
  • 権限管理: 必要最小限の権限のみ付与してください
  • API キー: 環境変数で管理し、設定ファイルに直接記載しないでください

推奨事項

  1. 定期的な更新: DXT を最新バージョンに保つ
  2. 権限の確認: 不要な権限は削除する
  3. ログの監視: 異常な動作がないか確認

DXT の開発

開発環境の構築

  1. テンプレートの使用

    bash
    npx @anthropic-ai/dxt create my-extension

  2. 開発サーバーの起動

    bash
    npm run dev

  3. ビルドとパッケージ化

    bash
    npm run build
npx @anthropic-ai/dxt pack

公開方法

  1. GitHub リポジトリの作成
  2. README.md の作成
  3. DXT Directory への登録申請

サポート

コミュニティ

  • GitHub Discussions: 質問や議論
  • Discord: リアルタイムサポート
  • Reddit: r/ClaudeAI

問題の報告

  1. GitHub Issues: バグ報告、機能要求
  2. 詳細な情報: OS、Node.js バージョン、エラーメッセージ
  3. 再現手順: 問題の再現方法

参考資料

その他の質問がある場合は、GitHub Issues でお気軽にお聞きください。