概要
https://tech.smarthr.jp/entry/2025/12/04/081310
詳細内容
## MCP Serverで大量のヘルプページを爆速で作る
https://tech.smarthr.jp/entry/2025/12/04/081310
SmartHRは社内AIワークフローツール「MCP Server」を活用し、新機能のヘルプページ作成工数を大幅に削減しました。
**Content Type**: ⚙️ Tools
**Language**: ja
**Scores**: Signal:4/5 | Depth:4/5 | Unique:4/5 | Practical:5/5 | Anti-Hype:4/5
**Main Journal**: 86/100 | **Annex Potential**: 84/100 | **Overall**: 84/100
**Topics**: [[AI活用, UXライティング, 開発効率化, AIエージェント, ヘルプページ生成]]
SmartHRのUXライターが、新機能「ID管理機能」の連携先SaaSが3ヶ月で50件に達するという目標に対し、連携先ごとに必要となるヘルプページ作成の膨大な工数削減に着手しました。この課題解決のため、社内AIワークフローツール「MCP Server」を活用し、AIによるヘルプページの初稿自動生成システムを構築しています。
この取り組みの核心は、MCP Serverの「ツール」機能を用いて、AIに安定した品質のヘルプページを書かせるための詳細なプロセス設計と継続的な改善にあります。著者は、まずAIに渡すべき情報として、GitHubのPull Request、API仕様書、Design Doc、そしてChatGPTやGeminiで調査したAPIトークン取得方法を特定。次に、AIが「SmartHRとID管理の基本情報把握」「連携先情報把握」「既存ヘルプページ調査」「ヘルプページ執筆」「AIによるセルフレビュー」という5つのステップを踏むように定義しました。このステップ分割は、以前のプロジェクトで精度向上に寄与した知見に基づいています。
ツールの完成後も、UXライターが初稿を修正し、その修正前後をAIエディタに読み込ませて「どの指示を修正すべきか」をAI自身に提案させるという独自の改善サイクルを導入。これにより、人間が直接指示を修正するよりも効果的にツールの精度を高め、AIが出力する文章の質を安定させました。
結果として、1ページあたり1〜2時間かかっていたヘルプページ作成工数を約30分に短縮でき、開発チームの負担を大幅に軽減。さらに、AIが決められたフォーマットで抜け漏れなく初稿を生成するため、UXライターのレビューコストも減少しました。著者は、この効率化の鍵が「AIがヘルプページ作成に必要な情報」を洗い出し、人間が調査すべき内容を明確化した点にあると強調しています。このアプローチは、AIを単なる生成ツールとしてではなく、特定のワークフローに組み込み、人間との協調を通じて継続的に改善していく具体的な事例として、Webアプリケーションエンジニアにとって非常に示唆に富むものです。