{
  "schema_version": "1.0",
  "publisher": "AI Release",
  "article": {
    "title": "How to Build an MCP App with an Interactive UI and Connect It to an AI Agent",
    "canonical_url": "https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn_en.html",
    "language": "en",
    "article_type": "guide",
    "published_at": null,
    "updated_at": "2026-11-20T00:00:00+00:00"
  },
  "summary": "Time to complete: 45–60 minutes Difficulty: 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": "Time to complete: 45–60 minutes",
      "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_en.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Time to complete: 45–60 minutes"
    },
    {
      "id": "AR-GUIDE-POSHAGOVOE-002",
      "statement": "Difficulty: 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_en.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Difficulty: Intermediate"
    },
    {
      "id": "AR-GUIDE-POSHAGOVOE-003",
      "statement": "You will need: Node.js LTS (check with node -v), npm, git, a terminal, a text editor, and an MCP-capable AI agent (for example Claude Desktop) that supports the MCP Apps extension for rendering interactive UI resources — confirm the supported extensions in your client's documentation.",
      "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_en.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "You will need: Node.js LTS (check with node -v), npm, git, a terminal, a text editor, and an MCP-capable AI agent (for example Claude Desktop) that supports the MCP Apps extension for rendering interactive UI resources — confirm the supported extensions in your client's documentation."
    },
    {
      "id": "AR-GUIDE-POSHAGOVOE-004",
      "statement": "OS: macOS 13+, Windows 11, or Ubuntu 22.04+ with a shell. Any OS with a current Node.js works for the code itself.",
      "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_en.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "OS: macOS 13+, Windows 11, or Ubuntu 22.04+ with a shell. Any OS with a current Node.js works for the code itself."
    },
    {
      "id": "AR-GUIDE-POSHAGOVOE-005",
      "statement": "Node.js LTS + npm: verify with node -v and npm -v. If the output is older than the current LTS, install it via nvm (macOS/Linux) or the official installer. Exact minimum version — check the MCP TypeScript SDK README for the release you install.",
      "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_en.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "Node.js LTS + npm: verify with node -v and npm -v. If the output is older than the current LTS, install it via nvm (macOS/Linux) or the official installer. Exact minimum version — check the MCP TypeScript SDK README for the release you install."
    },
    {
      "id": "AR-GUIDE-POSHAGOVOE-006",
      "statement": "MCP agent/client: Claude Desktop or another client that supports both the base MCP protocol and the MCP Apps extension. A client that supports only base MCP will call your tools but show no interactive UI.",
      "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_en.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "MCP agent/client: Claude Desktop or another client that supports both the base MCP protocol and the MCP Apps extension. A client that supports only base MCP will call your tools but show no interactive UI."
    }
  ],
  "relationships": [
    {
      "subject": "Guide",
      "predicate": "describes",
      "object": "How to Build an MCP App with an Interactive UI and Connect It to an AI Agent",
      "claim_id": "AR-GUIDE-POSHAGOVOE-001"
    },
    {
      "subject": "Guide",
      "predicate": "includes step",
      "object": "Step 1. Scaffold the MCP server and expose your first tool",
      "claim_id": "AR-GUIDE-POSHAGOVOE-001"
    }
  ],
  "questions_and_answers": [
    {
      "question": "What is required?",
      "answer": "OS: macOS 13+, Windows 11, or Ubuntu 22.04+ with a shell. Any OS with a current Node.js works for the code itself.; Node.js LTS + npm: verify with node -v and npm -v. If the output is older than the current LTS, install it via nvm (macOS/Linux) or the official installer. Exact minimum version — check the MCP…",
      "claim_ids": [
        "AR-GUIDE-POSHAGOVOE-003"
      ],
      "article_anchor": "#requirements"
    },
    {
      "question": "How to do it?",
      "answer": "Step 1. Scaffold the MCP server and expose your first tool → Step 2. Add the interactive UI resource and bind it to the tool → Step 3. Connect the app to the AI agent and verify end to end",
      "claim_ids": [
        "AR-GUIDE-POSHAGOVOE-004"
      ],
      "article_anchor": "#step-1"
    },
    {
      "question": "Which topics does it cover?",
      "answer": "MCP Apps, как создать MCP App, MCP сервер с интерфейсом, MCP UI extension, подключить MCP App к Claude",
      "claim_ids": [
        "AR-GUIDE-POSHAGOVOE-002"
      ],
      "article_anchor": "#entities"
    },
    {
      "question": "What are the key points?",
      "answer": "Time to complete: 45–60 minutes Difficulty: Intermediate",
      "claim_ids": [
        "AR-GUIDE-POSHAGOVOE-007"
      ],
      "article_anchor": "#tldr"
    }
  ],
  "limitations": [
    "Current versions, prices and limits.",
    "Independent benchmarks and quality checks.",
    "Terms of use and data policy."
  ],
  "citation": {
    "preferred_citation": "AI Release. Пошаговое руководство: как создать MCP App с интерактивным интерфейсом и подключить его к ИИ-агенту. https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn_en.html",
    "canonical_url": "https://ai-release.org/guides/poshagovoe-rukovodstvo-kak-sozdat-mcp-app-s-interaktivn_en.html",
    "publisher": "AI Release"
  }
}