Anthropic DXT (Claude Skill) — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

단일 파일 MCP 배포 형식
Claude Desktop에서 사용자 친화적 설치
권한, 환경 변수 프롬프트, 메타데이터가 있는 매니페스트
번들된 Node/Python 런타임 — 사용자에게 시스템 의존성 불필요
빌드, 검증, 서명을 위한 CLI

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "anthropic-dxt-skill": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/dxt"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "anthropic-dxt-skill": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/dxt"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "anthropic-dxt-skill": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/dxt"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "anthropic-dxt-skill": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/dxt"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "anthropic-dxt-skill",
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/dxt"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "anthropic-dxt-skill": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@anthropic-ai/dxt"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add anthropic-dxt-skill -- npx -y @anthropic-ai/dxt

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Anthropic DXT

비기술 사용자를 위해 MCP를 DXT로 패키징

👤 엔지니어 이상의 사용자를 가진 MCP 개발자 ⏱ ~60 min intermediate

언제 쓸까: 사용자에게 JSON 설정 파일을 편집하게 하고 싶지 않을 때.

사전 조건

작동하는 MCP 서버 — 먼저 mcp-python-sdk 또는 mcp-go를 사용하여 구축

흐름

매니페스트 초기화

Use DXT skill. Run dxt init in my MCP repo. Walk me through the manifest fields.✓ 복사됨

→ manifest.json 스캐폴딩됨
설정 프롬프트 선언

My MCP needs an API_KEY. Add it as a user-prompt config field in the manifest.✓ 복사됨

→ 설명이 있는 사용자 프롬프트 필드
빌드 및 테스트

Run dxt pack. Install in Claude Desktop. Verify config prompts appear.✓ 복사됨

→ .dxt 파일이 깔끔하게 설치, 프롬프트 렌더링

결과: Claude Desktop이 있는 사람이라면 2번 클릭으로 설치 가능한 MCP.

함정

번들 크기 > 100MB — 의존성 트리밍; 무거운 node 모듈 번들링을 피하기 위해 --node-version 사용

함께 쓰기: mcp-python-sdk · mcp-go-mark3labs

퍼블리시 또는 사이드로딩 전 DXT 검증

👤 패키지 무결성을 확인하려는 사용자 + 개발자 ⏱ ~10 min beginner

언제 쓸까: .dxt를 설치하거나 배포하려 하고 안전을 원할 때.

흐름

매니페스트 검사

Run dxt validate path/to/extension.dxt. Show me what permissions it requests.✓ 복사됨

→ 권한 요약
서명 검증

If signed, verify the publisher matches expected.✓ 복사됨

→ 서명 확인 또는 경고

결과: .dxt가 주장하는 대로 작동한다는 확신.

공개하지 않고 회사에 내부 DXT 배포

👤 내부 MCP를 배포하는 플랫폼 팀 ⏱ ~90 min advanced

언제 쓸까: 내부 MCP를 GitHub 릴리스 없이 회사 전체에 배포해야 할 때.

흐름

비공개 서명으로 빌드

Build the .dxt with our internal CA signature.✓ 복사됨

→ 서명된 .dxt
내부 공유로 배포

Drop into our SharePoint with install instructions.✓ 복사됨

→ 팀이 설치 가능

결과: DevOps 마찰 없는 내부 MCP 배포.

조합

다른 MCP와 조합해 10배 효율

anthropic-dxt-skill + mcp-python-sdk

Python SDK로 구축, DXT로 배포

Develop the MCP with mcp-python-sdk, package as DXT for non-tech users.✓ 복사됨

anthropic-dxt-skill + mcp-go-mark3labs

DXT로 래핑된 단일 바이너리 Go MCP

Cross-compile mcp-go binary; bundle in DXT.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
dxt init	()	새 DXT 시작
dxt pack	()	배포를 위한 빌드
dxt validate	path	설치 전 확인
dxt sign	path, key	퍼블리싱

비용 및 제한

운영 비용

API 쿼터: 해당 없음 — 로컬
호출당 토큰: 해당 없음
금액: 무료 (MIT)
팁: 패킹 전 npm prune --production으로 node_modules 트리밍

보안

권한, 시크릿, 파급범위

자격 증명 저장: 서명 키를 환경 변수에 저장

데이터 외부 송신: 빌드 시 없음

서드파티 DXT는 항상 설치 전 검증 — 다른 MCP와 동일한 신뢰를 받음

문제 해결

자주 발생하는 오류와 해결

번들 크기 초과

외부화된 런타임 사용; 가능한 경우 매니페스트에서 의존성을 external로 선언

'invalid signature'로 설치 실패

재서명하거나 로컬 테스트에 --skip-signature 사용

매니페스트 검증 오류

dxt validate 실행 후 나열된 스키마 문제 수정; 흔한 문제: display_name 누락

대안

Anthropic DXT 다른 것과 비교

대안	언제 쓰나	단점/장점
Direct npx config	사용자가 JSON 편집에 익숙한 개발자일 때	기술자에게는 마찰이 적고 나머지에게는 높음
Smithery installer	서드파티 설치 레지스트리를 원할 때	DXT는 업스트림/네이티브; smithery는 더 넓은 생태계 도구

Anthropic DXT