DevLog MCP

Codex, Claude Code 같은 AI 코딩 에이전트가 작성한 개발 일지를 기존 Notion Blog DB에 발행하는 stdio MCP 서버다. 에이전트가 회고와 본문 작성을 담당하고, 이 서버는 입력 검증과 Notion 저장만 담당한다.

요구 사항

• Node.js 20 이상
• 기존 Notion Blog Database
• Database에 연결된 Notion Integration

설치와 빌드

npm install
npm test
npm run build

개발 중 직접 실행할 때는 환경 변수를 현재 셸에 설정한다. 이 프로젝트는 .env 파일을 자동으로 읽지 않는다.

export NOTION_TOKEN="secret_..."
export NOTION_DATABASE_ID="..."
npm run dev

stdio 서버는 MCP 클라이언트와 JSON-RPC로 통신하므로 터미널에서 실행했을 때 일반적인 안내 문구가 출력되지 않는다.

Notion 설정

1. Notion의 Integrations 화면에서 Internal Integration을 만든다.
2. Integration token을 NOTION_TOKEN으로 사용한다.
3. 기존 Blog Database의 연결 메뉴에서 해당 Integration을 추가한다.
4. Database URL에서 Database ID를 찾아 NOTION_DATABASE_ID로 사용한다.

Database 속성 이름과 타입은 다음과 같아야 한다.

속성	Notion 타입	기본값
Title	Title	필수 입력
Category	Select	개발
Tags	Multi-select	빈 목록
PublishedAt	Date	현재 날짜
Status	Status	published

기존 Database의 Select, Multi-select, Status 옵션에 전달한 이름이 없으면 Notion 권한과 설정에 따라 옵션 생성이 제한될 수 있다.

MCP 도구

서버는 publish_dev_log 도구 하나를 제공한다.

type PublishDevLogInput = {
  title: string;
  category?: string;
  tags?: string[];
  publishedAt?: string;
  status?: "published" | "draft";
  content: string;
};

본문에서 지원하는 Markdown은 제목 1~3, 문단, 순서/비순서 목록, fenced code block, 구분선이다.

호출 입력 예시는 다음과 같다.

{
  "title": "DevLog MCP 첫 구현",
  "tags": ["MCP", "Notion", "TypeScript"],
  "content": "# 오늘의 작업\nNotion 발행 도구를 구현했다.\n\n## 결정\n- MCP는 저장만 담당한다.\n- 회고 작성은 코딩 에이전트가 담당한다."
}

Codex 연결

먼저 절대 경로 기준으로 빌드 결과를 등록한다.

codex mcp add devlog-mcp \
  --env NOTION_TOKEN=secret_... \
  --env NOTION_DATABASE_ID=... \
  -- node /Users/oddd/workspace/notion/devlog-mcp/dist/index.js

등록 상태는 다음 명령으로 확인한다.

codex mcp list

Claude Code 연결

프로젝트 범위 MCP 서버로 등록한다.

claude mcp add -s project devlog-mcp \
  -e NOTION_TOKEN=secret_... \
  -e NOTION_DATABASE_ID=... \
  -- node /Users/oddd/workspace/notion/devlog-mcp/dist/index.js

등록 상태는 다음 명령으로 확인한다.

claude mcp list

연결 후 에이전트에게 오늘 개발한 내용을 일지로 정리하고 publish_dev_log로 발행해줘라고 요청할 수 있다.

devlog-mcp