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. Passkey sign-in is rolling out; once you have an account you can add a passkey from your account settings and use it for future sign-ins.

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 create_upload and finalize_upload tools. Every file, including HTML, uses the same streamed upload pipeline. 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

From the dashboard: after a drag-and-drop upload, the success card links straight to the page you just published. Share with people opens the sharing panel, where you invite someone by email and the page moves to shared visibility (Pro and Team). Make public gives anyone with the link access.

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