本文へスキップ

クイックスタート

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

1. APIキーを取得#

無料で始める — クレジットカード不要。APIキー（mgv_で始まります）はapp.maguyva.aiにあります。

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

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

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

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

/plugin marketplace add maguyva/claude-code-plugin
/plugin install maguyva@maguyva

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

export MAGUYVA_API_KEY=mgv_xxxx

チームで作業していますか？/pluginコマンドの両方に--scope projectを追加すると、プラグインがリポジトリの.claude/settings.jsonにコミットされ、チームメイトに自動で反映されます。

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

.cursor/mcp.json
{
  "mcpServers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

設定の形はクライアントごとに少し異なります（VS Codeはtype: "http"でserversの下にネスト、WindsurfはserverUrlを使用、Zedはcontext_serversを使用）。mgv_xxxxをAPIキーに置き換えてクライアントを再起動してください。ドキュメント化された全24クライアントの詳細な設定はインストールガイドにあります。

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

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

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

結果が返ってこない、接続エラーが出る？トラブルシューティングへ — 失敗のほとんどはAPIキー未設定、npxがない、またはリポジトリのインデックスが未完了のいずれかです。

次のステップ#