Claude Code Plugin Guide

Claude Code Plugin Guide

Install the Visily plugin from the marketplace to set up the MCP server and Visily skill together. The plugin includes usage rules and prompting guidance, so the agent can use Visily tools effectively out of the box.

Before you start

  1. The Visily MCP works only on workspaces on a Pro or Business plan, where you are the workspace creator or have an editor license. Free workspaces and viewer/guest roles are not supported.
  2. Server URL: https://app.visily.ai/api/mcp.
  3. All commands run in a normal terminal.
  4. The interactive /plugin panel is not required.

Add the marketplace

From a Git host:
Quote
# GitHub owner/repo
claude plugin marketplace add visily-app/mcp-plugins

# or a full git URL (SSH)
claude plugin marketplace add git@github.com:visily-app/mcp-plugins.git
Or from a local clone (run from the repo root):
Quote
claude plugin marketplace add ./
Claude Code requires local marketplace sources to be explicit relative paths (./ or ./path); a bare  "."  is rejected.
The marketplace name is visily (the name field in .claude-plugin/marketplace.json).

Install the plugin

Quote
claude plugin install visily@visily
The format is <plugin-name>@<marketplace-name>

Verify

Quote
claude plugin marketplace list   # confirm "visily" is registered
claude plugin list                        # confirm the plugin is installed

Authenticate (OAuth)

  1. Restart/reload Claude Code so the new MCP server config is picked up.
  2. Run /mcp, select visily, complete the OAuth login.
  3. Approve scopes (workspaces:read, boards:read, elements:read, design:read).

Updating

Quote
claude plugin marketplace update visily
claude plugin install visily@visily   # reinstall to pick up changes

Removing

Quote
claude plugin uninstall visily@visily
claude plugin marketplace remove visily
  1. Restart/reload Claude Code so the new MCP server config is picked up.
  2. Run /mcp, select visily, complete the OAuth login.
  3. Approve scopes (workspaces:read, boards:read, elements:read, design:read).
Need more help?
If this does not solve your issue, contact support and include a screenshot if possible.

    • Related Articles

    • Claude Code: Set up the Visily MCP server

      Connect Claude Code directly to the Visily MCP server (no plugin). Use this if you just want the tools without the packaged skill. Before you start The Visily MCP works only on workspaces on a Pro or Business plan where you are the workspace creator ...

    • Get started with the Visily MCP server

      The Visily MCP server brings your Visily designs into your AI coding agent. Point it at a Visily board or screen, and your agent can find it, turn it into application code, or pull its theme tokens - using your Visily design system as the source of ...

    • Cursor: Set up the Visily MCP server

      Connect Cursor directly to the Visily MCP server by editing your MCP config (no plugin). Before you start The Visily MCP works only on workspaces on a Pro or Business plan where you are the workspace creator or have an editor license. Free workspaces ...

    • Antigravity: Set up the Visily MCP server

      Connect Google Antigravity to the Visily MCP server via its global MCP config. Before you start The Visily MCP works only on workspaces on a Pro or Business plan where you are the workspace creator or have an editor license. Free workspaces and ...

    • Gemini CLI: Set up the Visily MCP server

      Gemini CLI supports remote MCP servers over streamable HTTP. There is no packaged plugin - connect by editing your settings file. Before you start The Visily MCP works only on workspaces on a Pro or Business plan where you are the workspace creator ...