Install mdshare as a plugin

Add mdshare to your AI tool of choice via the easiest path — bundled plugins. Today: Claude Code & Claude Desktop, Cursor. Coming as we test there: OpenAI Codex, Gemini CLI.

---

Claude Code & Claude Desktop

One command in any Claude Code session (or via /plugin in Claude Desktop):

/plugin marketplace add urbanmorph/mdshare
/plugin install mdshare@urbanmorph

That installs:

• The mdshare MCP server — 14 tools for uploading, reading, editing, commenting on, and versioning markdown documents
• A skill (mdshare-tools) that activates Claude on natural-language requests

How to use it

Just talk to Claude naturally — the skill triggers on phrases like:

• "share this markdown with me"
• "send this doc to my designer for feedback"
• "publish these notes as a link"
• "give me an edit link for this doc"

Claude picks the right tool, infers the appropriate permission tier (view / comment / edit), and returns a hosted URL.

Uninstall

/plugin uninstall mdshare@urbanmorph

Removes the plugin and its MCP server. To also clear the local credential store, delete ~/.mdshare-mcp/documents.json.

---

Cursor

Listed on Cursor Directory — click Add to Cursor on the listing page to install in one step.

Same MCP server, same 14 tools, same mdshare-tools skill as the Claude Code plugin. The skill activates on phrases like "share this markdown" or "give me a comment link for this doc".

Manual install (skip the directory): add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mdshare": {
      "command": "npx",
      "args": ["-y", "mdshare-mcp"]
    }
  }
}

---

Why a plugin instead of raw MCP config?

You can absolutely use mdshare via raw MCP config — see the manual setup guide. Same underlying server, same 14 tools. The plugin adds:

• One-command install — no editing JSON config files
• The skill layer — Claude proactively reaches for mdshare on natural-language requests, instead of waiting to be told which tool to use
• Cleaner versioning — Claude Code refreshes the plugin metadata from the marketplace; the underlying npm package updates automatically each session

---

Other AI clients (coming soon)

OpenAI Codex CLI and Gemini CLI both have plugin / extension formats with very similar shape — manifest + MCP launcher + skills. As we test mdshare in each, we'll ship a plugin and add a section here.

If you want to use mdshare in one of those tools today, follow the manual MCP setup guide — the same MCP server works there with a few lines of config.

---

FAQ

What does the mdshare plugin install?

The plugin bundles the mdshare-mcp server (npm package) plus a single skill (mdshare-tools) that activates Claude on natural-language requests like "share this markdown" or "give me a link for this doc". Once installed, Claude can call 14 mdshare tools to upload, read, edit, comment on, and version markdown documents.

Does the plugin need my admin URL or any account setup?

No. mdshare has no accounts. The plugin creates a local credential store on your machine for documents you upload through it, so the admin key never appears in the Claude conversation. No login, no API keys to configure.

How do I update the mdshare plugin?

The MCP server is published to npm and the plugin installs it via npx -y mdshare-mcp, so you get the latest published version automatically each time the plugin starts. Plugin metadata (skill instructions, manifest) updates when Claude Code refreshes the marketplace, typically on session start.

Can I use the plugin and a manual MCP config at the same time?

You can, but you don't need to. The plugin includes the same MCP server you'd configure manually. If you have both, you may end up with two registrations of the same MCP server in Claude Code — uninstall the manual one or remove it from claude_desktop_config.json.

What permissions does the plugin require?

Network access to mdshare.live (for uploading and managing documents), and read access to local files when you ask Claude to share a specific file by path. The plugin does not access user data, environment variables, or other files unless the file_path argument is explicitly passed by the user.

How do I uninstall the plugin?

Run /plugin uninstall mdshare@urbanmorph in any Claude Code session. This removes the plugin and its MCP server from Claude's loaded toolset. To also clear the local credential store, delete ~/.mdshare-mcp/documents.json.

---

Privacy