Claude Code Setup

Configure MCP for Anthropic's Claude Code CLI to enable AI-assisted component management.

Automatic Setup (Recommended)

Run this single command to automatically configure Claude Code:

npx archyra init --client claude

If you prefer to configure manually, follow these steps:

1Locate your configuration file

Claude Code looks for MCP configuration in these locations (in order):

~/.claude/claude_desktop_config.json

~/.mcp.json

2Add the MCP configuration

If you don't have an MCP config yet, create the file with this content:

{
  "mcpServers": {
    "archyra": {
      "command": "npx",
      "args": ["-y", "archyra@latest", "serve"]
    }
  }
}

3Restart Claude Code

Close and reopen Claude Code to load the new MCP configuration. The server will start automatically when Claude Code launches.

After restarting Claude Code, test the integration by asking:

You

"List all archyra components"

You

"What UI components are available?"

You

"Show me the AuthPage component"

If Claude responds with component information, your setup is complete!

Problem

MCP server not found

Solution: Ensure the config file is in the correct location and the JSON is valid. Run: npx archyra init --client claude

Problem

Claude doesn't recognize the commands

Solution: Make sure you restarted Claude Code after adding the configuration.

Problem

npx command fails

Solution: Ensure Node.js 18+ is installed. Run: node --version to check.

Problem

Permission denied errors

Solution: Check file permissions on the config file. On Unix: chmod 644 ~/.claude/claude_desktop_config.json