Claude, Cursor, VS Code와 같은 AI 어시스턴트를 아키텍처에 연결하세요 — C4 모델, ADR, 계약, 적합성, 드리프트, DORA 등을 아우르는 181개 도구

MCP 서버

Archyl은 AI 어시스턴트가 아키텍처 문서와 상호작용할 수 있도록 Model Context Protocol (MCP) 서버를 제공합니다. 이를 통해 강력한 AI 기반 아키텍처 탐색 및 문서화가 가능합니다.

MCP란 무엇인가요?

Model Context Protocol (MCP)은 AI 어시스턴트가 외부 도구와 데이터 소스에 안전하게 접근할 수 있도록 하는 개방형 프로토콜입니다. Archyl의 MCP 서버를 사용하면 AI 어시스턴트가 다음을 수행할 수 있습니다:

프로젝트와 전체 C4 모델 탐색 및 조회
아키텍처 요소, 관계, 다이어그램 생성 및 수정
ADR, 문서, API 계약, 이벤트 채널 읽기 및 쓰기
코드를 작성하기 전에 적합성 규칙, 드리프트 점수, DORA 지표, 소유권 확인
릴리스, 변경 요청, 댓글, 히스토리 추적

지원 클라이언트

Archyl의 MCP 서버는 다음과 호환됩니다:

Antigravity - Google의 AI 기반 IDE
Claude Code - Anthropic의 CLI 도구
Claude Desktop - Claude 데스크톱 애플리케이션
Cursor - AI 우선 코드 에디터
OpenAI Codex - OpenAI의 AI 코딩 어시스턴트
VS Code - GitHub Copilot Chat 연동
Warp - AI 통합 모던 터미널
Windsurf - Codeium의 AI 기반 IDE

인증

API 키 (권장)

대부분의 클라이언트는 API 키로 인증합니다. 사용하는 도구에 따라:

헤더 지원 도구 (Claude Code, Cursor, Warp, Windsurf, Antigravity): X-API-Key 헤더 사용
헤더 미지원 도구 (Claude Desktop, VS Code, OpenAI Codex): URL에 ?apiKey=YOUR_API_KEY 쿼리 파라미터 사용

프로필 → API 키 페이지에서 API 키를 생성하세요.

키의 스코프가 어시스턴트가 할 수 있는 작업을 결정합니다. 읽기 전용 키는 모든 list_* 및 get_* 도구를 호출할 수 있지만, create_*, update_*, delete_*, import_dsl은 쓰기 스코프가 있는 키가 필요합니다. 읽기 전용 키를 에이전트에 전달하는 것은 아키텍처를 변경하지 못하게 하면서 탐색만 허용하는 가장 간단한 방법입니다.

OAuth 2.1

이 서버는 붙여넣은 키 대신 브라우저 로그인으로 연결하는 클라이언트를 위해 동적 클라이언트 등록을 지원하는 OAuth 2.1도 구현합니다 (mcp:read 및 mcp:write 스코프는 위의 API 키 스코프와 동일합니다). 이러한 클라이언트를 동일한 엔드포인트로 지정하면 다음을 통해 인증 플로우를 자동으로 발견합니다:

https://api.archyl.com/.well-known/oauth-authorization-server
https://api.archyl.com/.well-known/oauth-protected-resource

설정

Antigravity

Antigravity를 열고 Agent 패널에서 "..." 메뉴를 클릭합니다
"MCP Servers" > "Manage MCP Servers" > "View raw config"를 선택합니다
~/.gemini/antigravity/mcp_config.json에 추가합니다:

