開發者

接入你的 Agent

Claude Code、Codex 這類 Agent 透過 MCP、CLI 或 SDK 使用 Leaflow。它在同一個專案裡操作,用的是你登入帳號的權限,呼叫的是控制台裡同一套操作。

MCP

以下客戶端都能接入;其他支援 MCP 或命令列的客戶端也可以。

  • ChatGPT / Codex
  • Claude Code
  • Cursor
  • OpenCode
  • Hermes Agent
  • OpenClaw
  • WorkBuddy
  • 其他客戶端

三種接法

選一種,也可以都用。三種接法呼叫的是同一套操作。

{
  "mcpServers": {
    "leaflow": {
      "command": "leaflow",
      "args": ["mcp", "serve"]
    }
  }
}

MCP 服務提供四個工具:列出服務、列出操作、讀取介面定義、呼叫操作。Agent 讀到定義裡的約束,再按約束傳引數。預設透過標準輸入輸出執行,也可以改用網路連接埠。

先查介面,再呼叫。

誰在確認改動?

隨行的改動可以逐項確認,你的 Agent 用你的帳號權限。

隨行在控制台或聊天裡做事,改動前按你選的執行前確認處理。你自己的 Agent 沒有單獨的審批步驟:它以執行 leaflow login 的帳號身份、當前選中的專案為範圍操作。只需要檢視時,在啟動 MCP 服務的命令後加 --read-only,它就不再提供會改動資源的操作。

隨行

  • 在控制台與聊天應用裡對話
  • 改動前可以逐項確認
  • 操作頁面時游標可見
  • 每一步列在對話裡

你自己的 Agent

  • 透過 MCP、CLI 或 SDK 呼叫
  • 以登入帳號的身份與權限
  • 範圍是當前選中的專案
  • 沒有獨立的憑據,存取不到別的帳號

從安裝到第一句話

  1. 01

    安裝 CLI

    支援 macOS 與 Linux。

    curl -fsSL https://raw.githubusercontent.com/LeaflowNET/leaflow/main/install.sh | sh
  2. 02

    登入並選擇專案

    登入在瀏覽器裡完成;登入後選擇一個專案,之後的呼叫都在這個專案裡。

    leaflow login
  3. 03

    把 MCP 服務配給 Agent

    把這段寫進 Claude Code 等 Agent 的 MCP 配置。

    leaflow mcp serve
  4. 04

    在 Agent 裡問一句

    它先查介面定義,再呼叫操作。

    leaflow compute list-instances -o json

引數與返回在參考裡

每個操作的引數、返回與錯誤碼寫在 API 參考裡;CLI、MCP 與 SDK 的說明也在那裡。

從這句話開始。

複製下面的提示詞,貼上給你的 Agent,它會讀安裝說明,自己完成安裝與登入。