Quickstart

Get from zero to your first shared page in under 2 minutes.

1. Sign Up

Create a free account at sharedrop.cloud. Sign in with Google or GitHub.

2. Get credentials

Pick whichever option fits your workflow.

Browser login (recommended for humans):

sharedrop login

Opens your browser. After sign-in, credentials are stored automatically -- no copy-paste needed.

API key (for CI/CD and headless agents):

1. Go to Dashboard > Settings > API Keys
2. Click Create API Key
3. Copy the key (starts with sd_) -- shown once only

3. Upload a file

The primary path is the CLI. MCP and the REST API are covered below.

CLI (primary)

Install:

npm install -g @sharedrop/cli

Upload any supported file:

sharedrop upload report.html --title "My First Page"

Non-HTML example (a PDF):

sharedrop upload analysis.pdf --title "Q1 Analysis"

Upload and make it public immediately:

sharedrop upload report.html --title "Q1 Report" --visibility public

The CLI prints the page URL on success.

The upload mode defaults to your account's default upload mode (initially interactive -- scripts allowed); configure it in Settings. An explicit --mode arg always overrides.

MCP (for AI agents)

If your agent client supports MCP, connect it at https://sharedrop.cloud/api/mcp and use the upload_html, create_upload, or finalize_upload tools. See MCP Setup.

REST API (streamed flow)

Three steps: sign, PUT, finalize. See API Reference for full details.

1. POST /api/upload/sign -- get an upload URL and token
2. PUT {upload_url} -- stream the file bytes
3. POST /api/upload/finalize -- publish and get the page URL

4. Share it

Share with a specific person by email:

sharedrop share <page-id> --email colleague@example.com

Or make it public:

sharedrop update <page-id> --visibility public

5. Update it (stable URL)

Re-upload to the same page -- the URL stays the same and a new version is recorded:

sharedrop upload report-v2.html --page-id <page-id>

Next Steps

• Why Sharedrop -- full capabilities and use cases
• Authentication -- API keys and auth options
• CLI Guide -- all commands
• MCP Setup -- connect an AI agent
• Install the Skill -- teach any agent when to use Sharedrop
• Connect your agent -- one-stop setup hub