# クイックスタート

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

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

検証済みの回答までの最短ルート: キーを取得し、既に知っているリポジトリを1つインデックスし、クライアントを接続して、答えが分かっている質問を1つ投げてみる。

## 1. APIキーを取得

[無料で始める](https://app.maguyva.ai)(クレジットカード不要)。APIキー(`mgv_`で始まります)は[app.maguyva.ai](https://app.maguyva.ai)にあります。

## 2. 既に知っているリポジトリをインデックス

ポータルからGitHubリポジトリを接続してインデックスさせましょう。素早く目視確認できる小さなリポジトリを選びましょう。そうすれば、初日から会社全体をインデックスしようとするより、Maguyvaがモデルを根拠づけているかどうかがはっきり分かります。

## 3. クライアントを接続

Claude Codeの場合、マーケットプレイスからMaguyvaプラグインをインストールします。各コマンドはClaude Code内で実行してください:

```text
/plugin marketplace add maguyva/agent-plugins
/plugin install maguyva@maguyva
```

プラグインは`MAGUYVA_API_KEY`環境変数のキーで認証します。シェルに設定してください(キーはリポジトリ単位なので、プロジェクトごとの`direnv`を推奨します):

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

チームで使う場合は、`/plugin install maguyva@maguyva`で開くパネルでprojectスコープを選んでください。プラグインがリポジトリの`.claude/settings.json`に記録されるので、それをコミットします。各チームメイトも一度インストールを実行する必要があります。セッション内の`/plugin`コマンドには`--scope`フラグがないため、スクリプト化する場合はリポジトリのルートからシェル版を実行してください:

```bash
claude plugin marketplace add maguyva/agent-plugins --scope project
claude plugin install maguyva@maguyva --scope project
```

他のほとんどのクライアント(Cursor、VS Code、Devin Desktop、Zedなど)はリモートサーバーに直接接続します。`Bearer`ヘッダー付きでエンドポイントを指定するだけで、ブリッジは不要です。例えばCursorの`.cursor/mcp.json`:

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

設定の形はクライアントごとに少し異なります(VS Codeは`type: "http"`で`servers`の下にネスト、Antigravityは`serverUrl`を使用、Zedは`context_servers`を使用)。このCursorの例は、上に示した`MAGUYVA_API_KEY`環境変数からキーを読み込みます。設定に`mgv_xxxx`プレースホルダーが表示されるクライアントでは、それをAPIキーに置き換えてください。その後、クライアントを再起動します。ドキュメント化された全23クライアントの詳細な設定は[インストールガイド](https://maguyva.ai/ja/docs/installation)にあります。

## 4. 答えが分かっている質問を1つ投げる

まず**"接続しているリポジトリはどれですか?"**で接続を確認し、次にリポジトリについて、答えをすでに知っている実際の質問を1つしてみましょう。例えば、**"このコードベースでは認証がどう処理されていますか?"**などです。

ファイルパスと行番号付きの回答が返ってくるはずです。引用されたファイルを開いて、実際のリポジトリと照らし合わせても答えが崩れないか確認しましょう。この採点済みの回答1つが、どんな機能一覧よりも雄弁です。デフォルトのループに加える前に、ツールに信頼を勝ち取らせましょう。

結果が出ない、または接続エラーが起きますか? [トラブルシューティング](https://maguyva.ai/ja/docs/troubleshooting)で API キー、クライアント設定、リポジトリのインデックス作成状況を確認してください。ブリッジを使う構成では、`npx` が実行可能かも確認してください。

## 次のステップ

- インストールガイド: ドキュメント化された全23クライアント向けの設定
- 仕組み: 質問から回答までの間に何が起きるか
- MCP APIリファレンス: 全ツールをパラメータ単位で解説