【結論】解決策 / 実行コマンド
Notion連携は公式APIまたはNotionのMCP接続を使い、最小権限で開始します。
APIキーをシェルコマンドへ直接書かず、シークレットマネージャーや安全な環境変数へ保存します。
最初は読み取り専用でデータベースのスキーマを確認し、作成・更新は別承認にします。
# ターミナルで実行：MCP接続一覧を確認
claude mcp list
# 起動後のセッション内で実行：MCP認証状態を確認
/mcp
# ターミナルで実行：Node.jsプロジェクトを準備
npm init -y
# ターミナルで実行：公式SDKを追加
npm install @notionhq/client具体的な手順・設定方法
Notion Integrationを作成し、対象ページだけへ接続します。
Title、Rich text、Selectなど実際のプロパティ名と型を確認します。
dry-runで送信JSONを表示し、承認後にテスト用ページを一件だけ作成します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
Notionデータベースのスキーマを読み取り専用で確認してください。
日報ページを作るNode.jsスクリプトを作成しますが、API呼び出しは実行しないでください。
送信予定JSONと必要な環境変数名だけを提示してください。注意点・よくあるエラーと対処法
Notionキーをプロンプト、Git、シェル履歴へ残さないでください。
400エラーを自動再試行し続けず、プロパティ型とAPIバージョンを確認してください。
大量のTODOを一括登録する前に重複、レート制限、ロールバック方法を用意してください。