zhineng.dev
日本語
使ってみる

Getting started / start small

環境の準備から、
初めての接続まで。

拡張機能と MCP は別々に導入できます。小さなタスクをテスト環境で検証し、徐々に日常作業へ取り入れてください。

01 / VS Code 拡張機能を導入

VS Code Marketplace で検索： Claude Code Config Helper。発行元を確認： liliangshan。公開版はページを参照。ローカルテスト版とは異なる場合があります。

Marketplace を開くソースコードと説明

VSIX からも導入可能

VSIX がある場合は「拡張機能 → … → VSIX からインストール」で選択。再読み込みは実行中の CLI を中断するため、都合のよい時に行ってください。

02 / 3 ステップの初期設定

  1. 言語を選び CLI を準備ガイドで CLI を取得・検証するか既存ファイルを選択。既定は公式配布元で、中国ミラーは明示的に選びます。
  2. プロバイダーとモデルを追加サービス URL、認証、API キーを設定し、モデルを取得または手動追加。初期設定に有料のテスト送信は不要です。
  3. モデルを選んでチャットへ通常モデル、任意のフロー・圧縮モデル、思考レベルを設定。右にメイン、並列セッションを押すと左に独立セッションが開きます。
現環境に全体の完了記録がないとガイドを表示。既存 CLI やプロバイダーは補完されますが、自動完了にはなりません。料金はサービス次第です。

03 / ツールを選んで設定をコピー

ローカル設定例の生成のみ。サーバー接続、パスワード収集、npm 導入はしません。例の URL やパスを置き換え、認証情報はクライアントで設定してください。

.mcp.json
{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@liangshanli/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "db.example.com",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "ai_reader",
        "MYSQL_PASSWORD": "${MYSQL_PASSWORD}",
        "MYSQL_DATABASE": "app_db",
        "MYSQL_SSL": "true",
        "READONLY": "true",
        "ALLOW_DDL": "false",
        "ALLOW_DROP": "false",
        "ALLOW_DELETE": "false"
      }
    }
  }
}

MySQL 例は読み取り専用と TLS を有効にします。読み取り専用アカウントを使い、ホスト名と DB 証明書の一致を確認してください。

変数と設定形式の違い

  • Claude Code：使用： mcpServers、プロジェクト直下の .mcp.json。例の ${MYSQL_PASSWORD} などは起動時に利用可能な環境変数に依存します。クライアントの規則を確認してください。
  • VS Code 標準 MCP：使用： servers、保存先は .vscode/mcp.json。パスワードはサイトの入力欄ではなく VS Code の入力プロンプトを使用。
  • Cursor：保存先は .cursor/mcp.json、使用する項目は mcpServers。環境変数の展開はバージョン次第。未展開のプレースホルダーをパスワードとして使わないでください。
  • この拡張機能：標準の .mcp.json は CLI が検出。--strict-mcp-config は読み込み元を制限。VS Code 設定の読み込みは標準入力変数の解決とは異なるため、Claude Code 形式を推奨します。

既存設定は必要な server 項目だけ統合し、全体を上書きしないでください。Windows で npx を起動できない場合は Node.js 絶対パスとパッケージ入口を使い、npm 文書を確認してください。

04 / ツールの動作を確認

  1. ローカル環境を確認対応 Node.js を導入。SSH は 20+ 必須。他は npm 文書で確認し、クライアントが node / npx を見つけられることを確認。
  2. MCP 再接続または CLI 再起動保存後、ツールを再読み込み。この拡張機能では該当側 CLI を再起動し、重要な実行中タスクがないか確認してください。
  3. 影響の小さい操作からまず一覧と接続を確認し、DB スキーマ、Redis テストキー、自分の API の GET を試してください。

タスクの指示例：

最初のタスク · プロンプト例
現在の MCP ツールが利用可能か確認してください。
テスト DB の構造だけを読み、テーブルの関係を説明してください。
データや構造は変更せず、接続や権限が不足していれば先に教えてください。

05 / 機能を増やす前に境界を

最小権限

DB は読み取り専用か低権限専用アカウント、SSH は専用アカウントと信頼済み指紋、API はメソッド制限を使います。プロンプトは基盤の権限を代替できません。

認証情報はローカルに

このサイトに秘密情報を送信しないでください。必要に応じて設定を Git 除外し、ログやモデル出力は共有前に確認してください。

bypassPermissions は CLI の一部確認を省略しますが、DB やシステム権限を増やさず、接続失敗も直しません。信頼できる環境のみで使ってください。

06 / MCP ツールが見つからない？

  • ファイル名、場所、最上位フィールドがクライアントに合うか確認。
  • JSON、パッケージ名、起動コマンドの検出を確認。
  • ワークスペースの信頼、MCP 承認、厳格モード、ツール設定を確認。
  • DB / SSH / API の接続先、ネットワーク、認証、サーバー権限を確認。
  • 該当 CLI を再起動してログを確認。秘密情報を含む設定を公開の場に貼り付けないでください。
その他のよくある質問 ↗