가장 기대하는 기능을 출시했습니다: Claude Code, Cursor 또는 MCP 호환 AI 어시스턴트에서 직접 아키텍처 문서를 조회하고 수정할 수 있는 MCP 서버입니다. 이것이 모든 것을 바꾸는 이유를 설명합니다.

MCP 서버: 좋아하는 AI 도구에서 아키텍처와 대화하세요

AI 코딩 어시스턴트를 1년 넘게 매일 사용하고 있습니다. 복잡한 리팩토링에는 Claude Code, 빠른 편집에는 Cursor, 자동 완성에는 GitHub Copilot. 하지만 항상 답답한 간극이 있었습니다: 이 도구들이 내 아키텍처 문서를 볼 수 없었다는 것입니다.

Claude에게 "결제 서비스에 새 엔드포인트를 추가해줘"라고 요청할 때마다 추측했습니다. 결제 서비스가 Stripe와 통신하고, 캐싱에 Redis를 사용하며, ADR에 문서화된 특정 보안 요구사항이 있다는 것을 몰랐습니다. AI를 수정하는 데 코드를 직접 작성하는 것보다 더 많은 시간을 썼습니다.

오늘 그 간극을 메웁니다. Archyl은 이제 56개 도구가 포함된 완전한 MCP (Model Context Protocol) 서버를 제공하여 AI 어시스턴트에게 아키텍처에 대한 완전한 가시성을 부여합니다.

MCP란?

Model Context Protocol은 AI 어시스턴트를 외부 도구와 데이터 소스에 연결하기 위한 Anthropic의 오픈 표준입니다. LLM과 상호작용해야 하는 시스템 사이의 범용 어댑터라고 생각하면 됩니다.

프롬프트에 컨텍스트를 복사-붙여넣기하는 대신, MCP를 통해 AI 어시스턴트가 도구를 직접 쿼리할 수 있습니다. 데이터를 읽고, 작업을 수행하며, 실제 시스템과 동기화된 상태를 유지할 수 있습니다.

Archyl의 MCP 서버는 아키텍처 문서가 모든 AI 어시스턴트를 위한 일급 데이터 소스가 된다는 것을 의미합니다.

무엇을 할 수 있나요?

여기서부터 흥미로워집니다. Archyl MCP 서버를 통해 AI 어시스턴트는 다음을 할 수 있습니다:

아키텍처 조회

자연스러운 질문을 하고 실제 답변을 받으세요:

"결제 프로세서 시스템에 연결된 요소는?"
"사용자 서비스가 의존하는 컨테이너는?"
"PostgreSQL 데이터베이스와 상호작용하는 모든 시스템을 보여줘"
"인증 플로우에 영향을 미치는 ADR은?"

AI는 추측하지 않습니다. 실제 문서화된 아키텍처를 조회하고 정확하고 구조화된 정보를 반환합니다.

Claude Code가 MCP를 통해 아키텍처 조회

C4 모델 탐색

AI가 전체 계층을 이해합니다:

조직의 모든 프로젝트 나열
시스템에서 컨테이너, 컴포넌트로 드릴다운
관계와 의존성 탐색
각 레벨의 기술 스택 이해

"주문 서비스가 어떤 기술을 사용하는가?"라고 물으면, AI는 환각이 아닌 실제 문서화된 스택을 반환합니다.

문서 수정

이것이 킬러 기능입니다. MCP 서버는 쓰기 작업을 지원합니다:

새로운 시스템, 컨테이너, 컴포넌트 생성
요소 간 관계 추가
ADR 생성 및 업데이트
프로젝트 문서 작성
사용자 플로우 정의

Claude에게 "방금 만든 새 알림 서비스를 문서화해줘"라고 요청하면 C4 요소를 생성하고, 기존 시스템에 연결하며, 설계 결정을 설명하는 ADR까지 초안을 작성할 수 있습니다.

동기화 유지

AI는 항상 최신 상태를 봅니다. 오래된 컨텍스트도, 낡은 문서도 없습니다. 팀원이 아키텍처를 업데이트하면 AI 어시스턴트가 즉시 봅니다.

56개 도구, 하나의 통합

최소한의 개념 증명을 만들지 않았습니다. MCP 서버는 포괄적인 기능을 제공합니다:

프로젝트 및 설정: 프로젝트 나열, 조회, 관리. AI 제공자 및 디스커버리 설정 구성.

C4 모델 (4개 레벨 모두): 시스템, 컨테이너, 컴포넌트, 코드 요소에 대한 완전한 CRUD. 관계 생성, 오버레이 관리, 전체 모델 계층 처리.

문서화: 아키텍처 문서 생성 및 업데이트. 특정 C4 요소에 문서 연결.

ADR: 완전한 Architecture Decision Record 관리. ADR 생성, 업데이트, 나열, 영향을 미치는 요소에 연결.

사용자 플로우: 시스템을 통한 사용자 여정 정의 및 시각화.

디스커버리: 연결된 리포지토리에서 AI 기반 아키텍처 디스커버리 실행.

팀: 팀 구조 및 프로젝트 접근 권한 조회.

모든 도구는 AI 어시스턴트가 추론할 수 있는 구조화된 데이터를 반환합니다. HTML 파싱도, UI 스크래핑도, 취약한 통합도 없습니다.

2분 만에 시작하기

Claude Code (또는 MCP 호환 도구)를 연결하는 방법:

1단계: API 키 생성

