Clineユーザー向け

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

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

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

.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のルールは作業上の取り決めです。使いましょう。

# .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つのワークフロー

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

// workflow 01

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

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]

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

// workflow 02

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

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万行、カード不要。

// step 01

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

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

// step 02

ClineのMCP設定にMaguyvaを追加

cline_mcp_settings.json

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

// step 03

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

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