Setup guide

Connect your AI

One URL connects any MCP-speaking agent to the buckets you choose. Sign in, tick the buckets, done — nothing to install.

1

Add CopyBucket to your AI

Every agent takes the same server address — give it this URL wherever your tool adds MCP servers:

https://mcp.copybucket.com/mcp

Claude Code

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

Claude Desktop · claude.ai

In Claude, open Settings ▸ Connectors ▸ Add custom connector and paste the URL.

Cursor

Add to Cursor with one click — or paste the URL into an entry in ~/.cursor/mcp.json.

VS Code

Install in VS Code — agent mode picks it up directly.

Anything else that speaks MCP

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

Approve it in your browser

On first use, your AI sends you to copybucket.com to sign in and pick the buckets it may reach. Nothing is ticked for you: an agent sees exactly what you approve — and you can change or revoke that whenever you like.

3

Just ask

Name the bucket in plain language — the tools (list, get, search, put, edit, move, copy, create, delete) do the rest.

› Look at my bug-4521 bucket and tell me what's going on.

See and revoke agents with access any time

Every agent you've approved is listed on your agents with access page and in the Mac app under Settings ▸ AI Agents — same list, same Revoke button. Revoking cuts the agent off immediately, mid-session included.

Advanced: run the server on your Mac instead

CopyBucket for Mac can also register a local MCP server: open Settings ▸ AI Agents and the guided flow sets it up with one click for Claude Code, Claude Desktop, Cursor, OpenCode, and Codex/ChatGPT Desktop. Agents on that Mac get direct file paths for large items, and it works offline for cached content.

You only need one of the two — the hosted server is the recommendation, and it never shows macOS permission prompts.

Agents see only the buckets you choose. Never your raw clipboard.

Visibility is off by default, bucket by bucket. Every item an agent adds is labeled with the agent's name, and the app shows you live when an agent is reading. Read the full story in the privacy promise.

Troubleshooting

My agent says I have no buckets
That's the privacy default working: either no bucket is marked "Visible to AI agents" yet (flip it in the app's Manage Buckets), or the bucket wasn't ticked on the approval screen — reconnect the agent to approve again.
The first request takes a moment
The server connects to your account lazily, on the first tool call of a session. The pause is the sign-in — subsequent calls are instant.
My agent can't read a large file item
Files and large images are served as MCP resources, which the agent must support reading — Claude Code, Claude Desktop, and Cursor all do. Items over 25 MB are for the CopyBucket app only.
How do I disconnect an agent?
Press Revoke on your agents with access page or in the app's Settings ▸ AI Agents. For a local server, unregister it there too (or remove the entry from the agent's MCP configuration). Buckets can also be hidden again at any time — flip the visibility switch off.