VS Codeユーザー向け

Copilotはワークスペースを見る。Maguyvaはリポジトリを地図にする。

VS Codeのエージェントが読むのは、あなたが添付したファイルと、自分で検索したファイルだけです。Maguyvaはリポジトリ全体をインデックス化してMCPで返すので、エージェントは編集の前に、シンボルがどこにあり誰が呼んでいるかを尋ねられます。

無料で始める VS Codeのセットアップを読む

Freeプラン:リポジトリ3個, インデックス済みリポジトリ行数、最大5万行、カード不要。

.vscode/mcp.jsonにserversエントリを1つ。URLとAuthorizationヘッダーだけです。

VS Codeについて知っておくこと

VS Code特有の4つの事実。

// 設定ファイル

.vscode/mcp.json

サーバーはmcpServersではなくserversの下に置きます。すべてのワークスペースで使うには、MCP: Open User Configurationを実行し、プロファイルのmcp.jsonに同じエントリを追加します。

// トランスポート

type: http

VS CodeはMaguyvaのエンドポイントにStreamable HTTPで接続し、サーバーが対応していない場合に限りSSEにフォールバックします。ローカルでは何も動きません。

// キー

環境変数の参照

ヘッダーはBearer ${env:MAGUYVA_API_KEY}です。VS Codeは起動時の環境からこれを解決するので、キーはコミットするファイルに入りません。入力を求められる方式がよければ、入力変数を使うと一度だけ尋ねてキーを保存します。

// 信頼

ワークスペースの信頼

ワークスペースを信頼すると、.vscode/mcp.jsonのサーバーは別の確認なしで起動します。制限モードでは起動しません。チャット入力のConfigure Toolsで、ツールを1つずつオン・オフできます。

カスタム指示は作業上の取り決めです。活用しましょう。

# .github/copilot-instructions.md
- 変更を完了とする前に npm test を実行する。
- src/gen/ 以下の生成ファイルは編集しない。

VS Codeはプロジェクト全体の指示を.github/copilot-instructions.mdまたはAGENTS.mdから、対象を絞った指示をapplyToパターン付きの.github/instructions/*.instructions.mdファイルから読み込みます。用途は次のとおりです。

ビルド、テスト、lintのコマンド。
エージェントが何度も間違える規約。
エージェントに触らせたくないフォルダー。

指示はエージェントに働き方を伝えます。これから名前を変える型を4,000ファイルのうちどれがインポートしているかは、教えられません。

ワークスペースの視界が尽きるところ

開いているファイルからは、エージェントが学べない3つのこと。

// 添付がすべてではない

エージェントは、あなたが添付したものと検索結果をもとに動きます。変更後に壊れる別パッケージの呼び出し元は、どちらのリストにも入っていませんでした。

// 文字列一致は参照ではない

ワークスペース検索は文字列を見つけます。本物の呼び出しと、コメント、モック、別クラスの同名メソッドを区別することはできません。

// 読むたびにコンテキストを消費する

状況把握のためにエージェントが開くファイルは、変更に必要なコンテキストを削っていきます。file:line付きのランク済み回答1つは、探索的な読み込み10回より安く済みます。

VS CodeのMCPサーバーとしてのMaguyva

serversエントリ1つで、エージェントが得るもの:

インデックス済みリポジトリに対する11個のツール セマンティック、構造（AST）、グラフ、テキスト検索に加え、シンボル検索、依存元、ファイル取得。
ファイルパスと行番号付きの回答 285以上の言語に対応。エージェントは最初から正しいファイルを開けます。
読み取りだけのツール Maguyvaのツールはインデックスを照会するだけです。ファイルを編集するツールはないので、承認するのは常に読み取りで、書き込みではありません。

VS Codeはエージェントにワークスペースを与える。
Maguyvaはエージェントにリポジトリの地図を与える。

2つのワークフロー

まず地図に聞き、それから編集する。

// workflow 01

パーサーを変える前にテストを見つける

vscode agent> parseConfigを通るテストはどれ?

dependency_search("parseConfig", dependents)
  tests/config/parse.test.ts:12
  tests/cli/flags.test.ts:88

→ エージェントは編集後、スイート全体ではなくこの2ファイルを実行します。
[exit 0]

回答がパーサーに届く2つのテストファイルを名指しするので、エージェントは壊れうる場所で変更を確かめます。

// workflow 02

最初の編集の前にリネームの規模を測る

vscode agent> OrderStatus.PENDINGをOrderStatus.QUEUEDにリネームして

find_symbol("OrderStatus", references)
  9ファイルに23件の参照

→ エージェントは9ファイルを1回で処理する計画を立てます。
[exit 0]

参照の数は、型チェックが失敗した後ではなく、編集の前に届きます。

VS Codeでのセットアップ

3ステップ。Freeプラン:リポジトリ3個, インデックス済みリポジトリ行数、最大5万行、カード不要。

// step 01

maguyva.aiでリポジトリをインデックス化

回答を評価できるよう、すでによく知っているリポジトリを選びましょう。

// step 02

.vscode/mcp.jsonにMaguyvaを追加

.vscode/mcp.json

{
  "servers": {
    "maguyva": {
      "type": "http",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}

// step 03

キーを設定してサーバーを起動する

VS Codeを起動する環境でMAGUYVA_API_KEYを設定し、エントリの上のコードレンズからサーバーを起動します。答えをすでに知っている質問をエージェントに1つしてみましょう。