📝 Claude Code + Notion MCP: Knowledge base tự cập nhật từ git diff, dev nhàn hẳn

25 tháng 4, 2026

Hook: Dev nào cũng ghét viết doc, team vẫn cần knowledge base

Bạn đã bao giờ mở Notion lên và thấy PRD viết dở từ 3 tháng trước, decision log trống trơn, daily standup notes biến mất sau sprint thứ 2 chưa? Bệnh chung của team dev. Code chạy ngon, nhưng knowledge base bị bỏ rơi vì không ai muốn dừng lại để gõ.

Hôm nay mình share combo: Claude Code kết hợp Notion MCP server. Setup 5 phút, sau đó mọi git commit, PR description, inline doc đều tự động chảy vào Notion mà dev không phải copy paste tay. Team mình 5 người tiết kiệm 4 giờ mỗi tuần.

Setup 5 phút: Notion MCP server

Bước 1, cài Notion MCP server qua npm hoặc Docker, recommend npm cho nhanh.

Bước 2, vào Notion settings, mở Connections, tạo Internal Integration mới, copy integration token dạng secret_xxx ra.

Bước 3, mở file mcp.json tại ~/.claude/mcp.json và add config:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "secret_xxx"
      }
    }
  }
}

Bước 4, restart Claude Code, gõ /mcp để check, thấy notion connected là xong.

Bước 5, vào từng Notion database (Daily Standup, Decision Log, Engineering Wiki...), bấm Share, mời integration vào với quyền Edit. Không share thì Claude không thấy database đâu.

4 use case productivity ngay lập tức

1. Daily standup auto từ git log

Cuối ngày gõ: "Tóm tắt commit hôm nay rồi push vào Notion DB Daily Standup". Claude tự chạy git log --since=yesterday, parse commit, generate bullet "Đã làm, đang làm, blocker", gọi notion-create-page tạo entry. Daily standup auto thay được khá thời gian họp.

2. PRD writer từ user feedback

Paste vào Claude một đống user feedback từ Slack hay Linear, bảo "viết PRD v0.1 cho feature X, push vào Notion product roadmap". Claude generate đầy đủ sections: problem statement, user story, requirement, success metric, edge case, rồi tạo page con trong Notion.

3. Decision log sau khi merge PR

Sau khi merge một PR architecture quan trọng, gõ "Ghi quyết định này vào Notion Decision Log". Claude pull PR description qua GitHub MCP, format theo template ADR với context, decision, consequences, rồi push lên. 6 tháng sau new dev join team vẫn hiểu vì sao chọn kiến trúc đó.

4. Code-doc sync cho Engineering Wiki

Hay nhất với codebase lớn. Bảo Claude "scan inline doc trong folder src/services, push lên Notion Engineering Wiki, mỗi service một page". Claude đọc JSDoc, docstring, comment, generate documentation đẹp đẽ rồi sync. Code thay đổi, chạy lại lệnh là Notion update theo.

Lợi ích đo được sau 1 tháng

Team mình 5 dev, dùng combo này 1 tháng, đo được:

Tiết kiệm 4 giờ mỗi tuần cho daily standup, wiki, decision log.
Số PRD viết tăng 3 lần vì dev không phải mở Notion gõ tay.
Onboarding dev mới giảm từ 5 ngày xuống 2 ngày vì doc luôn fresh.
Không còn cảnh "ơ sao quyết định này lại như vậy nhỉ" sau 3 tháng.

Trick xịn: kết hợp Notion MCP với GitHub MCP và Linear MCP, Claude tự chuyển issue thành PRD, link sang PR, thành dòng chảy thông tin liền mạch.

CTA

Lười viết doc nhưng sếp vẫn đòi knowledge base? Cài combo này ngay tối nay. Bookmark vibeaicoder.xyz để xem thêm tutorial MCP hay ho. Tuần sau mình ra bài kết hợp Claude Code với Linear MCP và Slack MCP, thành dev assistant full stack luôn.

#VibeAICoder #ClaudeCode #NotionMCP #MCPServer #DevProductivity