受講者用_NotionMCPテスト自動記録講座

うさうさ研修工房 ｜ Udemy講座 受講者用 Claude Code × Notion MCPで作る テスト結果自動記録ツール開発 Windows / VSCode 対応 ｜ pytest・Jest の両対応 ｜ 法人研修レベル

この講座で作るもの テストを回すと、結果がNotionに自動で並ぶ テスト実行 結果JSON Claude Code Notion DB pytest / Jest results.json ＋ Notion MCP テスト結果一覧 手作業のコピペ転記をなくし、「いつ・どの環境で・何が落ちたか」を誰でも検索できる状態に する ゴール：Windows上で、自分のテストが1コマンドでNotionに記録され、チームに共有できる うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 2

はじめに 対象・到達目標・前提 対象 到達目標 前提 新人〜中堅エンジニア テスト結果を共通形式のJSONに できる Windows 10/11 の PC Notion MCP経由でDBへ登録・ 更新できる Python か Node.js の基礎経験 QA・テスト担当 テスト結果を手で転記している人 Notionアカウント（無料可） 安全に運用するルールを説明でき る うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 3

全体ロードマップ スロープ設計：知識 → 橋渡し → 実践 前半｜知識編 1 2 3 4 全体像 Windows環境 MCPの仕組み DB設計 なぜ自動記録か VSCode・Claude Code Notion MCP接続 プロパティとJSON 橋渡し：Claude CodeからNotionへ「1行書き込む」ハンズオン 後半｜実践編 5 6 7 8 テスト実行 Notion書き込み 自動化 法人運用 pytest / Jest 登録・更新 コマンド・hooks・CI 安全・品質 うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 4

PART 1 前半｜知識編 全体像・環境・MCP・DB設計を押さえる（Chapter 1〜4）

Chapter 1 ｜ 全体像 手作業の転記が生む3つの問題 1 2 3 転記ミス 工数の浪費 証跡が残らない コピペの取り違え・抜け。 毎回の転記は価値を生まない作業 。 いつ・どの環境・どのコミットか 結果が合っているか自信が持てな い うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 テスト回数が増えるほど重くなる 後から追えず、監査や障害調査で 困る 6

Chapter 1 ｜ 全体像 完成アーキテクチャと役割分担 テスト JSON Claude Code Notion 結果を出すだけ 共通スキーマ 読み取り・整形・登録 蓄積・検索・共有 • 各層は疎結合：テスト言語が変わっても、JSONさえ同じなら後ろは変えない • Claudeは「判断が要る整形」と「Notionへの登録」を担当する • pytest でも Jest でも、同じ DB に同じ形式で溜まる うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 7

Chapter 2 ｜ Windows環境構築 最小セットアップ・チェックリスト ツール 用途 確認コマンド VSCode 編集・ターミナル code --version Node.js (LTS) Jest・Claude Code周辺 node -v / npm -v Python 3.x pytest python --version Git コミット情報の取得 git --version Claude Code Notion MCP経由の登録 claude --version ※ 要件やインストール方法は更新されるため、Claude Code公式ドキュメントで最新を確認すること うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 8

Chapter 2 ｜ Windows環境構築 PowerShell と WSL2、どちらで進める？ PowerShell（本講座の基準） WSL2（Linux環境） ・追加設定が少なく始めやすい ・Linux前提の手順をそのまま使える ・Windowsの既存ツールと相性が良い ・本番がLinuxなら環境差が小さい ・Git for Windows が必要になる場合あり ・初回セットアップに少し時間がかかる ・文字コードとパスに注意 ・Windows側ファイルとの距離に注意 判断基準：本番環境・チームの標準に合わせる。迷ったら PowerShell で始め、必要になれば WSL2 へ うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 9

