Claude Code: Set up the Visily MCP server

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

  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

Add the server

Run in a normal terminal:
Quote
claude mcp add --transport http visily https://app.visily.ai/api/mcp
Or add it to a project-scoped .mcp.json:
Quote
{
    "mcpServers": {
        "visily": {
            "type": "http",
            "url": "https://app.visily.ai/api/mcp"
        }
    }
}

Authenticate (OAuth)

Authentication is OAuth, no API keys.
  1. Restart/reload Claude Code so it picks up the new server config.
  2. Run /mcp, select visily, and complete the OAuth login in your browser.
  3. Approve the requested scopes (workspaces:read, boards:read, elements:read, design:read).
Once connected, the Visily tools (list_boards, get_design_context, …) are available.
Notes
A 401 does not auto-open a browser - Claude Code surfaces an authenticate step with a URL to open manually. If the first attempt reports "Unable to connect," retry; the server can be slow on a cold start.

Verify

Quote
claude mcp list   # confirm "visily" is connected
Idea
Prefer the packaged plugin?
The plugin includes the same server along with the Visily skill, which provides usage rules and prompting guidance so the agent can use the tools effectively out of the box. See Claude Code Plugin Guide.
Need more help?
If this does not solve your issue, contact support and include a screenshot if possible.