Codex Plugin Guide

Codex Plugin Guide

Install the Visily plugin from the marketplace to set up both the MCP server and the Visily skill in one place.

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. Codex only auto-discovers the personal marketplace at ~/.agents/plugins/marketplace.json. This is a repo/team marketplace, so adding it explicitly is expected.

Add the marketplace

For Codex Desktop App

  1. Open the Codex Desktop App.
  2. Go to Plugins.
  3. Open the marketplace settings or marketplace source list.
  4. Click Add marketplace.
  5. Enter the Visily marketplace details. Source: git@github.com:visily-app/mcp-plugins.git
  6. Save the marketplace.
  7. Restart Codex if prompted.
  8. Go back to Plugins and select the Visily marketplace as the source.
  9. Find the Visily plugin and install it.

From a Git host

Quote
# GitHub owner/repo
codex plugin marketplace add visily-app/mcp-plugins

# or a full git URL (SSH)
codex plugin marketplace add git@github.com:visily-app/mcp-plugins.git
Or from a local clone (run from the repo root):
Quote
codex plugin marketplace add .
The marketplace name is visily (the name field in .agents/plugins/marketplace.json).

Install the plugin

Quote
codex plugin add visily@visily

Verify

Quote
codex plugin marketplace list   # confirm "visily" is registered
codex plugin list --available     # confirm the plugin appears
codex mcp list                          # confirm the "visily" MCP server is configured

Authenticate (OAuth)

Restart Codex or start a new thread, then:
Quote
codex mcp login visily --scopes workspaces:read,boards:read,elements:read,design:read
Complete the OAuth login and approve scopes.

Updating

Quote
codex plugin marketplace upgrade visily
codex plugin add visily@visily

Removing

Quote
codex plugin remove visily@visily
codex plugin marketplace remove visily

Need more help?
If this does not solve your issue, contact support and include a screenshot if possible.

    • Related Articles

    • Codex: Set up the Visily MCP server

      Connect Codex directly to the Visily MCP server (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 and viewer/guest roles are ...

    • Cursor Plugin Guide

      Cursor 2.5+ supports a packaged plugin, a .cursor-plugin/plugin.json manifest with the Visily skill and the MCP server config bundled together. Before you start The Visily MCP works only on workspaces on a Pro or Business plan, where you are the ...

    • 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 The Visily MCP ...

    • Antigravity Skill Guide

      Antigravity has no marketplace plugin format, but it auto-discovers a project-local skill. Adding it gives the agent Visily usage rules and prompting guidance. Before you start The Visily MCP works only on workspaces on a Pro or Business plan, where ...

    • Kiro Power Guide

      Kiro's packaged format is a Power. The Visily Power bundles the MCP server config plus intent-based steering workflows, so the agent knows how to find boards, generate code, and apply themes. Before you start The Visily MCP works only on workspaces ...