Chapter 2 ｜ Windows環境構築 Windowsでつまずく4大ポイント 症状 主な原因 対処の方向 スクリプトが実行できない PowerShellの実行ポリシー 現在のユーザー範囲で緩和（社内規程を確認） コマンドが見つからない PATHが未反映 ターミナル/VSCodeを再起動 日本語が文字化けする 文字コードの不一致 UTF-8に統一して読み書き パスや改行で失敗する \ と / ／ CRLFとLF パスは path 系API、改行はGit設定で統一 うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 10

Chapter 3 ｜ MCPの仕組み MCPは「AIと外部ツールの共通コネクタ」 Claude Code MCP Notion クライアント 共通のつなぎ方 サーバー側 • ツールごとの個別連携を作らず、同じ作法で外部サービスを呼べる • Claudeは公開されたツール（検索・ページ作成・更新など）を選んで使う • 何を許可するかは、接続時の認可で人が決める うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 11

Chapter 3 ｜ MCPの仕組み Notion MCPへの接続は3ステップ ① 登録（PowerShellでも同様） claude mcp add --transport http notion \ https://mcp.notion.com/mcp # Claude Code内で /mcp ② 認証する /mcp からNotionにログインし、許可するのは使う DBだけ ③ 疎通確認 「Notionのテスト結果DBを検索して」と頼み、返る か確認 ※ 画面や手順は更新される。最新は公式ドキュメントで確認し、許可範囲は最小に うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 12

• https://mcp.notion.com/mcp

Chapter 4 ｜ DB設計 Notion「テスト結果」DBのプロパティ プロパティ 型 例 テスト名 タイトル 足し算が正しい テストID テキスト test_calc::test_add 実行ID テキスト 20261112-1000-a1b2c3d 結果 セレクト PASS / FAIL / SKIP 実行日時 日付 2026-11-12 10:00 環境 セレクト local-win11 / ci コミット テキスト a1b2c3d 所要時間(ms) 数値 12 失敗ログ テキスト 先頭500文字のみ うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 13

Chapter 4 ｜ DB設計

結果の共通JSONスキーマ
results.normalized.json

•

id は run_id と組で一意にする（更新判定のキー
）

•

result は PASS / FAIL / SKIP の3値に正規化

•

error は先頭500文字で切る（機密はマスク）

•

pytest と Jest の出力差は、ここで吸収する

{
"run_id": "20261112-1000-a1b2c3d",
"env": "local-win11",
"commit": "a1b2c3d",
"tests": [
{
"id": "test_calc::test_add",
"name": "足し算が正しい",
"result": "PASS",
"duration_ms": 12,
"error": null
}
]
}

うさうさ研修工房 ｜ Notion MCPテスト自動記録講座

14

橋渡し ｜ 成功体験 Hello Notion：1行だけ書き込んでみる Claude Codeに入力するプロンプト テスト結果DBに、次の1行を追加して： テスト名=HelloNotion、結果=PASS、 環境=local-win11、実行日時=今 成功の目印 Notion上に新しい行ができ、プロパティが 正しい型で入っている うまくいかないとき 認可したDBが違う／プロパティ名が違う／認証切れ。まず /mcp で接続状態を確認 うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 15

PART 2 後半｜実践編 テスト・書き込み・自動化・法人運用（Chapter 5〜8）

Chapter 5 ｜ テスト実行（Python） pytestでテストを書く test_calc.py • calc.py は演習で一緒に作る # test_calc.py import pytest from calc import add, divide • 失敗するテストも1つ用意し、FAILの記録も 確認する • テスト名は日本語でも書けるが、IDは英数字 で安定させる def test_add(): assert add(2, 3) == 5 def test_divide_by_zero(): with pytest.raises(ZeroDivisionError): divide(1, 0) うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 17

Chapter 5 ｜ テスト実行（Node.js）

Jestでテストを書く
calc.test.js

// calc.test.js
const { add, divide } = require('./calc');
test('足し算が正しい', () => {
expect(add(2, 3)).toBe(5);
});

•

同じ calc 仕様を Python 版と JS 版で実装し
、比較する

