Connect your AI

Facet gives your assistant two things: the Facet tools (to open designs and build, change, check and render them) and the Facet skill (how to use them well, in a few thousand words). Once connected, you ask in plain words and watch the design change.

#One click

1. In Facet, choose Facet › Connect AI Apps… (or Let your AI design with you on the welcome screen).
2. Facet lists the assistants it finds on your Mac. Click Connect beside each one you use.
3. Restart that app when Facet says so: quit it with ⌘Q and open it again.
4. Click Try it to open the app with a first request ready to send.

Facet changes only its own entry in each app's settings, keeps a backup of the file it changed beside it, and remembers what it added: Disconnect removes exactly that. If you move Facet or an app stops finding it, click Repair.

#Check it works

Open a design in Facet, then ask your assistant:

It should name the file. If it says it has no Facet tools, see Troubleshooting.

#By hand

The Facet tools are a local MCP server: the program inside Facet, started with the argument mcp. Every app below uses the same two values:

• command: /Applications/Facet.app/Contents/Helpers/facet
• arguments: mcp

The tools act on the design that is in front in Facet (they open Facet if it is not running), and can list, open and create designs.

#Claude (desktop app)

Open Claude › Settings › Developer › Edit Config, which opens claude_desktop_config.json, and add Facet under mcpServers:

{
  "mcpServers": {
    "facet": {
      "command": "/Applications/Facet.app/Contents/Helpers/facet",
      "args": ["mcp"]
    }
  }
}

Keep any servers already there. Quit Claude (⌘Q) and open it again.

To give Claude's chat the Facet skill as well, download facet-skill.zip from the release. In Claude, make sure code execution is on (Settings › Capabilities), then open Customize › Skills, click + and choose Upload a skill.

#Claude Code

claude mcp add --scope user facet -- /Applications/Facet.app/Contents/Helpers/facet mcp

For the skill, link Facet's copy into Claude's skills folder (Facet's own Connect does this):

mkdir -p ~/.claude/skills && ln -sfn /Applications/Facet.app/Contents/Resources/skill ~/.claude/skills/facet

#ChatGPT and Codex

Add to ~/.codex/config.toml:

[mcp_servers.facet]
command = "/Applications/Facet.app/Contents/Helpers/facet"
args = ["mcp"]

and the skill:

mkdir -p ~/.agents/skills && ln -sfn /Applications/Facet.app/Contents/Resources/skill ~/.agents/skills/facet

Restart the ChatGPT app or Codex.

#Cursor

In Cursor's settings, under MCP, add a new global server with the same command and arguments, or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "facet": {
      "command": "/Applications/Facet.app/Contents/Helpers/facet",
      "args": ["mcp"]
    }
  }
}

Cursor reads the skill from ~/.claude/skills or ~/.agents/skills.

#VS Code

Run MCP: Add Server from the command palette, choose Command (stdio), and enter the command and arguments above. VS Code reads the skill from ~/.claude/skills or ~/.agents/skills.

#What your assistant can do

Everything on the For agents page and in the agent card: build whole screens and component sets from a short description, change designs in place, check layout and text, render pictures, export assets and design tokens. Every change is one undo step in Facet, shown with the assistant's name.