Skip to main content

SuperDocs Plugin for Claude Code

The fastest way to install SuperDocs in Claude Code. One command, one prompt for your API key, three things installed at once: the MCP server, the workflow prompts, and the skill.

What you get

Install

Two steps: add the SuperDocs marketplace, then install the plugin from it.
The first command registers the marketplace (the superdocsapp/superdocs-plugin GitHub repo); the second installs the superdocs plugin from it. The install argument is plugin-name@marketplace-name (superdocs@superdocs-plugin). Running claude plugin install superdocsapp/superdocs-plugin on its own fails with “doesn’t exist in marketplace”, because that GitHub repo path is only valid for marketplace add, not for install.
Prefer just the MCP server, or hit a marketplace error? You can always connect the server directly without the plugin, in one command with no marketplace step:
This installs the MCP tools only (not the prompts or skill). See Claude Code → Manual setup.
You’ll be prompted for your sk_… API key. Get one from use.superdocs.appSettings → API Keys → Create. Free plan includes 500 AI operations per month. The key is stored in your OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service) — never in plaintext config.

Verify

You should see superdocs in the list. Then in a Claude Code session, type / and you’ll see the 4 workflow prompts in the slash menu. To test the connection:
“Use the SuperDocs health tool to check the API”
If you see {"status": "healthy"}, everything works.

Use it

After install, just ask Claude to do document work. The skill auto-loads and Claude reaches for SuperDocs:
Or invoke a workflow prompt directly:

Updates

The plugin auto-updates when a new version is published. To pull the latest immediately:
To refresh the marketplace listing first (e.g. if a new version isn’t showing up yet):
To uninstall:

Troubleshooting

“No commands match /superdocs: — The plugin didn’t load. Check claude plugin list and reinstall if missing. Restart Claude Code (the plugin loads at session start). “401 Unauthorized” on tool calls — API key is wrong or revoked. Reinstall the plugin or update the key with claude plugin config superdocs api_key. Tools work but skill doesn’t auto-load — The skill loads probabilistically based on your prompt phrasing. If you want to force it, mention “use SuperDocs” explicitly. Stale prompt content after a SuperDocs backend update — Run claude plugin update superdocs to pull the latest plugin version.

What’s bundled vs. backend-served

The plugin itself is small — just the manifest + the skill markdown. The 38 tools and 4 prompts are served live from https://api.superdocs.app/mcp/ (Streamable HTTP, sk_ Bearer auth). Tool descriptions, prompt templates, and behavior changes ship from the backend instantly — no plugin update needed for those. The plugin’s job is to make install painless. The smarts live on the server.

Running autonomously?

If an AI agent is driving this plugin with no human present, it can self-serve its own account and API key in one request, then hand the account to a human near the quota cap using a one-time takeover code. See For AI Agents.

Source

The plugin is open source under MIT. Browse, clone, fork, or report issues at github.com/superdocsapp/superdocs-plugin.

Manual install (without the plugin)

For cases where you can’t use plugins (older Claude Code, project-scoped .mcp.json shared via git, etc.), see the Claude Code manual setup section.