/ Каталог / Песочница / MCP Apps Protocol
● Официальный modelcontextprotocol ⚡ Сразу

MCP Apps Protocol

автор modelcontextprotocol · modelcontextprotocol/ext-apps

Официальное расширение, позволяющее MCP-серверам поставлять интерактивные UI-фрагменты — Claude встраивает вашу форму/диаграмму/пикер прямо в диалог.

MCP Apps — официально одобренное расширение MCP, позволяющее серверам объявлять интерактивные UI (формы, диаграммы, пикеры), которые хост-приложение чата рендерит. Этот репозиторий содержит спецификацию, референсный SDK и примеры.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

готово

Установка

Выберите клиент

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

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.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 использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

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

Щёлкните значок MCP Servers на боковой панели Cline, затем "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."
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

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

Continue использует массив объектов серверов, а не map.

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

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add mcp-apps-protocol -- undefined 

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: MCP Apps Protocol

Добавить форму-подтверждение к MCP-инструменту

👤 Разработчики ⏱ ~15 min intermediate

Когда использовать: Инструмент имеет деструктивные побочные эффекты; нужно подтверждение пользователя перед выполнением.

Поток
  1. Прочитать спецификацию
    Просмотрите раздел спецификации Apps.✓ Скопировано
    → Понимание модели
  2. Добавить UI-фрагмент
    Верните компонент App из обработчика инструмента.✓ Скопировано
    → Хост рендерит форму
  3. Подключить submit
    При submit инструмент повторно вызывается с подтверждёнными аргументами.✓ Скопировано
    → Более безопасный деструктивный инструмент

Итог: Ваши MCP-инструменты могут запрашивать структурированные подтверждения.

Комбинации

Сочетайте с другими MCP — эффект x10

mcp-apps-protocol + fastmcp

Используйте fastmcp как MCP-сервер; Apps — для интерактивных частей

Combine mcp-apps-protocol with fastmcp: Use fastmcp as your MCP server; Apps for interactive bits✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
protocol-spec (см. документацию) Нет вызываемых инструментов — это расширение протокола 1 вызов

Стоимость и лимиты

Во что обходится

Квота API
Не применимо
Токенов на вызов
0
Деньги
Бесплатно
Совет
Держите Apps маленькими — они рендерятся inline

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Нет
Исходящий трафик: Нет

Устранение неполадок

Частые ошибки и исправления

Хост не рендерит App

Убедитесь, что хост поддерживает расширение Apps — оно опциональное

Альтернативы

MCP Apps Protocol в сравнении

АльтернативаКогда использоватьКомпромисс
Обычный инструмент с prompt-подтверждениемХост не поддерживает AppsНет структурированного ввода

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills