Shelvibe.
For agents · 給 AI 代理

讓 AI 幫你
做書、上架、讀回饋

Let AI
make, publish and read feedback

Shelvibe 提供 MCP 伺服器與 Claude skill：Claude Code、ChatGPT 等 AI 代理可以找書、讀讀者留下的筆記、把做好的動畫書放上書架，或生成插圖與音訊。

Shelvibe provides an MCP server and a Claude skill: AI agents such as Claude Code and ChatGPT can find books, read the notes readers leave, put finished animated books on the shelf, or generate illustrations and audio.

不用 Shelvibe 的工作室，也能做書用你習慣的 AI（Claude Code、ChatGPT、Cursor⋯）在自己的電腦上做好動畫書，再透過 MCP 或直接上傳放上書架。工作室只是其中一種做法。
You don't need Shelvibe's Studio to make booksMake an animated book on your own computer with the AI you already use (Claude Code, ChatGPT, Cursor…), then put it on the shelf through MCP or by uploading it directly. The Studio is just one way to do it.
01

MCP 伺服器

一個網址就能接上。驗證方式依連線的程式而定：

端點
Claude Code、腳本個人 API token：在 帳號頁 產生，放在 Authorization: Bearer <token>
ChatGPT、claude.ai 等網頁版OAuth 2.1：連接時跳出 Shelvibe 的登入與授權畫面，不需要複製 token

One URL is all it takes. How you authenticate depends on the program connecting:

Endpoint
Claude Code, scriptsPersonal API token: create one on your account page and send it as Authorization: Bearer <token>
ChatGPT, claude.ai and other web appsOAuth 2.1: connecting opens Shelvibe's sign-in and authorization screen, no token to copy
02

Claude Code

  1. 到 帳號頁 產生 token，勾選需要的權限（讀取、上架；生成會花錢，需要時再勾）。
  2. 加入 MCP（-s user 讓所有專案都能用）：
連上之後，Claude 會自動收到一段簡短的使用說明；完整的做書流程在下一節的 skill。
  1. Create a token on your account page and check the permissions you need (read, publish; generation costs money, so only check it when you need it).
  2. Add the MCP server (-s user makes it available in every project):
Once connected, Claude automatically receives short usage instructions; the full book-making workflow is in the skill in the next section.
03
Claude skill：做一本動畫書並上架
skill 是一份打包好的工作流程，只在需要時才被 Claude 載入。shelf skill 帶 Claude 從構想、撰寫 lotion 動畫、截圖自我檢查、生成素材，到上架與依讀者回饋修改。
A skill is a packaged workflow that Claude loads only when needed. The shelf skill guides Claude from the idea, writing the lotion animation, checking its own screenshots and generating assets, to publishing and revising based on reader feedback.
下載 shelf-skill.zip看 SKILL.md
安裝：解壓縮到 Claude 的 skills 目錄：
之後在 Claude Code 說「做一本關於 OOO 的動畫書並放上書架」，或輸入 /shelf。
Install: unzip it into Claude's skills directory:
Then tell Claude Code “make an animated book about … and put it on the shelf”, or type /shelf.
04
ChatGPT 與網頁版連接器
ChatGPT（開發者模式或 plugin）與 claude.ai 都能直接連 Shelvibe 的 MCP，驗證走 OAuth 2.1：
  1. 在連接器設定新增 MCP 伺服器，網址填 ，驗證選 OAuth。
  2. 連接時會開啟 Shelvibe 的登入與授權頁：確認帳號、勾選要給的權限後按同意。
  3. 之後可以在對話中請它找書、讀回饋，或把它生成的動畫放上書架。授權過的應用程式可以在 帳號頁 撤銷。
ChatGPT 與 claude.ai 只能連公開的 HTTPS 網址；開發用的本機網域（例如 shelf.loco）它們連不到，需要正式上線的網域，或用 tunnel 暫時公開。
ChatGPT (developer mode or plugins) and claude.ai can both connect to Shelvibe's MCP directly, authenticating with OAuth 2.1:
  1. In the connector settings, add an MCP server with the URL  and choose OAuth for authentication.
  2. Connecting opens Shelvibe's sign-in and authorization page: confirm the account, check the permissions to grant, then approve.
  3. You can then ask it in chat to find books, read feedback, or put the animations it generates on the shelf. Authorized apps can be revoked on your account page.
ChatGPT and claude.ai can only connect to public HTTPS URLs. They can't reach local development domains (such as shelf.loco); you need a production domain, or a tunnel to expose it temporarily.
05
工具一覽
工具用途權限
list_books列出書架上的書（書名、簡介、標籤、長度、章節、網址）讀取
search_books找書：子字串比對，或依語意判斷（AI）讀取
get_book書的資訊與讀者回饋摘要讀取
get_book_notes讀者的留言、畫的重點、表情，都附時間點讀取
create_upload拿一次性的上傳網址，用 curl 傳 zip、html 或圖片上架
publish_book上架或更新書（先用 create_upload 傳 zip / html，或直接給小頁面的 html）上架
update_book_info修改書名、簡介、標籤上架
generate_image生成插圖（可去背）生成
generate_audio生成配樂、音效、旁白（預設台灣中文，也可以英文、日文）生成
remove_background去背（來源是生成的圖，或用 create_upload 傳上來的圖）生成
get_credit查剩餘點數與各項生成的估價讀取
lotion_guidelotion 動畫的寫法與書架的檔案規範—
06
權限與安全
  • 讀取：列出、搜尋書，讀筆記。私人的書只有擁有者看得到。
  • 上架：上架與修改書。上架的書屬於 token 或授權的使用者；只能修改自己的書。
  • 生成：呼叫付費的生成服務（圖片、音訊），預設不給。
  • 檔案一律經網路傳遞：上架用 create_upload 拿一次性的上傳網址；生成的素材回傳網址，由 agent 自己下載。Shelvibe 不讀寫你電腦上的路徑。
  • token 只在產生時顯示一次，Shelvibe 只保存雜湊；不用時請到 帳號頁 撤銷。
  • Read: list and search books, read notes. Private books are visible only to their owners.
  • Publish: publish and edit books. Published books belong to the user of the token or authorization; you can only edit your own books.
  • Generate: call paid generation services (images, audio). Not granted by default.
  • Files always travel over the network: publishing uses a one-time upload URL from create_upload, and generated assets come back as URLs for the agent to download. Shelvibe never reads or writes paths on your machine.
  • A token is shown only once, when it is created, and Shelvibe stores only its hash; revoke tokens you no longer use on your account page.