ChatGPTとClaudeのためのAI対応ドキュメント作成ガイド
ChatGPT、Claude、Perplexity、そしてAIエージェントが読み取れるヘルプセンターの条件とは？クロール可能なHTML、適切なrobots.txt設定、結論から始まる記事構成、そしてllms.txtとMCPの現実的な評価について解説します。
Berkay Akpolat5分で読めます
2026年11月3日更新
ドキュメントをAI対応にするには、まず効果が実証されている基本から始めましょう。AIクローラーがページをプレーンなHTMLとして取得できること、robots.txtで検索ボットを許可していること、各記事が1つの質問に対して明確に回答し、プランや役割、制限事項を明記していることが重要です。最新の状態を維持した上で、Markdownコピー、llms.txt、そしてAIエージェント用のMCPサーバーを追加しましょう。これらは導入コストは低いものの、現時点ではAIの回答精度に対する測定可能な効果は限定的です。
本ガイドは、顧客がChatGPT、Perplexity、GoogleのAI概要（AI Overviews）で製品の使い方を検索するようになったサポート担当者や、Claude CodeやCursorをドキュメントに活用している開発チームに向けたものです。エビデンスがある手法と、まだ実験段階の手法を明確に区別して解説します。
AI対応ドキュメントとは何か？
AI対応ドキュメントとは、AIシステムが取得、理解、そして正確に引用できるドキュメントのことです。回答エンジン向けの「AIが読み取れるドキュメント」と、それに基づいて行動する「AIエージェント向けのドキュメント」の2種類が重要です。
- 回答エンジン（ChatGPT検索、Perplexity、Claude、Google AI概要、AIモード）：顧客の質問に回答し、ソースとしてページを引用します。
- AIエージェント（Claude Code、Cursor、Codex、カスタムアシスタント）：MarkdownファイルやMCPサーバーを通じてドキュメントを読み取り、タスクを実行します。
どちらも急速に成長しています。Stack Overflowの2025年の調査では開発者の84%がAIツールを使用している、または使用を予定していることが判明しました。また、Similarwebの集計によると、2025年6月のAIプラットフォーム経由の参照訪問数は前年比357%増の11億3000万回に達し、その80%以上をChatGPTが占めています。さらに、GoogleがAIによる要約を表示するとクリック率が低下する傾向があり、Pew Researchの調査では、AI要約がある場合のリンククリック率は8%で、ない場合の15%と比較して低いことがわかりました。クリックなしで回答が表示される以上、その回答は正確でなければならず、正確さはドキュメントの質に依存します。顧客がどこでヘルプを探しているかについての詳細は、当社の顧客セルフサービス統計をご覧ください。
AIクローラーはヘルプセンターを実際に読み取れるか？
まずはここを確認してください。これができていなければ、他の対策は意味をなしません。
テキストはHTMLに含まれているか？ Vercelによる2024年12月のクローラートラフィック分析によると、GoogleのGeminiクローラーとAppleのクローラーを除き、主要なAIクローラーのいずれもJavaScriptをレンダリングしません。クライアントサイドのJavaScriptで記事を読み込むヘルプセンターは、ChatGPTやClaudeのクローラーからは空のページに見える可能性があります。テストしてみましょう：
curl -s -A "GPTBot" https://help.example.com/your-article \
| grep "a sentence from the article"もしレスポンスに文章が含まれていなければ、クローラーもそれを認識できていません。サーバーサイドレンダリング（SSR）やプリレンダリングで解決できます。
URLは正しく解決されるか？ 同じVercelのデータでは、ChatGPTとClaudeのクローラーによる取得の約35%が404エラーになっています。記事の移動や名称変更時にはリダイレクトを維持し、サイトマップを最新の状態に保ってください。プラットフォームを移行する場合は、ヘルプセンター移行チェックリストに従いましょう。
ページは公開されているか？ 回答エンジンはログインが必要なページを読み取れません。顧客向けの非公開ドキュメントがある場合、AIの回答は公開ページ、フォーラム、サードパーティサイトから生成されることを前提とする必要があります。
robots.txtで許可すべきAIボットは？
各AI企業は、学習用と検索用に別々のボットを運用しています。「すべてのAIボット」をブロックすると、AIの回答から自社サイトが除外されてしまいます。
| ボット（企業） | 役割 | ブロックすべきケース |
|---|---|---|
| GPTBot (OpenAI) | モデル学習用のコンテンツ収集 | 学習への利用を拒否したい場合 |
| OAI-SearchBot (OpenAI) | ChatGPT検索用ページの検索 | 稀：ブロックするとChatGPTの検索回答から除外される |
| ChatGPT-User (OpenAI) | ユーザーの質問時にページを取得 | 非推奨：ユーザー主導の取得はrobots.txtに従わない場合がある |
| ClaudeBot (Anthropic) | 学習用のコンテンツ収集 | 学習への利用を拒否したい場合 |
| Claude-SearchBot, Claude-User (Anthropic) | 検索インデックス作成およびユーザー要求による取得 | Claudeの検索回答から除外したい場合のみ |
| PerplexityBot (Perplexity) | 回答引用のためのインデックス作成（学習用ではない） | Perplexityの回答から除外したい場合のみ |
| Perplexity-User (Perplexity) | ユーザーの質問時にページを取得 | 非推奨：Perplexityは通常robots.txtを無視すると公言している |
| Google-Extended (Google) | Geminiの学習およびGeminiアプリでのグラウンディング（検索やAI概要は対象外） | Geminiの学習やグラウンディングへの利用を拒否したい場合 |
詳細は各社の公式ドキュメントを参照してください：OpenAI、Anthropic、Perplexity。引用は許可するが学習には利用させたくないヘルプセンターの場合は、以下のように記述できます：
User-agent: GPTBot
Disallow: /
User-agent: ClaudeBot
Disallow: /
User-agent: Google-Extended
Disallow: /
User-agent: *
Allow: /
Sitemap: https://help.example.com/sitemap.xml独自のグループを持つボットは*ルールを無視するため、各グループ内でDisallow行（/adminなど）を繰り返す必要があります。Google-Extendedをブロックすると、Geminiアプリがページを根拠として回答することも停止されますが、Google検索やAI概要には影響しません。
また、CDNやファイアウォールの設定も確認してください。「AIボットをブロック」するトグルが有効になっていると、robots.txtの設定が上書きされる可能性があります。
AIが正しく回答できるようにヘルプ記事を書くには？
回答エンジンはサイト全体ではなく、特定の箇所を抽出します。各箇所が単独で意味を成す必要があります。
- 1記事につき1タスクとし、顧客の検索ワードに合わせる。 「サブスクリプションの管理」ではなく「サブスクリプションのキャンセルまたは一時停止」。
- 結論から書く。 各見出しの直後の最初の2文でその見出しの質問に回答します。当社のヘルプセンター記事テンプレートはこの構成に基づいています。
- 条件を明記する。 プラン、役割、プラットフォームを記載します。「管理者のみがワークスペースを削除できます」は引用可能ですが、「ワークスペースを削除できます」と書くと、他のユーザーに対して誤った回答を生成してしまいます。
- 製品でできないことを明記する。 アシスタントは「〜できますか？」とよく聞かれます。ドキュメントに存在するものしか書かれていないと、モデルは推測で回答してしまいます。
- 用語を統一し、一度定義する。 「ワークスペース」「アカウント」「組織」が同じ意味なら、1つに絞り、製品用語を定義する短い用語集ページを作成しましょう。
- すべてのページに適切なメタデータを付与する。 明確なタイトル、1行の説明文、最終更新日、該当する場合はプランや製品領域を記載します。回答エンジンやサイト内検索はこれらを使用して、質問に対する最適なページを判断します。
- 画像や動画の中に手順を隠さない。 すべてのスクリーンショットに適切な代替テキストを付与し、動画で示される手順がテキストとしても存在することを確認してください。
- エッジケースの前に基本を網羅する。 ヘルプセンターを構築中であれば、まずはAIを活用したナレッジベースの構築方法から始めましょう。
- 常に最新の状態を保つ。 古い記事は、自信を持って提示される「古い回答」になります。当社のドキュメントを最新に保つ方法ガイドではリリースごとのルーチンを解説しており、リリースごとにドキュメントを自動更新する方法ではリリースプロセスからの自動化手法を紹介しています。
Googleも同様のことをより平易に述べています。AI機能に関して、通常のSEO以外に「追加の要件」や特別な最適化は不要としています。また、AIのためにコンテンツを細切れにする必要はないともガイドに記載されているため、モデルに合わせて記事を断片化する必要はありません。
ドキュメントにllms.txtを追加すべきか？
ベンダーが示唆するほどの効果はありません。llms.txtはサイトのルートに配置するMarkdownファイルで、最も重要なページを短い説明付きでリスト化したものです。Jeremy Howardが2024年9月に言語モデル向けのマップとして提案しました。
これまでのエビデンスは以下の通りです：
- Googleは無視します。 Googleのガイドによると、Google検索に表示させるために新しい機械可読ファイル、AIテキストファイル、マークアップ、Markdownは不要であり、llms.txtファイルは検索エンジンが無視するため、役にも立たず害にもなりません。2025年当時、GoogleのJohn Muellerはllms.txtをキーワードメタタグになぞらえました。
- リクエストするボットはほとんどいません。 Ahrefsが137,210のドメインを調査したところ、2026年5月にllms.txtファイルへのリクエストがゼロだったのは97%でした。AI検索ボットによるリクエストは全体のわずか1.1%（AIアシスタントが2.5%）で、Claude Codeのようなコーディングエージェントが主な読者でした。
結論：ドキュメントプラットフォームが無料で提供しているならllms.txtを追加しましょう。特に開発者がコーディングエージェントでドキュメントを利用している場合は有効ですが、ChatGPTの回答内容が変わることは期待しないでください。llms-full.txt（全ページを1ファイルにまとめる）は一般的な慣習であり、提案の一部ではありません。
ドキュメントはMarkdownで提供すべきか？
コストがかからないのであれば、提供すべきです。ページを取得するエージェントは、ナビゲーションやスクリプトで埋め尽くされたHTMLよりも、クリーンなMarkdownの方がうまく処理できます。llms.txtの提案では、各ページを.mdを追加した同じURLで提供することが推奨されています。3つの詳細を挙げます。
- Markdownコピーには
noindex（X-Robots-Tagヘッダーが有効）を付け、検索エンジンがHTMLページの重複と見なさないようにします。 - HTMLと同じソースから生成し、内容が乖離しないようにします。
- エージェントが見つけられるようにします。提案では、各HTMLページに
<link rel="alternate" type="text/markdown">タグを付けることが推奨されています。
AIエージェントはMCP経由でドキュメントをどう利用するか？
Model Context Protocolは、AIアプリケーションがツールを呼び出し、他のシステムからデータを読み取るためのオープン標準です。ドキュメント用のMCPサーバーを使えば、エージェントは学習済みの知識に頼るのではなく、必要に応じてドキュメントを検索でき、適切な権限があればページの草案作成や更新も可能です。利用可能なサーバーの比較については、ドキュメント用MCPサーバーを参照してください。
独自のドキュメント用アシスタント（RAG：検索拡張生成）を構築する場合も同じルールが適用されます。アシスタントの精度は、取得する文章の正確さに依存します。2つの注意点：人が書き込みをレビューしない限り、顧客向けコンテンツへのアクセスは読み取り専用にすること。また、MCPはユーザー自身が接続するエージェントを支援するものであり、公開されている回答エンジンの回答内容を変えるものではないことを覚えておいてください。
AIアシスタントが自社製品についてどう回答しているかテストする方法は？
モデルの内部を見ることはできないため、出力をテストします。月に一度、以下を行います。
- チケットやヘルプセンターでの検索失敗から、実際の顧客の質問を20個書き出す。
- ChatGPT、Perplexity、Claude、Google（AIモードまたはAI概要）でそれぞれ質問する。
- 回答が正しいか、どのページを引用しているかを記録する。
| 質問（アシスタント） | 回答内容（引用元） | 修正 |
|---|---|---|
| CSVで請求書をエクスポートするには？（ChatGPT） | 部分的に正しい：古いメニューパス（2024年のフォーラム投稿） | エクスポート記事を更新し、新しいパスを最初の段落に記載する |
| サブスクリプションを一時停止できるか？（Perplexity） | 間違い：不可能と回答（ソースなし） | プランの制限を明記した「一時停止またはキャンセル」記事を追加する |
- 間違った回答の元となった記事を修正し、翌月再テストする。
トラフィック面を確認するには、リファラー（chatgpt.com、perplexity.ai、claude.ai）ごとに訪問をセグメント化し、サーバーログで上記の表にあるボット名（独自のユーザーエージェントを持たないGoogle-Extendedを除く）をチェックします。Googleは、Search Consoleのパフォーマンスレポートの「ウェブ検索」タイプにおいて、AI機能からのクリック数をカウントしています。
ドキュメントをAI対応にするためのチェックリスト
| 優先度 | タスク | 根拠 |
|---|---|---|
| 1 | JavaScriptなしでHTML内に記事テキストが存在する | 強力：主要なAIクローラーはJSをレンダリングしない |
| 2 | robots.txtとファイアウォールが検索ボットのアクセスを許可している（学習ボットは任意） | 強力：各AI企業が文書化 |
| 3 | 1記事につき1タスク、結論から書き、プランと役割を明記 | 良好：Googleのガイダンスに合致 |
| 4 | リリースごとにコンテンツを更新、404エラーなし | 良好：古いページは誤った回答を生む |
| 5 | サイトマップが最新 | 良好：標準的な発見方法 |
| 6 | 各ページのMarkdownコピー、noindex設定 | 中程度：コーディングエージェントが利用 |
| 7 | llms.txt | 現時点では弱い：リクエストが少なく、Googleは無視 |
| 8 | エージェント用MCPサーバー | エージェント利用者に有用、公開回答には影響なし |
| 常に | 月に一度、実際の質問20個をテスト | 自社独自の根拠 |
CleveraのヘルプセンターがAI読者向けに構築されている理由
Cleveraは、画面録画からナレーション付きのハウツー動画、ステップバイステップのヘルプ記事、そしてホスト型ヘルプセンターのページを74言語で自動生成するAIプラットフォームです。ホスト型ヘルプセンターは、Freeプランを含むすべてのプランで、チェックリストの技術的な項目の大半を処理します。
- プリレンダリングされたページとサイトマップ： クローラーが取得するHTML内に記事テキストが含まれます。
llms.txt、llms-full.txt、および各ページの.mdコピー： 「llms.txtとMarkdownコピー」（AIツールがドキュメントを読み取れるようにする）設定で、デフォルトでオンになっています。当社のヘルプセンターでは、Markdownコピーはnoindexで提供されています。プライベートヘルプセンター（Pro以上）では、これらすべてがログインの背後に保護されます。- 読者向け「AIに質問」： （「設定」→「AIアシスタント」で「アシスタントを表示」をオンにしてください。Freeプランで月300回答まで）。組み込みのアシスタントは公開済みのページからのみ回答し、ソースをリンクし、ドキュメントにない質問にはその旨を伝え、回答できなかった質問を「未回答の質問」としてリストアップするため、次に何を書くべきかがわかります（ヘルプセンターのコンテンツギャップに関する当社のガイドで、その対処法を紹介しています）。
- AIエージェントとMCP（Pro以上）： Claude Code、Codex、Cursor、Claude、ChatGPTは、CleveraのMCPサーバーとAPIを通じてヘルプセンターを検索、草案作成、および（公開権限があれば）更新できます。「サポートアシスタント」トークンは、公開済みのパブリックページのみを検索可能です。
これは当社ヘルプセンターが公開しているllms.txtの冒頭部分です（短縮版）：
# Clevera Help Center
> Clevera turns screen recordings into polished videos: record your screen
> or let the AI record a website, edit with zooms, captions and AI
> voice-overs, then share or embed the result. ...
Every page is also available as Markdown: append `.md` to its URL.
The full text of all pages is at https://help.clevera.ai/llms-full.txt.
### Getting started
- [Understand what Clevera makes](https://help.clevera.ai/docs/getting-started/what-clevera-makes.md): ...
執筆作業は依然としてユーザーの役割ですが、Cleveraはそこも支援します。画面録画から生成された記事は、画面のスクリーンショット付きの番号付きステップとして出力されます。動画の背後にある録画データから記事を作成することもできるため、手順が動画の中に埋もれることはありません。ChatGPTが貴社を引用することを保証できるプラットフォームは存在せず、当社も保証はいたしません。
無料で開始してホスト型ヘルプセンターを利用するか、Zendesk、Intercom、GitBookなどのプラットフォームから既存のヘルプセンターをインポートしてください。設定はドキュメントサイトの閲覧権限管理、ドキュメントサイトのアシスタント設定、ドキュメントサイトへのAIエージェント接続から行えます。製品概要はヘルプセンターソフトウェアページおよびドキュメントサイト立ち上げ記事で確認できます。
FAQ
llms.txtはヘルプセンターに追加する価値があるか？
プラットフォームが無料で生成してくれるなら追加しましょう。コストはかからず、コーディングエージェントは読み取りますが、Googleは使用しておらず、AI検索ボットからのリクエストはほとんどないという調査結果もあります。クロール可能なHTMLと、明確で最新の記事の方がはるかに重要です。
ChatGPTに自社製品に関する質問を正しく回答させるには？
OAI-SearchBotが公開ヘルプセンターをクロールできること、記事テキストがHTMLに含まれていること、各記事が条件を明記した上で1つの質問に答えていることを確認してください。その上で、実際の顧客の質問を毎月テストし、間違った回答の元となっているページを修正します。これにより確率は向上しますが、ChatGPTに確実に引用させる方法はありません。
GPTBotとClaudeBotをブロックすべきか？
それは可視性の問題ではなく、学習に関する判断です。GPTBotとClaudeBotをブロックするとドキュメントはモデル学習から除外されますが、ChatGPTやClaudeの検索結果から削除されるわけではありません。これらはOAI-SearchBotとClaude-SearchBotを使用しているためです。引用されたい場合は、これらをブロックしないでください。
構造化データはAI概要に役立つか？
Googleは、AI機能のために特別なスキーマは不要であると述べています。通常の検索と同様に、表示されているコンテンツを記述するために構造化データを使用してください。
AI対応ドキュメントとヘルプセンターのAIチャットボットの違いは？
AI対応のドキュメントがあれば、外部のAIアシスタントが貴社のページから回答を生成できるようになります。CleveraのAsk AIのようなヘルプセンター向けチャットボットも、同じドキュメントを活用して貴社のサイト上で読者の質問に回答します。どちらも、明確で最新の状態に保たれた記事が不可欠です。
