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

# 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):

codex plugin marketplace add .

The marketplace name is visily (the name field in .agents/plugins/marketplace.json).

Install the plugin

codex plugin add visily@visily

Verify

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)

codex mcp login visily --scopes workspaces:read,boards:read,elements:read,design:read

Updating

codex plugin marketplace upgrade visily

codex plugin add visily@visily

Removing

codex plugin remove visily@visily

codex plugin marketplace remove visily