Notion Skills MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

4가지 워크플로우: 지식 수집, 인텔 회의, 연구 문서, 사양→구현
자동 활성화 - Claude가 작업에 적합한 기술을 선택합니다.
Notion 데이터베이스에 구조화된 출력(결정, 조치 항목, 타임라인)을 기록합니다.
네 가지 모두에 단일 Notion 통합을 사용합니다.
복제 가능한 마켓플레이스 — ~/.claude/plugins/에 접속하세요.

라이브 데모

실제 사용 모습

notion-skills.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "notion-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tommy-ca/notion-skills.git",
        "~/.claude/plugins/notion-skills"
      ],
      "_inferred": false
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "notion-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tommy-ca/notion-skills.git",
        "~/.claude/plugins/notion-skills"
      ],
      "_inferred": false
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "notion-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tommy-ca/notion-skills.git",
        "~/.claude/plugins/notion-skills"
      ],
      "_inferred": false
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "notion-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tommy-ca/notion-skills.git",
        "~/.claude/plugins/notion-skills"
      ],
      "_inferred": false
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "notion-skills",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tommy-ca/notion-skills.git",
        "~/.claude/plugins/notion-skills"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "notion-skills": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/tommy-ca/notion-skills.git",
          "~/.claude/plugins/notion-skills"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add notion-skills -- git clone https://github.com/tommy-ca/notion-skills.git ~/.claude/plugins/notion-skills

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Notion Skills

회의의 결정 사항과 실행 항목을 Notion에 캡처

👤 회의를 많이 하는 사람 ⏱ ~10 min beginner

언제 쓸까: 회의는 막 끝났고 결정은 여전히 생생합니다.

사전 조건

Notion 통합 + 공유 데이터베이스 — https://www.notion.so/my-integrations → 생성 → 대상 DB를 공유합니다.
~/.claude/plugins/notion-skills에 복제된 스킬 — README당 git clone

흐름

회의 붙여넣기/설명

오늘의 아키텍처 검토를 캡처하세요. 우리는 Postgres용 DynamoDB를 삭제하고 재시도를 청구로 옮기기로 결정했습니다.✓ 복사됨

→ 지식 포착이 활성화됩니다. 의사결정 + 조치 항목이 포함된 구조화된 출력
노션에 저장

적절한 태그를 사용하여 '결정' 데이터베이스에 저장합니다.✓ 복사됨

→ 속성(날짜, 소유자, 지역)으로 생성된 페이지

결과: 결정은 채팅 스크롤백에 묻히지 않고 검색 가능하며 연결된 Notion에 있습니다.

함정

통합에 DB가 표시되지 않습니다. — Notion의 공유 대화 상자에서 명시적으로 통합과 데이터베이스를 공유합니다.

함께 쓰기: memory-bank-mcp

상황과 위험 목록을 바탕으로 회의 준비

👤 PM, TL, 창립자 ⏱ ~15 min beginner

언제 쓸까: 들어가고 싶은 회의에 앞서 이미 정보를 얻었습니다.

흐름

회의 상황 제공

회의: 내일 오후 2시 CTO와의 '결제 마이그레이션 검토' 관련 Notion 페이지를 가져와 위험에 플래그를 지정하세요.✓ 복사됨

→ 회의 인텔리전스가 활성화됩니다. 표면 관련 페이지
의제 + 위험 가져오기

6개 항목의 안건과 상위 3개 위험 목록을 작성합니다.✓ 복사됨

→ 의제 항목은 주제가 아니라 질문입니다. 구체적인 증거와 관련된 위험

결과: 실제로 회의를 진행하는 데 사용할 수 있는 사전 브리핑입니다.

소스와 함께 연구 프로젝트를 문서화하세요.

👤 연구원, 분석가, RFC 작성자 ⏱ ~45 min intermediate

언제 쓸까: 당신은 정보를 수집해 왔으며 인용이 포함된 구조화된 글을 원합니다.

흐름

연구 스킬을 시작하세요

연구 문서: 청구 워크로드에 대해 Postgres와 DynamoDB를 평가합니다. 인용을 포함합니다.✓ 복사됨

→ 연구 문서가 활성화됩니다. 구조화된 섹션; 인용 인라인
저장 + 링크

'연구' DB에 새 페이지로 저장합니다. 상위 이니셔티브에 다시 연결합니다.✓ 복사됨

→ 관계 세트로 생성된 페이지

