# インストールガイド

Canonical source: https://maguyva.ai/ja/docs/installation

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).

5分足らずで使い始められます。このガイドにはClaude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex CLI, GitHub Copilot CLI, Gemini CLI, Cline, Goose, Continue, LM Studio, Kiro CLI, JetBrains, Zed, Trae, OpenCode, BoltAI, LibreChat, Antigravity, Claude Cowork, ChatGPT、Warpを含む23件のMCPクライアント向けセットアップが含まれています。

**前提条件**: [app.maguyva.ai](https://app.maguyva.ai)から取得したAPIキーと、接続済みのGitHubリポジトリが必要です。

## 環境のセットアップ

まず、API キーを環境変数に設定します。MCP クライアントがリクエストの既定値を提供する場合、またはキーがアクセスできるリポジトリが一つだけの場合は `repository` を省略し、それ以外では明示的に渡します。

### macOS/Linux (Bash/Zsh)

```bash
export MAGUYVA_API_KEY="mgv_xxxx"
```

### Windows (PowerShell)

```powershell
'$Env:MAGUYVA_API_KEY="mgv_xxxx"' | Out-File -Append $PROFILE
. $PROFILE
```

`mgv_xxxx`を、[app.maguyva.ai](https://app.maguyva.ai)から取得した実際のAPIキーに置き換えてください。

## クライアント設定

以下から使用するMCPクライアントを選んで、具体的なセットアップ手順を確認してください。

```json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MAGUYVA_API_KEY}"
      }
    }
  }
}
```

Maguyvaは標準のMCPを使用しています。上記に専用ガイドがなくても、プロトコルに対応するクライアントであれば接続できます。現在23件のクライアントがドキュメント化されており、随時追加されています。

## セットアップを検証する

接続後、エージェントにいくつか質問してみてください:

- "接続しているリポジトリはどれですか?" — 接続が機能しているかを確認する
- "このコードベースでは認証がどう処理されていますか?" — セマンティック検索をテストする
- "データベースを呼び出しているすべての関数を見つけて" — 依存関係検索をテストする
- "UserServiceクラスは何に依存していますか?" — シンボルルックアップをテストする

接続済みリポジトリのファイルパスと行番号付きの結果が返ってくるはずです。返ってこない場合は、下の[troubleshooting](https://maguyva.ai/ja/docs/troubleshooting)を確認してください。

## リポジトリ形式

リポジトリを指定する際は:

- ブランチ指定あり: `"owner/repo:branch"` (e.g. `"owner/repository:develop"`)
- デフォルトブランチ: `"owner/repo"`

**ヒント**: `repository_context(action="info", repository="...")` でリポジトリ名の解決を確認できます。リポジトリの上書き指定は、その呼び出しにのみ適用されます。

## トラブルシューティング

### APIキーの問題

- キーがmgv_で始まっているか確認する
- キーが環境に正しく設定されているか確認する
- キーの有効期限が切れていないか確認する

### リポジトリが見つからない

- app.maguyva.aiでリポジトリが接続されているか確認する
- owner/repo形式が正しいか確認する
- リポジトリへのアクセス権があるか確認する

### MCP接続の問題

- クライアントで @maguyva/mcp ブリッジを使う場合は、PATH から npx を実行できることを確認してください
- APIトークンが有効で、期限切れでないか確認する
- https://maguyva.tools/mcpへの接続をテストする
- クライアントのMCP設定構文を確認する

## 次のステップ

- MCP APIリファレンス: 完全なAPIドキュメント
- 仕組み: コンテキスト最適化を理解する
- トラブルシューティング: セットアップと接続の問題を解決する