---
title: 受講者用_NotionMCPテスト自動記録講座
tags:  #notion  
author: [Yukiko](https://image.docswell.com/user/yukiko_it)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/27V4L326EQ.jpg?width=480
description: 受講者用_NotionMCPテスト自動記録講座 by Yukiko
published: November 13, 26
canonical: https://image.docswell.com/s/yukiko_it/ZL3YGP-2026-11-13-054454
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/27V4L326EQ.jpg)

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


# Page. 2

![Page Image](https://bcdn.docswell.com/page/5JG1X3R27L.jpg)

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


# Page. 3

![Page Image](https://bcdn.docswell.com/page/47QD85V9EP.jpg)

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


# Page. 4

![Page Image](https://bcdn.docswell.com/page/KE4Z29WRJ1.jpg)

全体ロードマップ
スロープ設計：知識 → 橋渡し → 実践
前半｜知識編
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


# Page. 5

![Page Image](https://bcdn.docswell.com/page/L71RMKYV7G.jpg)

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


# Page. 6

![Page Image](https://bcdn.docswell.com/page/G7W13DG3J2.jpg)

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


# Page. 7

![Page Image](https://bcdn.docswell.com/page/4JZPVGLG73.jpg)

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


# Page. 8

![Page Image](https://bcdn.docswell.com/page/YE6M5YWQJV.jpg)

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


# Page. 9

![Page Image](https://bcdn.docswell.com/page/GE5ZYGM274.jpg)

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


# Page. 10

![Page Image](https://bcdn.docswell.com/page/972RGY91ER.jpg)

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


# Page. 11

![Page Image](https://bcdn.docswell.com/page/DJYDVG44JM.jpg)

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


# Page. 12

![Page Image](https://bcdn.docswell.com/page/V7N6MGY678.jpg)

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


# Page. 13

![Page Image](https://bcdn.docswell.com/page/YJ9LNWPRE3.jpg)

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


# Page. 14

![Page Image](https://bcdn.docswell.com/page/GJ8XKNDG7D.jpg)

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


# Page. 15

![Page Image](https://bcdn.docswell.com/page/LJL8ZPMXER.jpg)

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


# Page. 16

![Page Image](https://bcdn.docswell.com/page/47M6V4Y3JW.jpg)

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


# Page. 17

![Page Image](https://bcdn.docswell.com/page/P7RP2W9RJ9.jpg)

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


# Page. 18

![Page Image](https://bcdn.docswell.com/page/PJX3DPQY7X.jpg)

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


# Page. 19

![Page Image](https://bcdn.docswell.com/page/3JKYXD947D.jpg)

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


# Page. 20

![Page Image](https://bcdn.docswell.com/page/LE395RWDE5.jpg)

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


# Page. 21

![Page Image](https://bcdn.docswell.com/page/8EDGDYK2EG.jpg)

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


# Page. 22

![Page Image](https://bcdn.docswell.com/page/V7P3X6KLJ8.jpg)

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


# Page. 23

![Page Image](https://bcdn.docswell.com/page/2JV4L3V67Q.jpg)

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


# Page. 24

![Page Image](https://bcdn.docswell.com/page/5EG1X3L2JL.jpg)

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


# Page. 25

![Page Image](https://bcdn.docswell.com/page/4JQD85Y97P.jpg)

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


# Page. 26

![Page Image](https://bcdn.docswell.com/page/K74Z29ZRE1.jpg)

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