{
  "schema_version": "1.0",
  "publisher": "AI Release",
  "article": {
    "title": "Пошаговое руководство: как создать MCP App с интерактивным интерфейсом и подключить его к ИИ-агенту",
    "canonical_url": "https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn.html",
    "language": "ru",
    "article_type": "руководство",
    "published_at": null,
    "updated_at": "2026-11-20T00:00:00+00:00"
  },
  "summary": "Пошаговая инструкция: собираем MCP App с собственным интерфейсом, описываем инструменты и ресурсы, подключаем к Claude Desktop и проверяем работу в диалоге с агентом. Время выполнения: 45–60 минут Уровень сложности: Intermediate",
  "topics": [
    "MCP Apps",
    "как создать MCP App",
    "MCP сервер с интерфейсом",
    "MCP UI extension",
    "подключить MCP App к Claude"
  ],
  "entities": [
    {
      "id": "E1",
      "name": "MCP Apps",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E2",
      "name": "как создать MCP App",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E3",
      "name": "MCP сервер с интерфейсом",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E4",
      "name": "MCP UI extension",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E5",
      "name": "подключить MCP App к Claude",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E6",
      "name": "Windows",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E7",
      "name": "Linux",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E8",
      "name": "macOS",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E9",
      "name": "Node.js",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E10",
      "name": "npm",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    }
  ],
  "claims": [
    {
      "id": "AR-GUIDE-POSHAGOVOE-001",
      "statement": "Время выполнения: 45–60 минут",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Время выполнения: 45–60 минут"
    },
    {
      "id": "AR-GUIDE-POSHAGOVOE-002",
      "statement": "Уровень сложности: Intermediate",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Уровень сложности: Intermediate"
    },
    {
      "id": "AR-GUIDE-POSHAGOVOE-003",
      "statement": "Понадобится: Node.js LTS и npm (точные номера версий в постах канала не приводятся — сверьтесь с документацией), пакет @modelcontextprotocol/sdk, MCP-клиент с поддержкой расширения MCP Apps (интерфейсов внутри чата), редактор кода, терминал.",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Понадобится: Node.js LTS и npm (точные номера версий в постах канала не приводятся — сверьтесь с документацией), пакет @modelcontextprotocol/sdk, MCP-клиент с поддержкой расширения MCP Apps (интерфейсов внутри чата), редактор кода, терминал."
    },
    {
      "id": "AR-GUIDE-POSHAGOVOE-004",
      "statement": "ОС: Windows 10/11, macOS или Linux — команды ниже даны для bash, различия для PowerShell отмечены.",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "ОС: Windows 10/11, macOS или Linux — команды ниже даны для bash, различия для PowerShell отмечены."
    },
    {
      "id": "AR-GUIDE-POSHAGOVOE-005",
      "statement": "Node.js LTS + npm: проверить node -v и npm -v.",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "Node.js LTS + npm: проверить node -v и npm -v."
    },
    {
      "id": "AR-GUIDE-POSHAGOVOE-006",
      "statement": "Права на запись в папку проекта (не в Program Files и не в C:\\Windows).",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "Права на запись в папку проекта (не в Program Files и не в C:\\Windows)."
    },
    {
      "id": "AR-GUIDE-POSHAGOVOE-007",
      "statement": "Ошибка: Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/абсолютный/путь/до/demo-mcp-app/dist/server.js'",
      "claim_type": "guide_fact",
      "confidence": "editorial_assessment",
      "source_type": "анализ AI Release",
      "verification_status": "editorial_analysis",
      "source_url": "https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn.html",
      "article_anchor": "#problems",
      "evidence_excerpt": "Ошибка: Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/абсолютный/путь/до/demo-mcp-app/dist/server.js'"
    },
    {
      "id": "AR-GUIDE-POSHAGOVOE-008",
      "statement": "Причина: TypeScript не собран в dist, либо в конфиге указан путь до src.",
      "claim_type": "guide_fact",
      "confidence": "editorial_assessment",
      "source_type": "анализ AI Release",
      "verification_status": "editorial_analysis",
      "source_url": "https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn.html",
      "article_anchor": "#problems",
      "evidence_excerpt": "Причина: TypeScript не собран в dist, либо в конфиге указан путь до src."
    }
  ],
  "relationships": [
    {
      "subject": "Гайд",
      "predicate": "описывает",
      "object": "Пошаговое руководство: как создать MCP App с интерактивным интерфейсом и подключить его к ИИ-агенту",
      "claim_id": "AR-GUIDE-POSHAGOVOE-001"
    },
    {
      "subject": "Гайд",
      "predicate": "содержит шаг",
      "object": "Шаг 1. Каркас MCP-сервера и первый инструмент",
      "claim_id": "AR-GUIDE-POSHAGOVOE-001"
    }
  ],
  "questions_and_answers": [
    {
      "question": "Что это за материал?",
      "answer": "Пошаговая инструкция: собираем MCP App с собственным интерфейсом, описываем инструменты и ресурсы, подключаем к Claude Desktop и проверяем работу в диалоге с агентом.",
      "claim_ids": [
        "AR-GUIDE-POSHAGOVOE-001"
      ],
      "article_anchor": "#suschnost"
    },
    {
      "question": "Что понадобится?",
      "answer": "ОС: Windows 10/11, macOS или Linux — команды ниже даны для bash, различия для PowerShell отмечены.; Node.js LTS + npm: проверить node -v и npm -v.; Права на запись в папку проекта (не в Program Files и не в C:\\Windows).; MCP-клиент (Claude Desktop, VS Code или другой): должен уметь показывать UI-ресурсы, а не только…",
      "claim_ids": [
        "AR-GUIDE-POSHAGOVOE-003"
      ],
      "article_anchor": "#requirements"
    },
    {
      "question": "Как это сделать?",
      "answer": "Шаг 1. Каркас MCP-сервера и первый инструмент → Шаг 2. Интерактивный UI-ресурс и привязка к инструменту → Шаг 3. Подключение к ИИ-агенту и проверка end-to-end",
      "claim_ids": [
        "AR-GUIDE-POSHAGOVOE-004"
      ],
      "article_anchor": "#step-1"
    },
    {
      "question": "Что может пойти не так?",
      "answer": "Ошибка: Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/абсолютный/путь/до/demo-mcp-app/dist/server.js'",
      "claim_ids": [
        "AR-GUIDE-POSHAGOVOE-006"
      ],
      "article_anchor": "#problems"
    }
  ],
  "limitations": [
    "Ошибка: Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/абсолютный/путь/до/demo-mcp-app/dist/server.js'",
    "Причина: TypeScript не собран в dist, либо в конфиге указан путь до src.",
    "Решение: cd demo-mcp-app && npm run build && ls dist/server.js — файл должен существовать; путь в конфиге должен заканчиваться на dist/server.js.",
    "Ошибка: resources/read: unknown resource uri ui://demo/panel.html"
  ],
  "citation": {
    "preferred_citation": "AI Release. Пошаговое руководство: как создать MCP App с интерактивным интерфейсом и подключить его к ИИ-агенту. https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn.html",
    "canonical_url": "https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn.html",
    "publisher": "AI Release"
  }
}