開發者文件

把 Flyers 裝進你的工具

Flyers 為 CLI 與 AI agent 而生。在終端機一行裝好,或把安裝區塊貼進 Claude Code、Codex,讓 agent 自己接起來。

讓你的 agent 幫你裝

直接複製貼上給 Claude Code、Codex 或 ChatGPT。

Read https://flyers.dev/install.txt and set up Flyers (CLI + MCP) for me.

在 Claude 裡一鍵連接(Connector)

在 Claude.ai(網頁/桌面)或 Claude Code:設定 → Connectors → Add custom connector,貼上下面網址,連線後用 GitHub 或 Google 登入授權即可——免安裝、免貼 token。之後直接叫 Claude「把這份 HTML make it fly」就會回你短連結。

https://mcp.flyers.dev/mcp

可用工具(15 個 flyers_*):發佈 HTML、列出連結、改密碼/時效/上下線、改網址、刪除、搬移連結,以及團隊與品牌網域管理。每個工具的說明見下方步驟與 flyers.dev/install.txt。

1 · 安裝 CLI

一行裝好,然後登入綁定你的帳號:

npm install -g @flyers-dev/cli
flyers login

2 · 讓它起飛

agent 寫好 HTML 後,一個指令發佈並拿到短連結:

flyers make it fly proposal.html
# ✈ https://flyers.dev/ab12c

自訂網址(中文 / 日文也行)

用 as 指定好記的短碼,連結就長成你要的樣子。短碼可用小寫英數字與連字號,也能用中文或日文——瀏覽器網址列會直接顯示原本的文字。長度 3–40 字(含中日文時至少 2 字),會自動避開保留字與容易混淆的假冒字詞。

flyers make it fly proposal.html as artzy-q3-review
# ✈ https://flyers.dev/artzy-q3-review

flyers make it fly proposal.html as 招募活動
# ✈ https://flyers.dev/招募活動

3 · 本機 MCP(Claude Desktop / Code,沿用 CLI)

若用本機 stdio 方式(而非上面的 connector):先用 flyers login 登入,MCP 會自動沿用同一個 token,設定裡不必再填。需要明確指定時(遠端 / CI),用 flyers token 印出 token 設成 FLYERS_TOKEN:

{
  "mcpServers": {
    "flyers": {
      "command": "npx",
      "args": ["-y", "@flyers-dev/mcp"]
    }
  }
}

4 · 給 Agent 的安裝指令

把這個連結貼給 Claude Code 或 Codex,它會讀取並自己完成安裝:

https://flyers.dev/install.txt

5 · 團隊與共用連結

建立一個團隊,把連結分享給其他人。團隊可以只有你一個人,也可以用 email 邀請成員,對方用該 email 登入後即加入。團隊連結(Team Links)團隊成員都看得到、都能管理;我的連結(My Links)則維持私人。免費方案可擁有 1 個團隊,Pro 方案可建立更多。發佈時用 team 指定團隊(可用名稱或 id):

flyers team create "Acme"          # you become its owner
flyers team invite t_ab12 [email protected]
flyers team ls                     # ids of teams you're in

flyers make it fly deck.html team Acme   # → a Team Link
flyers assign ab12c --team Acme    # move an existing link in
flyers assign ab12c --personal     # move it back to My Links

6 · 品牌網域

團隊擁有者可以開一個 flyers.dev 子網域(每個團隊一個)。發佈到它的連結會長成 your-brand.flyers.dev/code,而且只在該網域上開得起來。

flyers domain add Acme spot       # → spot.flyers.dev (owner only)
flyers domain ls Acme              # show this team's branded domain

flyers make it fly deck.html on spot.flyers.dev   # publish onto it
flyers assign ab12c --domain spot.flyers.dev      # move a link onto it

疑難排解(Connector)

  • 看不到工具:在 Claude 移除 connector 再重新加入,重新完成 GitHub/Google 登入授權。
  • 登入沒完成:確認瀏覽器沒擋彈窗/轉址,並完成第三方登入後會自動跳回 Claude。
  • 連結打不開:可能設了密碼、已到期或被下線——用「list my links」查看狀態。
  • 撤銷授權:在 Claude 移除 connector,或寄信給我們撤銷 token。問題與支援:[email protected]