Installation

AI coding agents

Coding agents write better Fuji UI code when they look components up instead of guessing. The Fuji UI MCP server answers from the version of @fujiui/react your project has installed and checks the code an agent writes against the package's conventions, and a companion skill tells the agent when to use it.

Claude Code

Install the Fuji UI plugin, which adds the MCP server and the skill together. Run these inside Claude Code, and choose Project scope to share the plugin with everyone working on the repository.

text

/plugin marketplace add fuji-ui-kit/fuji-ui-react
/plugin install fuji-ui@fuji-ui

To add only the server, run claude mcp add fuji -- npx -y @fujiui/mcp instead. Use one or the other: with both, every tool is listed twice.

Codex

Add the MCP server, then the skill that tells Codex when to use it.

bash

codex mcp add fuji -- npx -y @fujiui/mcp
npx skills add fuji-ui-kit/fuji-ui-react

Cursor, Claude Desktop, and other clients

Most MCP clients read this JSON shape. Pass --project with the path to your app when a client does not start servers inside your project, as with Claude Desktop.

json

{
  "mcpServers": {
    "fuji": {
      "command": "npx",
      "args": ["-y", "@fujiui/mcp", "--project", "/absolute/path/to/your/app"]
    }
  }
}

Add the skill in any agent that supports Agent Skills with npx skills add fuji-ui-kit/fuji-ui-react.

What your agent gets

list_components finds the right component for a job. get_component returns a component's import, props with their allowed values and defaults, compound parts, and examples - and for FujiProvider, the steps to set Fuji UI up in an app. review_usage checks code against the package's conventions: imports from the package root, appearance set on the provider, icons passed as components, accessible names on icon-only controls, and named sub-exports in Server Components.

Try: “Add Fuji UI to this app and build a settings page with a name input and a notifications switch.” The agent looks each component up, then checks what it wrote.

Requirements

Node.js 18.18 or later, and @fujiui/react installed in the project. Monorepos work when opened at the repository root, including pnpm and Turborepo. When packages in one repository use different versions of Fuji UI, open the agent in the package you are working in.