AIエージェントをドキュメントサイトに接続する
Claude Code、Codex、ChatGPT、または独自のスクリプトを使用して、ドキュメントサイトのページをドラフト作成、整理、公開できます。プラン（Pro以上）、ドキュメントサイトの権限、サイトのスコープ設定、公開ルールについて解説します。AIエージェントとAPIの全ガイドへのリンクも含まれています。
Claude Code、Codex、Cursor、Claude、ChatGPTなどのAIエージェントは、記事のドラフト作成、読者の評価が低いページの修正、コンテンツの不足への対応、翻訳、公開など、ドキュメントサイトの読み書きを代行できます。この記事では、ドキュメントサイトに特化した内容を説明します。トークン、コネクタ、利用料金、エラーについてはAIエージェントとAPIで解説しています。
始める前に
- AIエージェントとAPIは、Pro、Business、Customプランで利用でき、ClaudeおよびChatGPT用のコネクタが含まれます。FreeおよびStarterプランでは利用できません。ワークスペースがこれらのプランに変更されると、トークンやアプリは動作を停止します。
- エージェントは、そのトークンを作成または接続したユーザーの役割の範囲内で動作します。エージェントがサイト上で行えることは、そのユーザーの権限を超えることはありません。
- API呼び出しにクレジットは消費されません。AIによるページの翻訳やサイトページの生成にはクレジットが消費されます。また、クレジットを消費できる権限を持つトークンを使用した場合のみ実行可能です。
エージェントを接続する
ワークスペースメニューを開いてAIエージェントとAPIを選択するか、ドキュメントサイトの設定メニューからAIエージェントとAPIを選択します（そのサイトのアクティビティが開きます）。
- Claude Code、Codex、Cursor、またはスクリプト用のAPIトークン: トークン → 新しいトークンを選択し、4ステップのウィザード（目的、権限、制限、確認）を進めます。ライターやパブリッシャーなどのドキュメントサイト用プリセットを選択し、制限 → ドキュメントサイトで対象サイトを選択して、一度だけ表示されるトークンをコピーします。APIトークンの作成を参照してください。
- Claude.aiまたはChatGPT用のコネクタ: 接続済みアプリからコネクタURLをコピーしてアプリに貼り付け、サインインしてサイトとアクセスを選択します。AIアプリとエージェントを接続するを参照してください。
ドキュメントサイトのプリセット
| プリセット | 画面上の説明 | 用途 |
|---|---|---|
| ライター | 「エージェントがドラフトを作成し、人が確認して公開します。」 | 記事や変更履歴のドラフト作成、画像のアップロード |
| パブリッシャー | 「読者に表示される内容を変更できる信頼された自動化。」 | 公開、設定、サイト作成を含むドキュメントサイトの全操作 |
| サポートアシスタント | 「公開されたドキュメントから回答します。それ以外は行いません。」 | 公開済みの公開ページのみを検索するヘルプボット |
| 読み取り専用 | 「調査、監査、翻訳チェック。」 | コンテンツの読み取り |
| アナリスト | 「コンテンツと読者のシグナルを読み取り、修正を提案します。」 | コンテンツとインサイトの読み取り |
プロデューサーとワークスペースエージェントは、動画の追加やクレジット消費が可能です。すべての権限と付与可能なユーザーについては、エージェントの権限を参照してください。
ドキュメントサイトの権限
| 権限 | 許可される操作 |
|---|---|
content:read |
サイト、ページ、記事（ドラフト含む）、リビジョン、変更履歴、サイトページの読み取り |
articles:write |
記事のドラフト作成、および公開されていない記事の編集 |
structure:write |
セクションの作成と編集、ページの移動、非表示、名前変更 |
site-pages:write |
ホーム、お問い合わせ、法的ページなどのサイトページの編集 |
changelog:write |
変更履歴エントリのドラフト作成と編集 |
media:write |
画像のアップロード |
site:publish |
公開：読者に表示される内容の変更、公開済みコンテンツの編集、ページの準備完了マーク |
insights:read |
検索の不足、未回答の質問、ページフィードバックの読み取り |
site:configure |
サイト設定、外観、ナビゲーションの変更 |
sites:create |
新しいドキュメントサイトの作成 |
help:read |
公開済みの公開ページのみを検索（サポートアシスタント用） |
読み取りはすべてのメンバーに許可されています。書き込みと整理は、オーナー、管理者、編集者、コンテンツクリエイターが行えます。公開とサイト設定は、オーナー、管理者、編集者が行えます（「公開権限を付与できるのはオーナー、管理者、編集者のみです」）。サイトの作成は、オーナーと管理者が行えます。
トークンがカバーするサイト
制限 → ドキュメントサイトで、すべてのサイト（「新しいサイトを含む、このワークスペース内のすべてのドキュメントサイト」）または選択されたサイトを選択します。トークンや接続されたアプリは、カバーされているサイトのみを閲覧・変更できます。記事がスコープ外のサイトにも表示されている場合、変更は拒否されます：「この記事は、このトークンでは変更できないサイトにも表示されています。」
公開済みコンテンツには公開権限が必要
site:publishがない場合、エージェントは読者に表示される内容を変更できません。公開済みの記事を編集しようとすると拒否され（「このコンテンツは公開サイトで公開されているため、変更にはサイトの公開権限が必要です」）、エージェントは代わりにドラフトをレビュー用に提出できます。その際、「agentがsite上のpageのレビューを依頼しました」という通知が届きます：「何も公開されませんでした。記事を確認し、準備ができたら公開してください。」
エージェントが行ったすべての変更は、ページの履歴に「エージェント name (token)」として表示されます。公開操作はトークンごとに1時間あたり10回までです。一時停止中のサイトは、エージェントにとって読み取り専用となります：「このサイトは一時停止中またはオフラインのため、読み取り専用です。」
エージェントがサイトで行えること
サイトの一覧表示、ページツリーの読み取り、ページの検索と読み取り、Markdownのプレビュー、記事の作成と更新、レビュー用提出、セクションとページの整理、サイトページと変更履歴の編集、画像のアップロード、インサイトの読み取り、不足情報のカバー済みマーク、設定・外観・ナビゲーション・リダイレクトの変更、サイト作成、ページの翻訳、サイトページの生成、公開、ロールバック。それぞれに対応する権限が必要です。