# MCPを話すなら、Maguyvaも話せる。

Canonical source: https://maguyva.ai/ja/for-anything

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

統合はツールごとではなく、プロトコル単位です。Maguyvaは、ひとつのURLにある標準的なMCPサーバーです。だから、あなたのエージェントがどこで動いていても(Claude Code、Codex、Cursor、Gemini、Devin Desktop、Antigravity、Zed、Cline、あるいは自作のものでも)、同じ問い合わせ可能なリポジトリの地図を得られます。一度インデックス化すれば、接続するすべてのクライアントが、同じ根拠のある質問をできます。

> MCPサーバーはひとつ。クライアントはどれでも。ツールごとのプラグインもロックインもなし。

## 各レイヤーの役割

4つのパーツ。それぞれに役割があります。

### あらゆるMCPクライアント

23件のドキュメント化されたクライアント(Claude Code、Codex CLI、Gemini CLI、Cursor、Devin Desktop、Antigravityを含む)、または自作のエージェントにも対応。

### MCP

そのすべてが既に話している、オープンな標準規格。

### Maguyva

MCPサーバーはひとつだけ。裏付けのあるリポジトリの事実を、file:line付きで返します。

### 課金対象はワークスペース、シートではありません

エージェントはシート料金を払いません。[料金を見る](https://maguyva.ai/ja/pricing)

## MCPが統合そのものです。それを標準にしましょう。

オープンプロトコルは、次善策ではなく正解です。ツールごとのプラグインの代わりに[MCP](https://modelcontextprotocol.io/docs/getting-started/intro)の上に構築することこそ、より良いエージェントがリリースされるたびに再統合する羽目になるのを避ける方法です。以下のことを実現するのに適しています:

- 準拠するどのクライアントにも組み込める、サーバー設定ブロックひとつ。
- エディタ、CLI、エージェントを横断して持ち運べるツールとリソース。
- ベンダーごとではなく、一度で済むセキュリティチームによるレビュー境界。
- コンテキストスタックを作り直さずに、クライアントを乗り換えられる自由。

それは続けてください。MCPを標準にすることこそが、正しい一手です。

しかし、プロトコルはただの管です。質問と答えを運びますが、あなたのコードベースを*知っている*わけではありません。あなたのシンボル、呼び出し箇所、依存関係を実際にマッピングする何かが、反対側になければなりません。

## ツールごとのコンテキストが、スケールしなくなる場所

どのエージェント単体のルールファイルでも解決できない、4つの失敗モード。

### // どのツールもゼロからオンボーディングし直す

新しいエージェントを選べば、また何も見えない状態からリポジトリに向き合うことになります。同じファイルを貼り直し、同じコンテキストをピン留めし直し、同じルールを書き直す。共有レイヤーだったことが一度もないから、作業は引き継がれません。

### // ルールファイルは持ち運べない

`CLAUDE.md`、`.cursor/rules`、`AGENTS.md`は、どれもツールごとのもので、あなたのコードを問い合わせ可能にするインデックスではありません。クライアントを乗り換えれば、手作業で作った地図は置き去りになります。

### // 統合のロックインは税金だ

深いコードベースのコンテキストを、ひとつのベンダーのプラグインに組み込むということは、別のエージェントを試す日に、それを作り直すということです。コンテキストが優れているほど、離れるコストは高くなります。

### // プロトコルは管であって、地図ではない

MCPは、クライアントとサーバーの間で、ツールとコンテキストを運びます。あなたのシンボル、呼び出し箇所、依存関係グラフを知っているわけではありません。質問に実際に答える何かが、反対側になければなりません。

## Maguyvaは、プロトコルの反対側にあるレイヤーです

別のエージェントではありません。あらゆるMCPクライアントが呼び出せる、リポジトリコンテキストサーバーです:

- **エンドポイントはひとつ、クライアントはどれでも**: 同じ`https://maguyva.tools/mcp`が、Claude Code、Codex CLI、Gemini CLI、Cursor、Devin Desktop、Antigravityにも、今朝あなたが書いたスクリプトにも対応します。
- **セマンティック + AST + グラフ + テキスト**: 意味、構造、依存関係、あるいはリテラルで検索。どのクライアントから聞かれても、結果は必ずファイルパスと行番号付きで返ってきます。
- **ブランチを認識し、パッケージ横断で動く**: Maguyvaは、モノレポ内のすべてのパッケージにわたって、エージェントが今まさに編集しているバージョンのコードを把握します。
- **ロックインなし**: 好きなときにエージェントを乗り換えても、コンテキストレイヤーはそのまま。料金はシート単位ではなくワークスペース単位なので、リポジトリは1つでも50でもインデックスできます。

> あなたのクライアントはMCPを話す。
> Maguyvaは、*あなたのコードについて尋ねられたときに答えるもの*。

## 3つのワークフロー、どのクライアントからでも同じ

パッケージ横断、言語横断。クライアントは変わっても、根拠のある答えは変わりません。

### 01. どのエージェントからでも、パッケージ横断で認証フローを見つける

```text
agent> このモノレポでは認証はどこで行われていますか?

graph::query("authentication flow")
  packages/web/src/auth/session.ts:42       ミドルウェア
  packages/api/src/auth/jwt.ts:88           トークン検証
  packages/shared/src/auth/types.ts:12      AuthContext
  packages/admin/src/auth/admin-only.ts:31  RBACチェック

→ 4つのパッケージにまたがる4つのエントリーポイント、呼び出し箇所の密度でランク付け。
[exit 0]
```

Claude Code、Cursor、あるいは自作のスクリプトなど、どのクライアントがクエリを送ったかは関係ありません。同じ4つのファイルが、同じランキングで、実際のグラフに根ざした形で返ってきます。

### 02. テストスタブではなく、実際の実装を見つける

```text
agent> normalizePhoneNumberはE.164をどのように処理していますか?

semantic::query("normalize phone E.164")
  packages/shared/util/phone.ts:88     normalizePhoneNumber()  ← 実装本体
  packages/api/test/phone.spec.ts:14   jest.mock(...)          ← スタブ
[exit 0]
```

名前は嘘をつきます。モックは実際のコードを覆い隠します。Maguyvaは、尋ねてくるすべてのクライアントに対して同じように、実際の実装をテストモックより上位にランク付けします。

### 03. リファクタリングの前に、影響範囲を確認する

```text
agent> モノレポ全体でQueueDispatcher.publishを呼び出しているのはどこですか?

graph::callers(QueueDispatcher.publish)
  packages/billing/* に3件
  packages/audit/* に1件
  packages/notifications/* に1件
  services/python-worker/* に1件  ← gRPCスタブ経由で言語を横断
[exit 0]
```

パッケージ横断、そしてポリグロットなリポジトリでは言語横断でも、呼び出し箇所がインラインで表示されます。明日エージェントを乗り換えても、影響範囲はそこにあります。それはクライアントではなく、サーバー側にあるからです。

## あらゆるMCPクライアントでのセットアップ

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

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

回答を検証できるよう、よく知っているものを選びましょう。Freeプランはリポジトリ3個, インデックス済みリポジトリ行数、最大5万行をカバーします。

### 02. 使用しているクライアントに、MCPサーバーとしてMaguyvaを追加

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

### 03. 答えをすでに知っている質問をひとつ投げてみる

1つのリポジトリと、「パッケージ横断で`formatInvoice`を呼び出しているのは何か?」のような、検証可能な質問1つから始めましょう。答えがあなたの想定と一致すれば、そこに向けるほかのどのクライアントでも、同じ根拠のある結果が得られます。

クライアントごとの手順(Claude Code、Codex、Cursor、Gemini、Devin Desktop、Antigravity、その他)は、[Maguyvaの対応状況ドキュメント](https://maguyva.ai/ja/docs/compatibility)にあります。

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

あらゆるMCPクライアントを接続。検証できる質問を1つ、試してみましょう。

## 出典

- [MCP: 公式イントロダクション](https://modelcontextprotocol.io/docs/getting-started/intro)
- [MCP: クライアントの例](https://modelcontextprotocol.io/clients)
- [Maguyva: 対応状況とクライアント](https://maguyva.ai/ja/docs/compatibility)
- [Maguyva: スタックとセキュリティ](https://maguyva.ai/ja/stack)
- [Maguyva: 料金(ワークスペース単位、シート単位ではない)](https://maguyva.ai/ja/pricing)