Anthropic DXT (Claude Skill) — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Formato de distribuição MCP em um único arquivo
Instalação amigável no Claude Desktop
Manifesto com permissões, prompts para variáveis de ambiente e metadados
Runtime Node/Python incluído — sem dependências do sistema para usuários
CLI para build, validação e assinatura

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu cliente

~/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"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

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

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

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Anthropic DXT

Empacotar seu MCP como DXT para usuários não técnicos

👤 Autores de MCP com usuários além de engenheiros ⏱ ~60 min intermediate

Quando usar: Você não quer pedir aos usuários que editem arquivos de configuração JSON.

Pré-requisitos

Servidor MCP funcionando — Use mcp-python-sdk ou mcp-go para construir primeiro

Fluxo

Inicializar o manifesto

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

→ manifest.json criado como scaffold
Declarar prompts de configuração

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

→ Campo de prompt de usuário com descrição
Construir e testar

Run dxt pack. Install in Claude Desktop. Verify config prompts appear.✓ Copiado

→ Arquivo .dxt instala limpo; prompts renderizam

Resultado: Seu MCP instalável por qualquer pessoa com Claude Desktop em 2 cliques.

Armadilhas

Tamanho do bundle > 100MB — Reduza dependências; use --node-version para evitar incluir módulos node pesados

Combine com: mcp-python-sdk · mcp-go-mark3labs

Validar um DXT antes de publicar ou fazer sideload

👤 Usuários + autores verificando integridade do pacote ⏱ ~10 min beginner

Quando usar: Você está prestes a instalar ou distribuir um .dxt e quer segurança.

Fluxo

Inspecionar o manifesto

Run dxt validate path/to/extension.dxt. Show me what permissions it requests.✓ Copiado

→ Resumo de permissões
Verificar a assinatura

If signed, verify the publisher matches expected.✓ Copiado

→ Assinatura ok ou aviso

Resultado: Confiança de que o .dxt faz o que afirma.

Distribuir DXTs internos para sua empresa sem ir a público

👤 Times de plataforma distribuindo MCPs internos ⏱ ~90 min advanced

Quando usar: MCPs internos precisam de rollout para toda a empresa, não de lançamento no GitHub.

Fluxo

Construir com assinatura privada

Build the .dxt with our internal CA signature.✓ Copiado

→ .dxt assinado
Distribuir via compartilhamento interno

Drop into our SharePoint with install instructions.✓ Copiado

→ Time consegue instalar

Resultado: Rollout de MCP interno sem fricção de DevOps.

Combinações

Combine com outros MCPs para 10× de alavancagem

anthropic-dxt-skill + mcp-python-sdk

Construir com Python SDK, distribuir com DXT

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

anthropic-dxt-skill + mcp-go-mark3labs

MCP Go com binário único embrulhado em DXT

Cross-compile mcp-go binary; bundle in DXT.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
dxt init	()	Iniciando um novo DXT
dxt pack	()	Build para distribuição
dxt validate	path	Verificação pré-instalação
dxt sign	path, key	Publicação

Custo e limites

O que custa rodar

Cota de API: N/A — local
Tokens por chamada: N/A
Monetário: Gratuito (MIT)
Dica: Reduza node_modules com npm prune --production antes do pack

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Chaves para assinatura em variáveis de ambiente

Saída de dados: Nenhum no momento do build

Sempre valide DXTs de terceiros antes de instalar — eles recebem a mesma confiança que seus outros MCPs

Solução de problemas

Erros comuns e correções

Bundle muito grande

Use runtime externalizado; declare dependências como external no manifesto quando possível

Instalação falha com 'invalid signature'

Re-assine ou use --skip-signature para testes locais

Erro de validação do manifesto

Execute dxt validate e corrija os problemas de schema listados; comum: display_name ausente

Alternativas

Anthropic DXT vs. outros

Alternativa	Quando usar	Troca
Configuração direta via npx	Os usuários são devs confortáveis em editar JSON	Menor fricção para técnicos, maior para todos os outros
Instalador Smithery	Você quer um registro de instalação de terceiros	DXT é upstream/nativo; smithery é uma ferramenta do ecossistema mais amplo

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills