クイックスタート

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

1. APIキーを取得

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

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

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

3. クライアントを接続

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

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

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

export MAGUYVA_API_KEY=mgv_xxxx

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

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:

.cursor/mcp.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クライアントの詳細な設定はインストールガイドにあります。

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

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

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

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

次のステップ

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