•

テスト名が日本語のときの文字コードに注意
（UTF-8）

•

pytest と同じ共通JSONに最終的にそろえる

test('0で割ると例外', () => {
expect(() => divide(1, 0)).toThrow();
});

うさうさ研修工房 ｜ Notion MCPテスト自動記録講座

18

Chapter 5 ｜ テスト実行 結果をJSONで出力する 項目 pytest Jest 準備 pip install pytest-json-report npm i -D jest 実行 pytest --json-report --json-report-file=results.json npx jest --json --outputFile=results.json 出力の形 tests配列（nodeid・outcome） testResults配下（status） 共通化 共通スキーマへ正規化 共通スキーマへ正規化 出力形式はバージョンで変わる可能性がある。実際のJSONを一度読んで確認してから正規化する うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 19

Chapter 6 ｜ Notion書き込み Claude Codeに登録を頼むプロンプト プロンプト例 results.json を読み、共通スキーマに正規化して、 Notionの「テスト結果」DBに登録して。 ・run_id とテストIDが同じ行があれば更新、 なければ新規追加 ・FAIL は失敗ログを先頭500文字だけ入れる ・最後に「追加N件／更新N件／失敗N件」を報告 うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 • 条件（更新ルール・文字数・報告形式） を明文化するほど結果が安定する • 最初は少数件で試し、Notion側の結果を 目で確認 • プロンプトは後でコマンド化して再利用 する 20

Chapter 6 ｜ Notion書き込み 重複させない「更新 or 追加」の流れ 検索 判定 更新/追加 報告 run_id＋テストID あるか？ なければ新規 件数を要約 • 再実行しても行が増えない設計にする（冪等性） • キーは「run_id＋テストID」。実行ごとに履歴を残したいなら run_id を毎回変える • 書き込みに失敗しても results.json はローカルに残す うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 21

Chapter 7 ｜ 自動化 自動化は3段階で育てる 1 2 3 スラッシュコマンド hooks スケジュール / CI 手順をコマンドファイルにまとめ 、1コマンドで「テスト→記録」 を実行 作業の区切りなど決まったタイミ ングで自動実行。設定は設定ファ イルで管理 夜間実行やCIから呼び出す。無人 実行では認証と権限の扱いが要 うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 22

Chapter 8 ｜ 法人運用の品質 セキュリティ4原則 1 2 3 4 最小権限 秘密情報を残さない 機密を送らない 社内規程の確認 許可するのは対象DBだけ 。ワークスペース全体は 開けない トークンや認証情報をリ ポジトリに入れない（ .gitignore・環境変数） 失敗ログの個人情報・顧 客データはマスクしてか らNotionへ Notionへ保存してよい情 報区分と、外部SaaS利用 の承認を確認 うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 23

Chapter 8 ｜ 法人運用の品質 運用チェックリストと失敗時の対応 平常時のチェック 失敗時の対応 ・登録件数がテスト件数と一致 ・Notion書き込み失敗でも結果JSONは保持 ・FAIL行に失敗ログが入っている ・リトライは回数上限を決める ・環境・コミットが正しい ・失敗は人に通知する ・誰が実行したか追える ・原因（認証・DB変更・形式変更）を切り分ける うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 24

確認テストと効果測定 学んだ確認と、導入効果の測り方 確認テスト（例） 効果測定の指標 Q1. 共通JSONを挟む理由は？ ・転記にかかる時間（導入前後） Q2. 再実行で行が増えない仕組みは？ ・転記ミスの件数 Q3. Notionに送ってはいけない情報の例は？ ・結果共有までの時間 ・障害調査で証跡を辿れた割合 うさうさ研修工房 ｜ Notion MCPテスト自動記録講座 25

まとめ テスト結果は、溜めて・探して・共有できる 資産に 次の一歩：自分のプロジェクトのテストで、1コマンド記録まで作ってみよう ｜ うさうさ研 修工房