Install Archon in Claude via MCP

Archon is a backend architecture compiler. Claude produces a strict DesignSpec, Archon validates it, then generates a production-grade backend with Docker + Swagger proof.

✓

Validated DesignSpec

Schema + semantic checks

✓

Deterministic generator

Templates, no hallucinations

✓

Production baseline

Auth, logging, health, Docker

!

Claude calls tools

Not free-form code edits

Quickstart

Install the secure client: npm install -g archon-mcp-client
Add Archon to your Claude config JSON file.
Ask Claude to design your backend → Claude produces a structured DesignSpec.
Claude invokes: validate_designspec → generate_project → docker_smoke.
You receive a downloadable, production-ready NestJS repository.

Archon Architecture

Our platform is split into three unified pillars that power Claude's engineering capabilities:

1) The MCP Cloud Proxy (`archon-mcp-client`)

A lightweight, stateless NPM package that acts as a secure bridge. It pipes Claude Desktop's local `stdio` stream directly into our remote AWS infrastructure over HTTPS Event Streams. It contains zero proprietary logic.

2) The Core Backend (`archon-mcp`)

A monolithic NestJS API (Remote MCP Server) that processes Claude's tool requests. It contains the deterministic compiler that translates JSON DesignSpecs into functioning TypeScript codebases, complete with JWT Authentication, Throttling, Dockerfiles, and Swagger endpoints.

3) The UML Parser (`uml-mcp`)

Integrated directly into the core remote backend, this module gives Claude spatial awareness. Claude can parse ASCII diagrams, validate UML logic, and automatically compile visual graphs directly into backend Architecture specs.

Connecting to the Managed Cloud

Connect Claude Desktop securely to your remote Archon cluster without downloading the backend repository:

1) Install Client Adapter

npm install -g archon-mcp-client

2) Claude Config Override

Add this block to your `claude_desktop_config.json`:

{ "mcpServers": { "archon": { "command": "archon-mcp-client", "args": [ "https://<your-archon-aws-domain>/mcp/sse?apiKey=<paste-your-token-here>" ] } } }

Troubleshooting

"Could not attach to MCP server archon-mcp"

Ensure you ran npm install -g archon-mcp-client on your local machine.
Verify your API token is correctly formatted in the URL parameter.
Restart Claude Desktop completely (Cmd+Q) to reload the configuration file.

Generation Validation Errors

Instruct Claude to repair schema errors (e.g., missing required fields like constraints).
Ensure relations match their corresponding target entities exactly.

Support

For onboarding, send your use-case + stack + team size. We’ll respond with a demo + integration steps.

Contact support →

Replace you@example.com with your email.