UZU Docs

Appearance

Notion FAQ更新手順（MCP使用） ​

このドキュメントでは、Claude Code の Notion MCP を使用してよくある質問（FAQ）を更新する手順を説明します。

前提条件 ​

  • Claude Code で Notion MCP が有効化されていること
  • Notion ワークスペースへのアクセス権限があること

手順 ​

1. Notion MCP への接続 ​

bash
/mcp

コマンドを実行して Notion MCP に接続します。成功すると以下のメッセージが表示されます：

Authentication successful. Connected to notion.

2. 既存のFAQページの確認 ​

現在のFAQページの内容を確認します：

javascript
mcp__notion__fetch({
  "id": "https://www.notion.so/uzu-app/7e1ab190f8554f79ba4db7f0db673e67"
})

3. 新しいFAQページの作成 ​

新しい質問と回答のページを作成します：

javascript
mcp__notion__notion-create-pages({
  "parent": {"page_id": "7e1ab190f8554f79ba4db7f0db673e67"},
  "pages": [{
    "properties": {
      "title": "新しい質問のタイトル"
    },
    "content": "# 質問のタイトル\n\n問題の説明\n\n## 解決方法\n\n1. 手順1\n2. 手順2\n3. 手順3\n\n## それでも解決しない場合\n\n[問い合わせフォーム](https://forms.uzu-app.com/)よりお問い合わせください。"
  }]
})

4. メインFAQページへのリンク追加 ​

作成したページのIDを使用して、メインFAQページにリンクを追加します：

javascript
mcp__notion__notion-update-page({
  "data": {
    "page_id": "7e1ab190f8554f79ba4db7f0db673e67",
    "command": "insert_content_after",
    "selection_with_ellipsis": "### その他\n<page url=\"{{...}}}>既存の最後のFAQ</page>",
    "new_str": "\n<page url=\"{{https://www.notion.so/新しいページID}}\">新しい質問のタイトル</page>"
  }
})

実例：Windows画像表示問題の追加 ​

作成したページ ​

含まれる内容 ​

  1. 問題の説明: Windows環境での画像表示問題
  2. 解決方法:
    • Windows Update の実行
    • PC の再起動
    • アプリの再起動
  3. 原因説明: システムコンポーネントの更新が必要
  4. 追加サポート: 問い合わせフォームへの誘導

ベストプラクティス ​

ページ構成 ​

  1. 明確なタイトル: 問題を具体的に表現
  2. 問題の説明: ユーザーが直面している状況を詳しく説明
  3. 段階的な解決方法: 番号付きリストで手順を明示
  4. 代替案: 最初の解決方法で解決しない場合の対応
  5. サポート連絡先: 問い合わせフォームへのリンク

コンテンツのポイント ​

  • 具体性: 抽象的でなく、具体的な手順を記載
  • 順序性: 実行すべき順序を明確に
  • 完結性: そのページだけで解決できるよう情報を完備
  • アクセシビリティ: 技術的でない用語で説明

注意事項 ​

URL フォーマット ​

Notion の内部リンクは以下の形式で記述します：

markdown
<page url="{{https://www.notion.so/ページID}}">ページタイトル</page>

エラーハンドリング ​

  • URL は二重波括弧で囲む（ の形式）
  • ページIDは作成時に返される値を正確に使用
  • 親ページのIDが正しいことを確認

更新時の検証 ​

  1. 作成されたページが正しく表示されることを確認
  2. メインFAQページからのリンクが機能することを確認
  3. 内容が読みやすく、実際に役立つことを確認

トラブルシューティング ​

よくあるエラー ​

  1. Invalid agent URL エラー: URL フォーマットの問題
  2. 権限エラー: Notion ワークスペースへのアクセス権限不足
  3. ページID エラー: 存在しないページIDの参照

解決方法 ​

  1. URL の形式を確認し、正確な Notion フォーマットを使用
  2. MCP 接続を確認し、必要に応じて再接続
  3. 作成されたページの ID を正確にコピー

関連リンク ​