Archyl 프로필로 가서 "API 키"를 클릭하고 새 키를 만드세요. "Claude Code"같은 설명적인 이름을 붙이고 필요한 스코프를 선택하세요 (읽기 전용 또는 전체 접근).

키를 즉시 복사하세요 — 다시 볼 수 없습니다.

2단계: MCP 클라이언트 구성

MCP 설정에 Archyl을 추가하세요. Claude Code의 경우 설정에 다음을 추가합니다:

{
  "mcpServers": {
    "archyl": {
      "url": "https://api.archyl.com/mcp",
      "transport": "http",
      "headers": {
        "X-API-Key": "여기에_api_키_입력"
      }
    }
  }
}

3단계: 아키텍처와 대화 시작

끝입니다. AI 어시스턴트에게 아키텍처에 대해 물어보고 Archyl에서 실제 데이터를 가져오는 것을 지켜보세요.

다음 프롬프트를 시도해 보세요:

"내 Archyl 프로젝트 모두 나열해줘"
"전자상거래 플랫폼 프로젝트에 어떤 시스템이 있어?"
"결제 게이트웨이의 관계를 보여줘"
"PostgreSQL을 선택한 이유를 설명하는 새 ADR을 만들어줘"

왜 이것이 중요한가

아키텍처 문서는 항상 발견 가능성 문제가 있었습니다. 작성하면 위키나 다이어그램 어딘가에 살고, 그러면 아무도 읽지 않습니다. 엔지니어들은 문서를 확인하는 대신 Slack에서 질문합니다.

MCP는 상호작용 모델을 바꿉니다. 문서는 읽으러 가는 것이 아니라 — AI 어시스턴트가 아는 것입니다. "결제 처리가 어떻게 작동하지?"라고 물으면, 답변은 AI의 학습 데이터가 아닌 실제 아키텍처에서 옵니다.

이것은 깊은 의미가 있습니다:

온보딩이 즉각적이 됩니다. 새 엔지니어가 AI에게 시스템 아키텍처를 물어보면 첫날부터 정확한 답을 받습니다.

컨텍스트가 항상 사용 가능합니다. 코드를 작성할 때, AI는 어떤 서비스가 존재하고, 어떻게 연결되며, 어떤 결정이 그것들을 형성했는지 정확히 압니다.

문서가 최신 상태로 유지됩니다. 적극적으로 사용되기 때문에 부정확성이 발견되고 수정됩니다. 죽은 문서는 아무도 읽지 않는 문서입니다.

AI 제안이 근거가 있습니다. Claude가 설계를 제안할 때, 일반적인 패턴이 아닌 실제 아키텍처에 기반합니다.

더 큰 그림

AI 어시스턴트가 소프트웨어 개발에서 진정한 협력자인 시대에 들어서고 있습니다. 하지만 접근할 수 있는 컨텍스트만큼만 좋습니다.

오늘날 대부분의 AI 상호작용은 컨텍스트가 부족합니다. 코드를 붙여넣고, 간단한 설명을 추가하고, AI가 나머지를 알아내기를 바랍니다. 결과가 평범한 이유는 AI가 눈을 가리고 작업하고 있기 때문입니다.

MCP 기반 통합은 이 모델을 뒤집습니다. AI는 필요한 모든 것에 대한 지속적이고 쿼리 가능한 접근을 가집니다: 코드(리포지토리 통합을 통해), 아키텍처(Archyl을 통해), 이슈(Jira/Linear 통합을 통해), 문서(Notion/Confluence 통합을 통해).

AI가 팀 지식에 접근하는 진정한 팀 멤버가 됩니다.

Archyl의 MCP 서버는 이 비전에 대한 우리의 기여입니다. 아키텍처가 다이어그램 도구에 갇혀 있어서는 안 됩니다. AI 어시스턴트를 포함하여 팀이 사용하는 모든 도구에서 접근 가능해야 합니다.

다음 계획

이것은 버전 1입니다. 다음에 만들고 있는 것:

사전 제안: MCP 서버가 아키텍처 변경을 감시하고 문서 업데이트를 제안할 수 있습니다.

교차 참조 연결: ADR을 특정 커밋에 연결하고, 문서를 CI/CD 이벤트에 연결하며, 상호 연결된 지식의 웹을 만듭니다.

커스텀 쿼리: "결제 팀이 소유한 모든 서비스를 보여줘" 같은 조직 특화 쿼리를 정의합니다.

감사 로깅: 규정 준수와 디버깅을 위해 모든 MCP 상호작용을 추적합니다.

지금 체험해 보세요

MCP 서버는 오늘 모든 Archyl 플랜에서 사용할 수 있습니다. 이미 Claude Code, Cursor 또는 다른 MCP 호환 도구를 사용 중이라면 몇 분 만에 연결할 수 있습니다.

API 키를 만들고, 구성을 추가하고, 아키텍처와 대화를 시작하세요.

아직 Archyl을 사용하지 않는다면, 무료로 가입하고 AI 기반 아키텍처 문서가 어떻게 작동하는지 확인하세요. 리포지토리를 연결하고, 디스커버리를 실행한 다음, 좋아하는 AI 어시스턴트를 연결하세요.

아키텍처는 정적 다이어그램에 갇혀 있기에는 너무 중요합니다. AI 어시스턴트가 탐색하게 하세요.

Archyl의 AI 기능에 대해 더 알고 싶으신가요? AI 기반 아키텍처 디스커버리에 대한 포스트를 확인하거나, C4 모델 소개에서 기본부터 시작하세요.

MCP 서버: 좋아하는 AI 도구에서 아키텍처와 대화하세요 - Archyl Blog