Skip to content

Learn

Connect scrolly to Claude Code over MCP

Outcome: Claude Code can upload documents, create links and read analytics in your scrolly account from inside a conversation. You need a scrolly account and Claude Code installed.

Create an API key

  1. Open Settings from the dashboard navigation and find the API keys section.
  2. Give the key a name that says where it will live, for example "laptop claude code", and click Create key.
  3. A Copy your new API key panel shows the key once. Click Copy key. You will not be able to see this key again; if you lose it, revoke it and create another.

Copy the connect command

Directly below, the Connect via MCP section shows the Claude Code command with your new key already inserted. It has the form: claude mcp add --transport http scrolly https://app.scrolly.net/mcp --header "Authorization: Bearer YOUR_KEY". Copy it.

Run it

  1. Open a terminal in the project where you want scrolly available and paste the command. By default Claude Code stores it in local scope, which means this project, on this machine, for you.
  2. Run claude mcp list. scrolly should appear, connected.
  3. If you want scrolly in every project, run the same command with the user scope instead. Avoid project scope: that writes the command, key included, into a shared configuration file.

Publish something

In a Claude Code session, ask: "Upload report.html to scrolly and give me a public link." The agent calls upload_document and create_share_link and returns the share URL. From there it can also update the document in place, change or revoke links, and fetch a link's analytics using the other tools: update_document, update_link, list_documents, list_links, revoke_link and get_link_analytics.

Expected result

claude mcp list shows scrolly as connected. The document the agent uploaded appears on your Documents page with the link it created.

If something looks wrong

  • The agent reports an authorization error: the key was mistyped or revoked. Check the API keys list in Settings, create a new key and re-run the add command after removing the old entry with claude mcp remove scrolly.
  • The upload is refused for size: the same caps apply as in the dashboard, 25 MB on Free and 100 MB on Pro.
  • The agent cannot create a link: the document already has 3 active links on the free plan.

FAQ

Frequently asked questions

I closed the panel before copying the key. Can I see it again?
No. Keys are shown once. Revoke that key in the API keys list and create a new one.
Can I use the same key from two machines?
Yes, but each machine then holds the same credential. Creating one key per machine lets you revoke one without affecting the other.
Does the free plan include MCP?
Yes. The same plan limits apply to documents created through MCP as through the dashboard: 5 documents and 3 active links per document on Free.