安裝指南

連接您的 AI

一個 URL 就能讓任何支援 MCP 的代理連上您選擇的 buckets。登入、勾選 buckets,完成—什麼都不用安裝。

1

將 CopyBucket 加入您的 AI

每個代理都使用同一個伺服器位址—在您的工具新增 MCP 伺服器的地方填入這個 URL:

https://mcp.copybucket.com/mcp

Claude Code

claude mcp add --transport http copybucket https://mcp.copybucket.com/mcp

Claude Desktop · claude.ai

在 Claude 中打開設定 ▸ 連接器 ▸ 新增自訂連接器,然後貼上 URL。

Cursor

一鍵加入 Cursor —或將 URL 貼進 ~/.cursor/mcp.json 的項目中。

VS Code

安裝到 VS Code —代理模式會直接偵測到它。

其他任何支援 MCP 的工具

{
  "mcpServers": {
    "copybucket": { "type": "http", "url": "https://mcp.copybucket.com/mcp" }
  }
}
2

在瀏覽器中核准

第一次使用時,您的 AI 會帶您前往 copybucket.com 登入,並選擇它可以存取的 buckets。系統不會替您勾選任何項目:代理只看得到您核准的內容—而且您隨時可以更改或撤銷。

3

直接開口問

用平常說話的方式喊出 bucket 的名字—工具(list、get、search、put、edit、move、copy、create、delete)會搞定其餘的。

› 看看我的 bug-4521 bucket,告訴我發生了什麼事。

隨時查看並撤銷有存取權的代理

您核准過的每個代理都會列在有存取權的代理頁面以及 Mac App 的「設定 ▸ AI 代理」中—同一份清單、同一個撤銷按鈕。撤銷會立即切斷代理的存取,進行中的工作階段也不例外。

進階:改在您的 Mac 上執行伺服器

Mac 版 CopyBucket 也可以註冊本機 MCP 伺服器:打開設定 ▸ AI 代理,引導流程即可一鍵為 Claude Code、Claude Desktop、Cursor、OpenCode 和 Codex/ChatGPT Desktop 完成設定。該 Mac 上的代理可取得大型項目的直接檔案路徑,已快取的內容也能離線使用。

兩種方式只需擇一—我們建議使用託管伺服器,而且它不會出現任何 macOS 授權提示。

AI 代理只看得到您選擇的 buckets 永遠碰不到您的原始剪貼簿

可見性預設關閉,一個 bucket 一個 bucket 決定。代理加入的每個項目都標著代理的名字,而且有代理在讀取時,App 會即時顯示。完整說明請見隱私承諾。

疑難排解

我的代理說我沒有任何 bucket
這正是預設隱私設定在運作:可能是還沒有任何 bucket 標記為「AI 代理可見」(請在 App 的「管理 Buckets」中開啟),也可能是核准畫面上沒有勾選那個 bucket—重新連接代理即可再次核准。
第一個請求要等一下
伺服器採延遲連線,在一次對話的第一個工具呼叫時才登入您的帳戶。那個停頓就是登入—之後的呼叫都是即時的。
我的代理無法讀取大型檔案項目
檔案與大型圖片以 MCP 資源的形式提供,代理必須支援讀取—Claude Code、Claude Desktop 和 Cursor 都支援。超過 25 MB 的項目僅能在 CopyBucket App 中開啟。
要怎麼中斷代理的連線?
在有存取權的代理頁面或 App 的「設定 ▸ AI 代理」中按下撤銷即可。本機伺服器也在同一處取消註冊(或從代理的 MCP 設定中移除該項目)。每個 bucket 也隨時可以重新隱藏—關閉可見性開關即可。