开发者

接入你的 Agent

Claude Code、Codex 这类 Agent 通过 MCP、CLI 或 SDK 使用 Leaflow。它在同一个项目里操作，用的是你登录账号的权限，调用的是控制台里同一套操作。

以下客户端都能接入；其他支持 MCP 或命令行的客户端也可以。

三种接法

选一种，也可以都用。三种接法调用的是同一套操作。

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

MCP 服务提供四个工具：列出服务、列出操作、读取接口定义、调用操作。Agent 读到定义里的约束，再按约束传参数。默认通过标准输入输出运行，也可以改用网络端口。

leaflow login
leaflow project use website
leaflow compute list-instances -o json
leaflow compute get-instance web-01

在 leaflow 后面写服务名与操作名，就调用一次操作；可以输出 JSON 或自定义列，交给脚本。可以用安装脚本，也可以用 go install。

npm i @leaflow/sdk openapi-fetch
go get github.com/leaflowapis/leaflow-go/compute

TypeScript 用 @leaflow/sdk 与 openapi-fetch；Go 按服务引用 github.com/leaflowapis/leaflow-go 下的包。

先查接口，再调用。

谁在确认改动？

随行在控制台或聊天里做事，改动前按你选的执行前确认处理。你自己的 Agent 没有单独的审批步骤：它以运行 leaflow login 的账号身份、当前选中的项目为范围操作。只需要查看时，在启动 MCP 服务的命令后加 --read-only，它就不再提供会改动资源的操作。

支持 macOS 与 Linux。

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

每个操作的参数、返回与错误码写在 API 参考里；CLI、MCP 与 SDK 的说明也在那里。

复制下面的提示词，粘贴给你的 Agent，它会读安装说明，自己完成安装与登录。