Claude Code + Archyl: Architecture-Aware AI Coding | MCP Server
Connect Archyl's 181-tool MCP server to Claude Code. Query architecture, check drift, manage ADRs, and create components from your terminal with full C4 model…
Architecture-aware AI coding, right from your terminal
Connect Archyl's MCP server to Claude Code and give your AI assistant deep knowledge of your software architecture. Query components, check drift, create ADRs, and manage your C4 model without leaving your terminal.
Claude Code + Archyl: Architecture-Aware AI Coding | MCP Server
Connect Archyl's 181-tool MCP server to Claude Code. Query architecture, check drift, manage ADRs, and create components from your terminal with full C4 model context.
Claude Code architecture, MCP server architecture, Claude Code MCP, Claude Code C4 model, AI architecture documentation, Claude Code integration
181 MCP tools available
Archyl exposes a Model Context Protocol server
Archyl's MCP server provides 181 specialized tools that give AI assistants structured access to your entire architecture: systems, containers, components, relationships, ADRs, drift scores, and more.
Claude Code connects via MCP configuration
Add Archyl to your Claude Code MCP config with your API key. Claude Code automatically discovers all available tools and understands how to use them.
Your AI assistant becomes architecture-aware
Claude Code can now query your architecture, validate changes against conformance rules, create documentation, and suggest improvements based on your actual C4 model.
Query Architecture from Terminal
Ask Claude Code about your systems, containers, and components. Get instant answers grounded in your documented architecture, not hallucinations.
Create & Update Components
Add new components, update descriptions, and manage relationships directly through natural language prompts in your terminal.
Check Architecture Drift
Ask Claude Code to compute drift scores and identify where your codebase has diverged from the documented architecture.
Create, update, and query Architecture Decision Records without leaving your terminal. Claude Code writes the ADR content based on your intent.
Conformance Validation
Run conformance checks against your architecture rules and get detailed reports on violations directly in your terminal.
Navigate all four C4 levels: System Context, Container, Component, and Code. Create relationships, manage technologies, and document flows.
Get your Archyl API key
Navigate to your profile settings in Archyl and generate an API key. This key authenticates Claude Code with your Archyl workspace.
Configure MCP in Claude Code
Add the Archyl MCP server to your Claude Code configuration file. This tells Claude Code how to connect to your architecture data.
{ "mcpServers": { "archyl": { "command": "npx", "args": [ "-y", "@anthropic-ai/mcp-remote", "https://mcp.archyl.com/mcp", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer <your-api-key>" } } } }
Open Claude Code and start asking about your architecture. Try prompts like "List all systems in my project" or "What is the drift score for the payment service?"
Example: Querying architecture from Claude Code
What is the MCP server and how does it work with Claude Code?
The Model Context Protocol (MCP) is an open standard that lets AI assistants interact with external tools. Archyl's MCP server exposes 181 tools that give Claude Code structured access to your architecture data, including systems, containers, components, relationships, ADRs, drift scores, and conformance rules.
Do I need a paid Archyl plan to use the Claude Code integration?
The MCP server is available on all plans, including the free Developer plan. Some advanced features like drift detection and conformance checks require a Business or Scale plan.
Can Claude Code modify my architecture?
Yes. Claude Code can create components, update descriptions, add relationships, write ADRs, and more through the MCP tools. All changes are tracked in Archyl's version history, and you can use change requests for review workflows.
Is my architecture data sent to Anthropic?
When you use Claude Code with the MCP server, your architecture data is processed by Anthropic's API as part of the conversation context. Archyl's MCP server only sends the specific data requested by each tool call, not your entire workspace.