Skip to main content
Three steps: install the plugin, run docdiagram auth, generate your first diagram

Install, authenticate once, then generate

You need Claude Code installed. Everything below runs from your terminal.

​
1. Add the marketplace and install

The plugin bundles the MCP server, so one install gives you both the slash commands and the docdiagram MCP tools.
On install, Claude Code asks once to approve the bundled docdiagram MCP server, the same per-server approval as any project’s .mcp.json. Approve it and the server starts automatically in every session.
claude plugin install <git-url> does not work. Install resolves plugin names from added marketplaces, not raw URLs. Run the two commands above in order.

​
2. Authenticate

Start a session and run the auth skill:
This opens https://app.docdiagram.com/settings/api-keys?cc=true in your browser. Click Generate code, copy the 16-character code, and paste it back when Claude prompts you. The plugin writes the API key to ~/.docdiagram/config.yaml (readable only by you). The skills and the bundled MCP server both read this one file, so you authenticate once.
No API key set up yet? The auth flow mints one for you. You do not need to visit the dashboard first.

​
3. Generate your first diagram

This saves an image to your current folder and prints the path. See Standalone diagrams for the full walkthrough.

​
Other MCP clients

Not using Claude Code? Skip the plugin and run the MCP server straight from PyPI:
Point your client (Cursor, Continue, Cody, or any MCP-aware tool) at that command. Authenticate the same way, by running /docdiagram:auth once to write the shared config, or by setting DOCDIAGRAM_API_KEY in your client’s MCP environment.

​
Sign out

To remove your stored credentials, run /docdiagram:logout. It deletes ~/.docdiagram/config.yaml.

​
Next

Standalone diagrams

Prompt to image, no repo needed.

Embedded diagrams

Diagrams that live in your docs repo.