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.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.
sk_… API key. Get one from use.superdocs.app → Settings → 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
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:Updates
The plugin auto-updates when a new version is published. To pull the latest immediately: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 fromhttps://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.
