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

Canonical source: https://maguyva.ai/ja/for-claude-desktop

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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

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

## 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を開いて確かめる質問。

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

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

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

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

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

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

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

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

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

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

## Claude Desktopでのセットアップ

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

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

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

### 02. claude_desktop_config.jsonにMaguyvaを追加

`claude_desktop_config.json`

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

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

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

[ローカルサーバーに関するMCPガイド](https://modelcontextprotocol.io/docs/develop/connect-local-servers)に、設定ファイルとログの詳しい説明があります。

## すでに知っているリポジトリを1つインデックス化。

MCP経由でClaude Desktopを接続し、確認できる質問を1つしてみましょう。