Skip to content
Docs / Claude Code

Claude Code

Claude Code connects to remote MCP servers over streamable HTTP, so it talks to Astron directly. Nothing runs on your machine.

Install

Run this from any directory. Without a key you get the free library.

Terminal
claude mcp add astron https://mcp.astron.design --transport http

With a key, pass it as a bearer header so calls count against your workspace:

Terminal
claude mcp add astron https://mcp.astron.design \
  --transport http \
  --header "Authorization: Bearer $ASTRON_KEY"

Choose a scope

By default the server is added for the current project only. Add --scope user to make it available in every project, or --scope project to write it to .mcp.json so your team gets it from the repository.

Terminal
claude mcp add astron https://mcp.astron.design --transport http --scope user
With --scope project, reference the key as $ASTRON_KEY rather than pasting it, so it never lands in version control.

Verify

Terminal
$ claude mcp list
astron  https://mcp.astron.design (HTTP)  ✓ connected  6 tools

Inside a session, /mcp shows the same status and lets you reconnect after rotating a key.

Prompting tips

Name the kind of screen and the product, not the visual style: “Design the onboarding checklist for Ledgerly, an invoicing app.” Astron picks the guide; asking for “modern and clean” only adds noise. After the first build, ask for a critique_ui pass on the file you changed.