Connect your AI

Vessa speaks MCP, so Claude, Claude Code and Cursor can open your guidelines, fill the sections and publish. Your AI reads the real colors and fonts, and writes back into the same editor you use.

What the connection is

Vessa runs an MCP endpoint at https://vessa.design/mcp. You add it once in your client and sign in with your Vessa account. From then on the client can work on the brands in that account, and nothing else. There is no API key to copy around: the connection uses OAuth, and you can cut it off at any time on the Connect your AI page in your account.

What your AI can do

  • List your brands and read one as structured context.
  • Create a new guideline.
  • Edit all nine sections: intro, logo, color, typography, motion, voice, moodboard, applications and assets.
  • Add assets from a URL, like a logo file or a moodboard image.
  • Publish a guideline, spending a credit you already have.

What it can't do

It can't buy anything and it can't delete anything. Purchases and deletions stay with you, in the app, on purpose. If a brand needs a publish credit and you have none, your AI will say so and stop.

Claude Code

Run this in your terminal:

claude mcp add --transport http vessa https://vessa.design/mcp

The first tool call opens the browser for sign-in. Use /mcp inside Claude Code to check the connection.

Claude

In Claude on the web or the desktop app, open settings, go to connectors and add a custom connector with this URL:

https://vessa.design/mcp

Claude opens a Vessa sign-in window. Approve it once and the tools appear in the composer.

Cursor

Open Cursor settings, go to MCP and add a server with this configuration:

{
  "mcpServers": {
    "vessa": {
      "url": "https://vessa.design/mcp"
    }
  }
}

Cursor asks you to sign in the first time it calls a Vessa tool.

Security

Every client gets its own access through OAuth, scoped to your account and expiring on its own. Nothing is shared between clients, and no token ever sits in a config file on your machine. Open Connect your AI in your account to see what is connected and revoke it.

When your AI changes a brand while you have the editor open, the editor picks the change up the next time you come back to the tab and tells you it happened.