All integrations
MCP Integration
Claude Code + Archyl

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.

Explore features
Claude Code
Archyl
MCP Server· 191 MCP tools available
How it works

Three moving parts, zero glue code

01

Archyl exposes a Model Context Protocol server

Archyl's MCP server provides 191 specialized tools that give AI assistants structured access to your entire architecture: systems, containers, components, relationships, ADRs, drift scores, and more.

02

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.

03

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.

See it in action

What it looks like in practice

~/acme/checkout — claude

Claude Code · Archyl MCP connected · 191 tools

> What depends on the Payments API, and who owns it?

● archyl · get_element_dependencies(name: "Payments API")

3 elements call Payments API

Checkout APIMobile BFFBilling worker

Owned by Payments squad · governed by ADR-017 (rate limiting at the gateway)

> Draft an ADR for idempotency keys

Example: Querying architecture from Claude Code
$ claude

> What components does the API Gateway container have?

The API Gateway container has 4 components:
1. Authentication Controller - handles JWT validation
2. Rate Limiter - manages request throttling
3. Router - dispatches requests to downstream services
4. Request Logger - captures audit trail

> Create an ADR for switching from REST to gRPC
  for internal service communication

Created ADR-0042: "Adopt gRPC for Internal Service
Communication"
Status: Proposed
Context: Current REST-based internal communication
adds serialization overhead...
What you get

Everything the integration unlocks

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.

Manage ADRs

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.

Full C4 Model Access

Navigate all four C4 levels: System Context, Container, Component, and Code. Create relationships, manage technologies, and document flows.

Setup

Up and running in minutes

  1. 1

    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.

  2. 2

    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.

    snippet
    {
  "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>"
      }
    }
  }
}
  3. 3

    Start prompting

    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?"

Frequently asked questions

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 191 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.

More integrations

Cursor

Architecture-aware code suggestions in your favorite AI IDE

GitHub

Keep architecture documentation in sync with your code

VS Code

Architecture context in your favorite editor

Free plan forever

Ready to connect Claude Code?

Start on the free plan and plug Claude Code into your architecture in minutes.

  • No credit card
  • Set up in five minutes
  • Viewers are always free
Book a demoRead the quickstart

Claude Code MCP Server for Architecture Context

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 191-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

191 MCP tools available

Archyl exposes a Model Context Protocol server

Archyl's MCP server provides 191 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 191 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.