Cursor Setup
Configure MCP for Cursor IDE to enable AI-assisted component management with Claude.
Automatic Setup (Recommended)
Run this single command to automatically configure Cursor:
npx archyra init --client cursorWhat this does
- Creates the
.cursor/mcp.jsonfile in your project or home directory - Adds the Archyra MCP server configuration
- Preserves any existing MCP servers you have configured
Manual Setup
If you prefer to configure manually, follow these steps:
Cursor looks for MCP configuration in these locations:
For project-specific configuration (recommended for teams):
.cursor/mcp.jsonCreate this file in your project root directory.
Create the file with this content:
{
"mcpServers": {
"archyra": {
"command": "npx",
"args": ["-y", "archyra@latest", "serve"]
}
}
}Close and reopen Cursor to load the new MCP configuration. You can also use Cmd/Ctrl + Shift + P and search for "Reload Window".
Enable MCP in Cursor Settings
Make sure MCP is enabled in Cursor:
- Open Cursor Settings (Cmd/Ctrl + ,)
- Search for "MCP" or navigate to Features → MCP
- Ensure "Enable MCP" is turned on
Verify Setup
After restarting Cursor, open the AI chat and try these prompts:
"List all archyra components"
"What loading components are available?"
"Add the PulseCircle component to my project"
If the AI responds with component information, your setup is complete!
Troubleshooting
MCP not appearing in Cursor
Solution: Check that the mcp.json file is in the correct location and the JSON syntax is valid.
AI doesn't know about Archyra
Solution: Make sure you restarted Cursor after adding the configuration. Try "Reload Window" from the command palette.
npx command not found
Solution: Ensure Node.js is installed and in your PATH. Run: node --version to verify.
Project-level config not working
Solution: Ensure the .cursor folder is in your project root, not in a subdirectory.