{
  "mcpServers": {
    "archyl": {
      "serverUrl": "https://api.archyl.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

변경사항을 적용하려면 Antigravity를 재시작합니다

참고: Antigravity는 HTTP 기반 MCP 서버에 url 대신 serverUrl을 사용합니다.

Claude Code

프로젝트 루트에 .mcp.json 파일을 생성합니다:

{
  "mcpServers": {
    "archyl": {
      "type": "http",
      "url": "https://api.archyl.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code를 실행하면 MCP 서버가 자동으로 감지됩니다.

Claude Desktop

Claude Desktop 설정을 엽니다
개발자 → MCP 서버로 이동합니다
"서버 추가"를 클릭하고 추가합니다:

{
  "mcpServers": {
    "archyl": {
      "url": "https://api.archyl.com/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

Claude Desktop을 재시작합니다

참고: Claude Desktop 원격 커넥터는 사용자 정의 헤더를 지원하지 않으므로 API 키를 URL 쿼리 파라미터로 전달해야 합니다.

Cursor

프로젝트에 .cursor/mcp.json 파일을 생성합니다:

{
  "mcpServers": {
    "archyl": {
      "url": "https://api.archyl.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

MCP 서버를 로드하려면 Cursor를 재시작합니다.

OpenAI Codex

~/.codex/config.toml을 열거나 생성하고 추가합니다:

[mcp_servers.archyl]
url = "https://api.archyl.com/mcp?apiKey=YOUR_API_KEY"

변경사항을 적용하려면 Codex CLI 또는 IDE를 재시작합니다.

VS Code

VS Code 설정을 엽니다 (Cmd/Ctrl + ,)
"MCP"를 검색하고 "settings.json에서 편집"을 클릭합니다
추가합니다:

{
  "mcp": {
    "servers": {
      "archyl": {
        "url": "https://api.archyl.com/mcp?apiKey=YOUR_API_KEY"
      }
    }
  }
}

Warp

Warp를 열고 설정 > MCP 서버로 이동합니다
"서버 추가"를 클릭하고 설정을 붙여넣습니다:

{
  "archyl": {
    "url": "https://api.archyl.com/mcp",
    "headers": {
      "X-API-Key": "YOUR_API_KEY"
    }
  }
}

변경사항을 적용하려면 Warp를 재시작합니다

Windsurf

~/.codeium/windsurf/mcp_config.json에서 MCP 설정 파일을 엽니다:

{
  "mcpServers": {
    "archyl": {
      "serverUrl": "https://api.archyl.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

변경사항을 적용하려면 Windsurf를 재시작합니다.

도구 레퍼런스

이 서버는 181개의 도구를 제공합니다. 예측 가능한 명명 규칙을 따르므로 어시스턴트가 대부분 올바른 도구를 추측할 수 있습니다:

접두사	기능	필요한 스코프
`list_*`	특정 종류의 항목 목록 조회, 보통 프로젝트 범위 내	읽기
`get_*`	항목 하나를 연결 정보와 함께 전체 조회	읽기
`create_*`	새 항목 생성	쓰기
`update_*`	기존 항목 수정	쓰기
`delete_*`	항목 삭제 (및 그에 딸린 항목)	쓰기
`link_` / `unlink_`	C4 요소에 아티팩트 연결 또는 연결 해제	쓰기

대부분의 프로젝트 범위 도구는 projectId를 받고, 요소 범위 도구는 elementId와 elementType(C4 레벨: 1 = 시스템, 2 = 컨테이너, 3 = 컴포넌트, 4 = 코드)을 함께 받습니다. 어시스턴트에게 먼저 list_projects를 호출하도록 요청하세요 — 필요한 ID를 거기서 가져옵니다.

클라이언트는 tools/list를 통해 이 목록을 자동으로 발견하므로 항상 서버와 동기화됩니다. 아래 표는 무엇을 요청할지 결정하려는 사람을 위한 것입니다.

도구 프로필

185개의 도구는 한정된 작업을 수행하는 코딩 에이전트에게 필요한 것보다 많으며, 전부 노출하면 컨텍스트를 소모합니다. MCP URL에 ?profile=coding을 붙이거나 X-Archyl-Tool-Profile: coding 헤더를 보내면 작업 중심 컨텍스트, Harness 작업 세션 루프, 적합성/디프 검사 등 16개 도구로 표면을 줄일 수 있습니다. 매개변수를 생략하거나 profile=full을 사용하면 전체 카탈로그가 제공됩니다.

에이전트 컨텍스트 (4)

여기서 시작하세요: 여러 번 호출하는 대신 한 번의 호출로 어시스턴트에게 아키텍처 전체 그림을 전달합니다.

Tool	Description
`get_agent_context`	Get the complete architectural context for a project: C4 model, ADRs, tech stack, guardrails, API contracts, and event channels
`find_relevant_context`	Given a natural-language task, return ONLY the architecture elements relevant to it (ranked), their connected neighbours, the decisions (ADRs) and…
`get_project_c4_model`	Get the complete C4 model for a project including all systems, containers, components, code elements, and relationships
`impact_of`	Compute the blast radius of changing a C4 element: the dependents that are AFFECTED if it changes, the dependencies it relies on, and the distinct…

Harness 작업 세션 (8)

코딩 에이전트를 위한 통제된 작업 루프: 작업 단위를 선언해 집중된 컨텍스트와 권고형 잠금을 얻고, 작업 중에는 하트비트를 보내고, 아키텍처 변경 요청을 열 수 있는 결과로 마무리합니다. 또한 프로젝트 메모리: 이후 작업자를 위해 사실을 기억하고, 이전 세션이 배운 것을 불러옵니다.

Tool	Description
`plan_work`	Produce an architecture-aware implementation plan for a task: ordered steps grounded in the documented C4 model, with the ADRs and guardrails that…
`start_work_session`	Declare a unit of work BEFORE starting it
`heartbeat_work_session`	Mark an active work session as still alive
`finish_work_session`	Close a work session with what actually happened: a summary, the decisions worth recording, and follow-ups
`list_work_sessions`	List a project's harness work sessions — who is (or was) working on what, with the elements each session holds leases on
`remember`	Store a memory for future workers: a convention, a pitfall, or a fact worth knowing about an element or the project
`recall`	Search the project's memory: session outcomes, notes, conventions and pitfalls left by previous agents and humans
`confirm_memory`	Re-attest a memory you just verified in the code or at runtime: bumps its confirmation count and resets its freshness, so it keeps outranking stale…

프로젝트 (7)

Tool	Description
`list_projects`	List all architecture projects the user has access to
`get_project`	Get detailed information about a specific project including its C4 model overview
`create_project`	Create a new architecture project
`update_project`	Update an existing project's details
`delete_project`	Delete a project and all its associated data (systems, containers, components, relationships)
`get_project_settings`	Get the settings for a project (discovery config, PR settings, layout preferences, etc.)
`update_project_settings`	Update project settings such as diagram layout, code level visibility, request mode, etc

조직 및 팀 (5)

Tool	Description
`list_organizations`	List organizations the user belongs to
`get_organization`	Get detailed information about an organization
`list_teams`	List teams in an organization
`get_team`	Get detailed information about a team
`create_team`	Create a new team in an organization

C4 요소 (15)

시스템(레벨 1), 컨테이너(레벨 2), 컴포넌트(레벨 3), 코드 요소(레벨 4).

Tool	Description
`list_systems`	List all C4 Systems in a project
`create_system`	Create a new C4 System (Level 1) in a project
`update_system`	Update an existing C4 System
`delete_system`	Delete a C4 System and all its containers, components, and code elements
`list_containers`	List all C4 Containers in a system
`create_container`	Create a new C4 Container (Level 2) in a system
`update_container`	Update an existing C4 Container
`delete_container`	Delete a C4 Container and all its components and code elements
`list_components`	List all C4 Components in a container
`create_component`	Create a new C4 Component (Level 3) in a container
`update_component`	Update an existing C4 Component
`delete_component`	Delete a C4 Component and all its code elements
`create_code_element`	Create a new C4 Code Element (Level 4) in a component
`update_code_element`	Update an existing C4 Code Element
`delete_code_element`	Delete a C4 Code Element

관계 (4)

Tool	Description
`list_relationships`	List all relationships in a project
`create_relationship`	Create a relationship (connection) between two C4 elements
`update_relationship`	Update an existing relationship
`delete_relationship`	Delete a relationship between C4 elements

다이어그램 레이아웃 및 오버레이 (5)

Tool	Description
`update_positions`	Batch update positions of C4 elements on the diagram (systems, containers, components, code elements, overlays)
`list_overlays`	List all overlays in a project
`create_overlay`	Create a visual overlay (grouping) on the diagram
`update_overlay`	Update an existing overlay
`delete_overlay`	Delete an overlay

문서 (11)

Tool	Description
`list_documentation`	List project documentation
`get_documentation`	Get detailed information about a documentation item
`create_documentation`	Create a new documentation item
`update_documentation`	Update an existing documentation item
`delete_documentation`	Delete a documentation item
`move_documentation`	Move a documentation item to a folder and/or position
`list_documentation_folders`	List folders for a project
`create_documentation_folder`	Create a new documentation folder
`update_documentation_folder`	Rename a documentation folder
`move_documentation_folder`	Move a documentation folder to a new parent and/or position
`delete_documentation_folder`	Delete a documentation folder (children and docs are reparented to the parent folder)

아키텍처 결정 기록 (6)

Tool	Description
`list_adrs`	List Architecture Decision Records in a project
`get_adr`	Get detailed information about an Architecture Decision Record
`create_adr`	Create a new Architecture Decision Record
`update_adr`	Update an existing Architecture Decision Record
`delete_adr`	Delete an Architecture Decision Record
`link_adr_to_element`	Link an ADR to a C4 element (system, container, component, or code)

API 계약 (8)

OpenAPI, gRPC, GraphQL, AsyncAPI 및 MCP 도구 계약.

Tool	Description
`list_api_contracts`	List API contracts for a project
`list_api_contracts_by_element`	List API contracts linked to a specific C4 element
`get_api_contract`	Get a single API contract with its links to C4 elements
`create_api_contract`	Create a new API contract (OpenAPI, gRPC, GraphQL, AsyncAPI, or MCP tools)
`update_api_contract`	Update an existing API contract
`delete_api_contract`	Delete an API contract and all its links
`link_api_contract`	Link an API contract to a C4 element (system, container, component, or code)
`unlink_api_contract`	Remove a link between an API contract and a C4 element

이벤트 채널 (8)

Tool	Description
`list_event_channels`	List event channels (producers/consumers) for a project
`list_event_channels_by_element`	List event channels linked to a specific C4 element
`get_event_channel`	Get a single event channel with its links to C4 elements
`create_event_channel`	Create a new event channel (producer or consumer)
`update_event_channel`	Update an existing event channel
`delete_event_channel`	Delete an event channel and all its links
`link_event_channel`	Link an event channel to a C4 element (system, container, component, or code)
`unlink_event_channel`	Remove a link between an event channel and a C4 element

플로우 및 화이트보드 (8)

Tool	Description
`list_flows`	List user/system flows in the organization
`get_flow`	Get detailed information about a flow including its steps
`create_flow`	Create a new user/system flow diagram
`delete_flow`	Delete a flow
`list_whiteboards`	List whiteboards in the organization
`get_whiteboard`	Get detailed information about a whiteboard
`create_whiteboard`	Create a new whiteboard for free-form diagramming
`delete_whiteboard`	Delete a whiteboard

댓글 및 토론 (11)

Tool	Description
`list_comments`	List all comments for a project with pagination
`list_comments_by_element`	List comments for a specific C4 element
`get_comment`	Get a single comment by ID with its replies
`get_comment_count`	Get the number of comments for a C4 element
`create_comment`	Create a new comment on a project or C4 element
`update_comment`	Update an existing comment (only the author can update)
`delete_comment`	Delete a comment (only the author can delete)
`resolve_comment`	Mark a comment thread as resolved
`unresolve_comment`	Mark a comment thread as unresolved (reopen)
`add_comment_reaction`	Add a reaction emoji to a comment
`remove_comment_reaction`	Remove a reaction emoji from a comment

소유권 (6)

Tool	Description
`who_owns`	Find the user and team owners of a C4 element
`get_ownership_map`	Get the global ownership map showing all C4 elements across the organization with their team and user ownership data, plus coverage statistics
`get_element_owners`	Get the owners of a C4 element (system, container, component, or code element)
`set_element_owners`	Set the owners of a C4 element (replaces existing owners)
`add_element_owner`	Add a single owner to a C4 element
`remove_element_owner`	Remove an owner from a C4 element

기술 및 레이더 (10)

Tool	Description
`list_technologies`	List all technologies in the organization, optionally filtered by category or search term
`get_technology`	Get detailed information about a specific technology
`create_technology`	Create a new technology in the organization
`update_technology`	Update an existing technology
`delete_technology`	Delete a technology and all its element/relationship links
`get_technology_radar`	Get the technology radar data showing all technologies with their usage counts across elements and relationships
`get_element_technologies`	Get technologies linked to a C4 element (system, container, or component)
`set_element_technologies`	Set the technologies linked to a C4 element (replaces existing links)
`get_relationship_technologies`	Get technologies linked to a C4 relationship
`set_relationship_technologies`	Set the technologies linked to a C4 relationship (replaces existing links)

릴리스 및 환경 (10)

Tool	Description
`list_releases`	List releases for a project with optional filters
`get_release`	Get detailed information about a specific release
`create_release`	Create a new release for a project
`update_release`	Update an existing release
`delete_release`	Delete a release
`list_environments`	List deployment environments for a project, ordered by position
`create_environment`	Create a new deployment environment for a project
`update_environment`	Update an existing deployment environment
`delete_environment`	Delete a deployment environment
`reorder_environments`	Reorder environments for a project by providing the environment IDs in the desired order

아키텍처 변경 요청 (6)

Tool	Description
`list_requests`	List architecture change requests for a project
`get_request`	Get detailed information about an architecture change request including its changes and reviews
`create_request`	Create a new architecture change request
`update_request`	Update the title or description of an architecture change request (author only, not merged)
`list_request_changes`	List all changes in an architecture change request
`list_request_reviews`	List all reviews for an architecture change request

적합성 규칙 (9)

Tool	Description
`list_conformance_rules`	List architecture conformance rules for the organization, with optional project filter
`get_conformance_rule`	Get detailed information about a conformance rule
`create_conformance_rule`	Create a new architecture conformance rule
`update_conformance_rule`	Update a conformance rule's name, description, severity, or config
`delete_conformance_rule`	Delete a conformance rule
`run_conformance_check`	Run conformance rules against changed files and return a violation report
`list_conformance_checks`	List recent conformance checks for a project
`get_conformance_report`	Get the full report for a conformance check, including all violations
`get_conformance_stats`	Get conformance statistics for a project (total checks, pass/fail rate, latest status)

드리프트 감지 (4)

Tool	Description
`get_drift_score`	Get the latest drift score for a project
`compute_drift_score`	Trigger a drift score computation for a project
`get_drift_details`	Get the per-element drift breakdown for a specific score computation
`get_drift_history`	Get the drift score trend over time for a project

DORA 지표, ROI 및 예측 (4)

Tool	Description
`get_dora_metrics`	Calculate DORA metrics (Deployment Frequency, Lead Time for Changes, Change Failure Rate, Mean Time to Restore) for a project
`get_dora_trend`	Get DORA metrics trend over time, bucketed by day, week, or month
`compute_architecture_roi`	Quantify the financial impact of architecture decisions
`get_predictions`	Analyze drift trends, DORA trajectories, conformance decay, and complexity growth to forecast risks and recommend preventive actions

히스토리 및 타임 트래블 (5)

Tool	Description
`list_history`	List change history entries for the organization, optionally filtered by project, entity name, user, or action
`list_versions`	List all time-travel versions (snapshots) for a project, ordered by version number descending
`get_version`	Get a specific version by project ID and version number, including the full snapshot data and changes
`diff_version`	Compare a version with another version or the current live state
`analyze_architecture_diff`	AI-powered analysis of a git diff to detect architecture changes

인사이트 (3)

Tool	Description
`list_insights`	List AI-generated architecture insights
`get_insight`	Get detailed information about an insight
`silence_insight`	Silence an insight to hide it from the list

마켓플레이스 및 위젯 (15)

Tool	Description
`list_marketplace_products`	List all available marketplace integration products (Datadog, GitHub, GitLab, SonarQube, etc.)
`get_marketplace_product`	Get detailed information about a marketplace product including its configuration schema
`list_marketplace_connections`	List all configured marketplace connections for the organization
`get_marketplace_connection`	Get detailed information about a specific marketplace connection
`create_marketplace_connection`	Create a new marketplace connection to an integration product
`update_marketplace_connection`	Update an existing marketplace connection
`delete_marketplace_connection`	Delete a marketplace connection and all its associated widgets
`list_marketplace_widgets`	List marketplace widgets for a project
`list_marketplace_widgets_by_element`	List marketplace widgets linked to a specific C4 element
`get_marketplace_widget`	Get detailed information about a specific marketplace widget
`create_marketplace_widget`	Create a new marketplace widget for a project
`update_marketplace_widget`	Update an existing marketplace widget
`delete_marketplace_widget`	Delete a marketplace widget
`list_organization_widgets`	List marketplace widgets scoped to the organization (not project-specific)
`create_organization_widget`	Create a new marketplace widget scoped to the organization (not project-specific)

Webhook (7)

Tool	Description
`list_webhook_notifications`	List all outgoing webhook notification configurations for the organization
`get_webhook_notification`	Get detailed information about a specific webhook notification configuration
`create_webhook_notification`	Create a new outgoing webhook notification
`update_webhook_notification`	Update an existing webhook notification configuration
`delete_webhook_notification`	Delete a webhook notification and all its delivery history
`test_webhook_notification`	Send a test event to a webhook endpoint to verify it is configured correctly
`list_webhook_deliveries`	List recent delivery history for a webhook notification, including status and response codes

조직 전체 아키텍처 (9)

프로젝트 간 뷰 및 조직 수준 아티팩트.

Tool	Description
`list_global_systems`	List all C4 systems across all projects in the organization (global architecture view)
`list_global_relationships`	List all C4 relationships visible in the global architecture view
`list_global_adrs`	List organization-level Architecture Decision Records (not scoped to a specific project)
`create_global_adr`	Create an organization-level Architecture Decision Record
`list_global_docs`	List organization-level documentation (not scoped to a specific project)
`create_global_doc`	Create an organization-level documentation page
`list_global_api_contracts`	List organization-level API contracts (not scoped to a specific project)
`create_global_api_contract`	Create an organization-level API contract
`list_global_comments`	List organization-level discussion comments (not scoped to a specific project)

코드형 아키텍처 (1)

Tool	Description
`import_dsl`	Import architecture from a DSL format (Archyl YAML, Structurizr DSL, LikeC4, IcePanel JSON, or Backstage catalog JSON) into a project

대화 예시

아키텍처 탐색

사용자: "전자상거래 프로젝트에 어떤 시스템이 있나요?"

AI: list_systems 도구 사용 "전자상거래 프로젝트에는 4개의 시스템이 있습니다: Web Store, Payment Service, Inventory System, Notification Service..."

요소 생성

사용자: "Web Store 시스템에 세션 저장용 Redis Cache라는 새 컨테이너를 추가해주세요"

AI: create_container 도구 사용 "Web Store 시스템에 '인메모리 세션 저장 캐시'라는 설명과 함께 Redis Cache 컨테이너를 생성했습니다."

문서화

사용자: "PostgreSQL을 MongoDB 대신 선택한 결정에 대한 ADR을 작성해주세요"

AI: create_adr 도구 사용 "ADR-001: 데이터베이스 기술 선택을 생성했습니다. ACID 준수와 쿼리 유연성을 이유로 PostgreSQL을 선택한 결정을 문서화했습니다..."

코드를 작성하기 전에

사용자: "체크아웃 플로우에 속도 제한을 추가하려고 합니다. 무엇을 알아야 할까요?"

AI: find_relevant_context 및 impact_of 사용 "체크아웃은 API Gateway와 Orders 서비스에 맞닿아 있습니다. 게이트웨이를 변경하면 6개의 다운스트림 컨테이너에 영향을 줍니다. ADR-014는 이미 스로틀링에 Redis를 사용하도록 규정하고 있으며, 적합성 규칙 하나가 레거시 Session 저장소에 대한 새로운 의존성을 금지하고 있습니다..."

거버넌스 점검

사용자: "문서화된 아키텍처에서 벗어나고 있나요?"

AI: get_drift_score 및 run_conformance_check 사용 "드리프트 점수는 82%입니다 (지난달 91%에서 하락). 두 건의 위반이 있습니다: Search 서비스가 Orders 데이터베이스를 직접 호출하고, Payments가 승인되지 않은 HTTP 클라이언트를 사용합니다..."

엔드포인트

Streamable HTTP (MCP)

https://api.archyl.com/mcp

이 엔드포인트를 사용하여 AI 어시스턴트를 Archyl의 아키텍처 문서에 연결하세요. Streamable HTTP 전송 프로토콜을 지원합니다.

문제 해결

연결 실패

API 키가 유효한지 확인하세요
엔드포인트 URL이 올바른지 확인하세요
네트워크 연결을 확인하세요

인증 실패

헤더 지원 도구: X-API-Key 헤더가 올바르게 설정되었는지 확인하세요
헤더 미지원 도구: URL에 ?apiKey= 쿼리 파라미터가 있는지 확인하세요
API 키가 만료되지 않았는지 확인하세요

도구를 찾을 수 없음

올바른 도구 이름을 사용하고 있는지 확인하세요 — 도구 레퍼런스를 참고하거나, 클라이언트에 도구 목록을 새로고침하도록 요청하세요
일부 클라이언트는 tools/list를 캐시합니다. 업그레이드 후에는 클라이언트를 재시작하세요

쓰기 도구가 거부됨

create_*, update_*, delete_*, import_dsl은 쓰기 스코프가 있는 API 키가 필요합니다 — 읽기 전용 키는 list_*와 get_*만 호출할 수 있습니다
구독 플랜을 확인하세요: 일부 기능(Webhook, 마켓플레이스 연결, 관리형 에이전트 실행)은 플랜에 따라 제한됩니다

Antigravity 관련 문제

설정에 url이 아닌 serverUrl을 사용하고 있는지 확인하세요
설정 위치는 ~/.gemini/antigravity/mcp_config.json입니다

OpenAI Codex 관련 문제

~/.codex/config.toml의 TOML 구문이 올바른지 확인하세요
테이블 이름으로 [mcp_servers.archyl]을 사용하세요

Warp 관련 문제

설정 > MCP 서버에서 설정을 관리하세요
설정 변경 후 Warp를 재시작하세요

모범 사례

구체적으로 요청하세요

AI에게 아키텍처 수정을 요청할 때는 구체적으로 하세요:

프로젝트 이름을 포함하세요
요소 유형을 지정하세요
설명을 제공하세요

변경사항 검토

AI가 생성한 요소를 항상 검토하세요:

이름과 설명이 정확한지 확인하세요
관계가 올바른지 확인하세요
필요에 따라 업데이트하세요

탐색에 활용하세요

MCP는 다음에 유용합니다:

대규모 아키텍처를 빠르게 탐색
초기 문서 생성
시스템에 대한 질문 답변

MCP 서버 - Archyl Docs