Claude Desktopユーザー向け

Claude Desktopにはリポジトリが見えない。見せてあげよう。

Claude Desktopは、今は編集していないコードについて多くの人が質問する場所です。レビュー、オンボーディング、インシデント対応の通話。Maguyvaはリポジトリをインデックス化してMCP経由で提供するので、回答は記憶ではなくファイルと行を引用します。

無料で始める Claude Desktopのセットアップを読む

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

チェックアウト不要。インデックスに聞くだけ。

Claude Desktopについて知っておくこと

Claude Desktop特有の4つの事実。

// 設定ファイル

claude_desktop_config.json

Settings → Developer → Edit Configで開きます。macOSでは~/Library/Application Support/Claude/、Windowsでは%APPDATA%\Claude\にあります。

// トランスポート

ローカルブリッジ

このファイルはローカルプロセスを起動するため、このガイドでは@maguyva/mcpをnpxで実行します。Node.jsが必要です。

// キー

envのエントリ

ブリッジは同じファイル内のサーバーのenvブロックからMAGUYVA_API_KEYを読み取ります。

// 再起動

終了して、開き直す

Claude Desktopは起動時にこのファイルを読みます。編集したらアプリを完全に終了してください。次の起動時にサーバーが立ち上がります。

プロジェクトの指示が前提を決めます。使いましょう。

Claudeのプロジェクトには、プロジェクト内のすべてのチャットが最初に受け取る指示とファイルを保存できます。向いているのは:

回答の読み手: レビュアー、新メンバー、オンコールのエンジニア。
説明や要約のハウススタイル。
引用してほしい少数のドキュメント。たとえばアーキテクチャの概要。

アップロードしたファイルはスナップショットです。リポジトリはアップロードの翌日にはもう先に進んでいます。

貼り付けたコードの限界

コード抜きでコードについて話すと、チャットがつまずく3つのパターン。

// 貼ったスニペットは古くなる

先週チャットに貼ったファイルは、先週のコードを説明しています。Claudeは渡されたバージョンをもとに自信満々に答えます。

// スニペットはシステムではない

“これが失敗したら何が起きる?”に1つのファイルで答えられることはまれです。ハンドラ、リトライ、アラートは、たいてい3つの別々のパッケージにあります。

// チェックアウトなし、grepなし

Claude Desktopはリポジトリの作業コピーを持っていません。ツールがなければ、構造についての回答はすべて、あなたが貼り忘れなかったものに左右されます。

Claude DesktopのMCPサーバーとしてのMaguyva

mcpServersのエントリ1つで、Claudeが得られるもの:

インデックス済みリポジトリに対する11個のツール セマンティック、構造（AST）、グラフ、テキスト検索に加え、シンボル検索、依存元、ファイル取得。
ファイルパスと行番号付きの回答 285以上の言語に対応。すべての主張を自分で確認できます。
ブランチを認識する結果 だから、Claudeは先月誰かがアップロードしたファイルではなく、あなたが指定したブランチについて答えます。

プロジェクトの指示は、Claudeに答え方を教える。
Maguyvaは、Claudeに答えの拠り所となるコードを与える。

2つのワークフロー

普段ならIDEを開いて確かめる質問。

// workflow 01

レビュー中にコードパスを説明する

claude> 決済Webhookの署名チェックが失敗したら、その後どうなる?

semantic_search("webhook signature verification failure")
  src/payments/webhooks.ts:64   verifySignature()
  src/payments/webhooks.ts:91   rejectAndAlert()

→ Claudeは両方の行を引用して答えます。
[exit 0]

回答の各ステップが、開いて確かめられるファイルと行を指しています。

// workflow 02

計画する前に変更の規模を見積もる

claude> 古いplan_codeフィールドを読んでいる箇所はいくつある?

text_pattern_search("plan_code")
  9ファイルで14件
dependency_search("getPlanCode", dependents)
  呼び出し元6件

→ 見積もりは当て推量ではなく件数から始まります。
[exit 0]

誰もリポジトリを開いていない計画会議で役立ちます。

Claude Desktopでのセットアップ

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

// step 01

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

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

// step 02

claude_desktop_config.jsonにMaguyvaを追加

claude_desktop_config.json

{
  "mcpServers": {
    "maguyva": {
      "command": "npx",
      "args": [
        "-y",
        "@maguyva/mcp"
      ],
      "env": {
        "MAGUYVA_API_KEY": "mgv_xxxx"
      }
    }
  }
}

// step 03

プレースホルダーを置き換え、再起動して、質問を1つしてみる

mgv_xxxxをあなたのAPIキーに置き換え、Claude Desktopを完全に終了してから開き直します。サーバーが表示されない場合は、Claudeのログフォルダ（macOSでは~/Library/Logs/Claude）にあるmcp-server-maguyva.logを確認してください。