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.

    • Related Articles

    • 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 ...

    • 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 ...

    • 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 ...

    • Lovable: Set up the Visily MCP server

      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 not supported. Server URL: https://app.visily.ai/api/mcp Set ...

    • ChatGPT: Set up the Visily MCP server

      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 not supported. Server URL: https://app.visily.ai/api/mcp Set ...