/ Diretório / Playground / MCP Apps Protocol
● Oficial modelcontextprotocol ⚡ Instantâneo

MCP Apps Protocol

por modelcontextprotocol · modelcontextprotocol/ext-apps

A extensão oficial que permite que servidores MCP entreguem fragmentos de UI interativos — o Claude incorpora seu formulário/gráfico/seletor diretamente na conversa.

MCP Apps é uma extensão oficialmente aprovada do MCP que permite que servidores declarem UIs interativas (formulários, gráficos, seletores) que o host do chatbot renderiza. Este repositório contém a spec, o SDK de referência e exemplos.

Por que usar

Principais recursos

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": {
    "mcp-apps-protocol": {
      "_doc": "Reference SDK; integrate as a library inside your MCP server or chatbot host."
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-apps-protocol": {
      "_doc": "Reference SDK; integrate as a library inside your MCP server or chatbot host."
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-apps-protocol": {
      "_doc": "Reference SDK; integrate as a library inside your MCP server or chatbot host."
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-apps-protocol": {
      "_doc": "Reference SDK; integrate as a library inside your MCP server or chatbot host."
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-apps-protocol",
      "args": []
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-apps-protocol": {
      "command": {
        "args": []
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add mcp-apps-protocol -- undefined 

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

Casos de uso

Usos do mundo real: MCP Apps Protocol

Adicionar uma confirmação baseada em formulário à sua ferramenta MCP

👤 Desenvolvedores ⏱ ~15 min intermediate

Quando usar: Uma ferramenta tem efeitos colaterais destrutivos; você quer confirmação do usuário antes da execução.

Fluxo
  1. Ler a spec
    Leia rapidamente a seção Apps da spec.✓ Copiado
    → Modelo mental
  2. Adicionar fragmento de UI
    Retorne um componente App do seu handler de ferramenta.✓ Copiado
    → Host renderiza formulário
  3. Conectar submit
    No submit, a ferramenta é reinvocada com os args confirmados.✓ Copiado
    → Ferramenta destrutiva mais segura

Resultado: Suas ferramentas MCP podem solicitar confirmações estruturadas.

Combinações

Combine com outros MCPs para 10× de alavancagem

mcp-apps-protocol + fastmcp

Use fastmcp como servidor MCP; Apps para partes interativas

Combine mcp-apps-protocol com fastmcp: Use fastmcp como servidor MCP; Apps para partes interativas✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
protocol-spec (ver docs) Sem ferramentas chamáveis — esta é uma extensão de protocolo 1 chamada

Custo e limites

O que custa rodar

Cota de API
N/A
Tokens por chamada
0
Monetário
Gratuito
Dica
Mantenha os Apps pequenos — eles são renderizados inline

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Nenhum
Saída de dados: Nenhum

Solução de problemas

Erros comuns e correções

Host não renderiza o App

Confirme que o host suporta a extensão Apps; é opt-in

Alternativas

MCP Apps Protocol vs. outros

AlternativaQuando usarTroca
Plain tool with prompt confirmO host não suporta AppsSem entrada estruturada

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills