# Clineは動く前に計画する。その計画に地図を。

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

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

Clineはファイルを読み、コマンドを実行し、何かを変える前に確認します。Maguyvaはリポジトリ全体をインデックス化してMCP経由で返すので、Planモードはディレクトリ一覧ではなく実際の呼び出し箇所から始まります。

> .clinerulesは作業の仕方に。Maguyvaは今のコードの中身に。

## Clineについて知っておくこと

Cline特有の4つの事実。

### cline_mcp_settings.json

ClineパネルのMCP Serversアイコンから開きます。Configureタブ、次にConfigure MCP Serversです。サーバーは`mcpServers`の下に置きます。

### URLでリモート接続

ClineはMaguyvaのエンドポイントにStreamable HTTPで接続します。ローカルプロセスもNode.jsも不要です。

### ヘッダーにそのまま記述

Cline自身の例と同じく、キーは`Authorization`ヘッダーに直接書きます。設定ファイルはリポジトリではなく、エディタのユーザーストレージにあります。

### SSEではなくstreamableHttp

エントリには`"type": "streamableHttp"`を残してください。タイプがないと、Clineは旧来のSSEとみなします。信頼するツールを`autoApprove`に並べれば、承認の確認を省けます。

## Clineのルールは作業上の取り決めです。使いましょう。

```text
# .clinerules/testing.md
- タスクを完了にする前にテストスイートを実行する。
- 依存関係を追加する前に確認する。
```

ワークスペースのルールは`.clinerules/`または`.cline/rules/`に置くMarkdownファイルです。Clineは`AGENTS.md`、`.cursorrules`、`.windsurfrules`も読み込みます。ルールに向いているのは:

- Clineが実行すべきコマンド。
- frontmatterのglobで特定パスに限定したガードレール。
- 何度も繰り返すのに疲れたチームの規約。

ルールはClineに振る舞い方を教えます。これからマイグレーションするテーブルをどのサービスが読んでいるかは教えません。

## ルールとファイル読み込みの限界

Clineが、リクエストのたびにファイルを読み足して埋めている3つの穴。

### // 一覧から作った計画

Planモードは、Clineがそれまでに読んだものから推論します。大きなリポジトリでは、それはディレクトリツリーと数個のファイルにすぎず、計画はその穴を引き継ぎます。

### // 読み込みは毎回往復

状況把握のためにClineが開くファイルは、1つごとにトークンとモデルへのリクエストを消費します。見慣れないパッケージでは、最初の編集の前にコンテキストウィンドウの多くを使い切ることもあります。

### // テキスト検索は呼び出し元ではなく文字列を見つける

“ほかに誰がこれを呼んでいる?”はグラフの問いです。テキスト検索は文字列を見つけますが、本当の呼び出し元と、コメントやモックや同名のメソッドとを区別しません。

## ClineのMCPサーバーとしてのMaguyva

mcpServersのエントリ1つで、Clineが得られるもの:

- **インデックス済みリポジトリに対する11個のツール**: セマンティック、構造（AST）、グラフ、テキスト検索に加え、シンボル検索、依存元、ファイル取得。
- **ファイルパスと行番号付きの回答**: 285以上の言語に対応。計画には実在するファイルが引用されます。
- **読み取りだけのツール**: Maguyvaのツールはインデックスを照会するだけです。あなたのファイルを編集するものはありません。

> Clineのルールは、Clineに*作業の仕方*を教える。
> Maguyvaは、Clineに*計画の拠り所となる地図*を与える。

## 2つのワークフロー

地図をもとに計画し、それから実行する。

### 01. 実際の呼び出し箇所から変更を計画する

```text
cline plan> セッション更新をauthパッケージに移して

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ Actモードに入る前に、計画に3つの呼び出し箇所が並びます。
[exit 0]
```

計画は触れるファイルをすべて挙げるので、あなたが承認するのは勘ではなくリストです。

### 02. テストフィクスチャではなく、実際の実装を見つける

```text
cline> 日割り計算はどうやっている?

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← 実装
  test/billing/proration.spec.ts:7   ← フィクスチャ

→ Clineは6つではなく1つのファイルを読みます。
[exit 0]
```

ランク付けされた結果では、同じ名前のフィクスチャより実装が上に来ます。

## Clineでのセットアップ

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

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

回答を評価できるよう、すでによく知っているリポジトリを選びましょう。

### 02. ClineのMCP設定にMaguyvaを追加

`cline_mcp_settings.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

### 03. プレースホルダーを置き換えて、質問を1つしてみる

`mgv_xxxx`をあなたのAPIキーに置き換えてファイルを保存します。答えをすでに知っている質問を1つして、引用されたファイルを開いてみましょう。

Cline公式の[MCPドキュメント](https://docs.cline.bot/mcp/mcp-overview)に、リモートサーバー、タイムアウト、自動承認の説明があります。

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

MCP経由でClineを接続し、確認できる質問を1つしてみましょう。