> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superdocs.app/llms.txt
> Use this file to discover all available pages before exploring further.

# SuperDocs Plugin

> The official Claude Code plugin — single install bundles 38 MCP tools, 4 workflow prompts, and the auto-loading skill.

# 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

| Component            | Count | What it does                                                                                                                                                                            |
| -------------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **MCP tools**        | 38    | Chat, structural editing, attachments, sessions, multi-document, durable Files, cross-session memory, revert, jobs, templates, pre-signed upload/download, image upload, account status |
| **Workflow prompts** | 4     | `/superdocs:draft_from_outline`, `/superdocs:edit_styled_docx`, `/superdocs:convert_format`, `/superdocs:review_contract_for_redflags`                                                  |
| **Skill**            | 1     | Auto-loads when you ask Claude to edit, draft, or export documents — no need to think about which tool to use                                                                           |

## Install

Two steps: add the SuperDocs marketplace, then install the plugin from it.

```bash theme={null}
claude plugin marketplace add superdocsapp/superdocs-plugin
claude plugin install superdocs@superdocs-plugin
```

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`.

<Note>
  **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:

  ```bash theme={null}
  claude mcp add -s user --transport http superdocs https://api.superdocs.app/mcp/ \
    --header "Authorization: Bearer sk_YOUR_API_KEY"
  ```

  This installs the MCP tools only (not the prompts or skill). See [Claude Code → Manual setup](/mcp/claude-code#manual-setup-advanced).
</Note>

You'll be prompted for your `sk_…` API key. Get one from [use.superdocs.app](https://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

```bash theme={null}
claude plugin list
```

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:

```
"Edit /Users/me/contracts/draft.docx — make all H2 headings bold and add a new section at the end called 'Approvals'."
```

```
"Draft an NDA between Acme Corp and Globex Industries, governed by Delaware law, 2-year term."
```

Or invoke a workflow prompt directly:

```
/superdocs:draft_from_outline
```

## Updates

The plugin auto-updates when a new version is published. To pull the latest immediately:

```bash theme={null}
claude plugin update superdocs
```

To refresh the marketplace listing first (e.g. if a new version isn't showing up yet):

```bash theme={null}
claude plugin marketplace update superdocs-plugin
claude plugin update superdocs
```

To uninstall:

```bash theme={null}
claude plugin uninstall superdocs
```

## 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](/introduction/agent-signup).

## Source

The plugin is open source under MIT. Browse, clone, fork, or report issues at [github.com/superdocsapp/superdocs-plugin](https://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](/mcp/claude-code#manual-setup-advanced) section.