給 Cline 使用者

Cline 先規劃再動手。給規劃一張地圖。

Cline 會讀檔、執行指令，改任何東西前都會先問你。Maguyva 為整個程式碼庫建立索引並透過 MCP 回傳，所以 Plan 模式從真實的呼叫點出發，而不是從目錄清單出發。

Free 方案：3 個儲存庫, 最多索引 5 萬行儲存庫程式碼，免信用卡。

.clinerules 管怎麼做事，Maguyva 管程式碼現在長什麼樣。

關於 Cline 你需要知道的

四項 Cline 專屬事實。

// 設定檔

cline_mcp_settings.json

從 Cline 面板的 MCP Servers 圖示開啟：先到 Configure 分頁，再點 Configure MCP Servers。伺服器放在 mcpServers 底下。

// 傳輸方式

遠端，以 URL 連線

Cline 透過 Streamable HTTP 連線到 Maguyva 的端點。沒有本機程序，也不需要 Node.js。

// 金鑰

直接寫在標頭裡

和 Cline 自己的範例一樣，金鑰直接寫進 Authorization 標頭。設定檔位於編輯器的使用者儲存空間，不在你的儲存庫裡。

// 類型

用 streamableHttp，不用 SSE

項目裡保留 "type": "streamableHttp"：沒有類型時，Cline 會當成舊式 SSE。把你信任的工具列進 autoApprove，就能跳過它們的核准提示。

Cline 規則是一份工作約定，儘管用。

# .clinerules/testing.md
- 把任務標為完成前，先跑測試套件。
- 新增相依套件前先詢問。

工作區規則是放在 .clinerules/ 或 .cline/rules/ 裡的 Markdown 檔；Cline 也會讀取 AGENTS.md、.cursorrules 與 .windsurfrules。規則適合寫：

Cline 該執行的指令。
用 frontmatter glob 限定在某個路徑的防護規則。
你已經懶得一再重複的團隊慣例。

規則告訴 Cline 該怎麼做。它不會告訴 Cline，有哪些服務在讀它正要遷移的那張資料表。

規則與讀檔不夠用的地方

Cline 靠一次次請求、多讀檔案來補上的三個缺口。

// 從目錄清單做出的規劃

Plan 模式依據 Cline 目前讀過的內容推理。在大型程式碼庫裡，那不過是一棵目錄樹加上幾個檔案，規劃也就繼承了這些缺口。

// 每次讀取都是一趟來回

Cline 為了摸清狀況開啟的每個檔案，都要花 token 和一次模型請求。在陌生的套件裡摸索，可能在第一次編輯前就用掉大半脈絡視窗。

// 文字搜尋找到的是字串，不是呼叫端

“還有誰在呼叫它？”是圖譜的問題。文字搜尋能找到字串，卻分不清真正的呼叫端、註解、測試替身和同名方法。

作為 Cline 中 MCP 伺服器的 Maguyva

一筆 mcpServers 項目讓 Cline 獲得：

針對已索引程式碼庫的 11 個工具 語意、結構（AST）、圖譜與文字搜尋，外加符號查找、依賴方與檔案擷取。
附檔案路徑與行號的答案 涵蓋 285+ 種語言，規劃引用的都是真實存在的檔案。
只會讀取的工具 Maguyva 的工具只查詢索引，沒有一個會修改你的檔案。

Cline 規則告訴 Cline 怎麼工作。
Maguyva 給 Cline 一張用來規劃的地圖。

兩種工作流程

照著地圖規劃，然後執行。

// 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 模式前，規劃已列出三個呼叫點。
[exit 0]

規劃會列出它要動的每個檔案，你核准的是一份清單，而不是一個直覺。

// workflow 02

找到真正的實作，而不是測試固定資料

cline> 我們的按比例計費是怎麼算的？

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← 實作
  test/billing/proration.spec.ts:7   ← 固定資料

→ Cline 只讀一個檔案，而不是六個。
[exit 0]

排序結果會把實作排在同名的固定資料前面。

在 Cline 中設定

三個步驟。Free 方案：3 個儲存庫, 最多索引 5 萬行儲存庫程式碼，免信用卡。

// step 01

在 maguyva.ai 索引一個程式碼庫

挑一個你已經熟悉的，這樣你才能評分答案。

// step 02

把 Maguyva 加進 Cline 的 MCP 設定

cline_mcp_settings.json

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

// step 03

替換預留位置，然後問一個問題

把 mgv_xxxx 換成你的 API 金鑰並儲存檔案。問一個你已經知道答案的問題，再開啟它引用的檔案。