결과: 다른 사람들이 읽고 신뢰할 수 있는 연구 자료입니다.

함정

환각적인 인용 — 클릭할 수 있는 URL을 포함하도록 스킬에 요청하세요. 저장하기 전에 샘플을 확인하세요

함께 쓰기: paper-fetch-skill · sec-edgar-mcp

작업을 통해 사양을 구현 계획으로 전환

👤 기능을 시작하는 엔지니어 ⏱ ~30 min intermediate

언제 쓸까: 사양 문서가 있고 견적이 포함된 작업 분석이 필요합니다.

흐름

사양을 피드

이 사양에 대한 사양-구현을 사용하세요. 작업 + 견적 + 타임라인을 생성합니다.✓ 복사됨

→ 크기와 종속성이 포함된 작업 트리
개념으로 거울을 비추다

이니셔티브 링크 및 소유자를 사용하여 '구현' DB에 작업을 생성합니다.✓ 복사됨

→ 상위-하위 링크로 생성된 행

결과: 합리적인 구조를 갖춘 즉시 커밋 가능한 계획입니다.

함께 쓰기: plane-mcp-server · linear

조합

다른 MCP와 조합해 10배 효율

notion-skills + notion

기본 Notion MCP는 API 호출을 처리합니다. 기술이 결과를 결정한다

스킬이 콘텐츠를 계획하게 하세요. Notion MCP가 데이터베이스 쓰기를 실행하도록 합니다.✓ 복사됨

notion-skills + plane-mcp-server

Notion에 구현 계획을 작성하고 Plane 작업 항목을 생성합니다.

사양 구현 후 추적을 위해 작업을 평면에 미러링합니다.✓ 복사됨

notion-skills + memory-bank-mcp

프로젝트별 내구성 메모리에 대한 결정 촉진

개념으로 캡처; 결정 요약을 memory-bank/<project>/decisions.md에 복사하세요.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
knowledge-capture (SKILL)	meeting transcript or notes	회의 직후
meeting-intelligence (SKILL)	meeting context + attendees	회의 전
research-documentation (SKILL)	topic + constraints	연구 결과 문서화
spec-to-implementation (SKILL)	spec doc	엔지니어링 구현 시작

비용 및 제한

운영 비용

API 쿼터: Notion API 제한에 얽매임
호출당 토큰: 보통 — 구조화된 출력이 간결합니다.
금액: 무료
팁: 실제로 필요한 데이터베이스만 통합과 공유하세요. 스캔할 페이지 수가 적음 = 더 빠릅니다.

보안

권한, 시크릿, 파급범위

자격 증명 저장: env/secret 관리자의 Notion 통합 토큰. 그것을 저지르지 마십시오.

데이터 외부 송신: 통합을 통해서만 공유하는 데이터베이스에 대한 쓰기는 api.notion.com으로 이동합니다.

데이터베이스를 읽고 쓸 수 있는 Notion 통합은 모든 페이지를 볼 수 있습니다. 최소한의 데이터베이스 수로 통합 범위를 지정하세요.
자동 활성화는 편리하지만 명시적인 호출 없이 기술이 실행될 수 있음을 의미합니다. SKILL.md에서 트리거 설명을 검토하세요.

문제 해결

자주 발생하는 오류와 해결

통합에는 데이터베이스에 대한 액세스 권한이 없습니다.

Notion 열기 → 데이터베이스 → 공유 → 통합을 추가하세요.

확인: In Notion's share dialog, integration is listed

페이지가 생성되었지만 속성이 누락되었습니다.

데이터베이스 스키마에는 기술이 작성하는 속성이 있어야 합니다. 일치하도록 추가하거나 이름을 바꿉니다.

확인: Compare skill's property list with database columns

관련 없는 요청에 대한 자동 활성화 실행

트리거 범위를 좁히려면 SKILL.md 설명을 강화하세요.

확인: head ~/.claude/plugins/notion-skills/*/SKILL.md

대안

Notion Skills 다른 것과 비교

대안	언제 쓰나	단점/장점
notion (MCP)	독단적인 워크플로우 세트가 아닌 원시 Notion API 액세스를 원합니다.	더 유연하고 덜 독선적임
obsidian-mcp-server	귀하의 메모는 Obsidian에 있습니다.	다른 도구
claude-content-writer-skill	Notion 구조보다 목소리/스타일에 더 관심이 있으신 분	다른 초점

Notion Skills