Skip to main content
Glama

๐Ÿ› ๏ธ Solution Engineer Notion MCP Assistant

์†”๋ฃจ์…˜ ์—”์ง€๋‹ˆ์–ด(SE)์˜ ์—…๋ฌด ๊ธฐ๋ก, ์œ ์ง€๋ณด์ˆ˜ ์‚ฌ์ดํŠธ ๊ด€๋ฆฌ, ์ •๊ธฐ์ ๊ฒ€ ์ผ์ • ๋ฐ ํŠธ๋Ÿฌ๋ธ”์ŠˆํŒ… ๋‚ด์—ญ์„ ์ž์—ฐ์–ด ๋Œ€ํ™”๋กœ ๋…ธ์…˜(Notion)์— ์ž๋™ ์ ์žฌ ๋ฐ ์กฐํšŒํ•  ์ˆ˜ ์žˆ๋„๋ก ์ง€์›ํ•˜๋Š” MCP(Model Context Protocol) ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค.


๐Ÿ“Œ ์ฃผ์š” ๊ธฐ๋Šฅ

  • ๐Ÿข ์œ ์ง€๋ณด์ˆ˜ ์‚ฌ์ดํŠธ ๊ด€๋ฆฌ (add_maintenance_site)

    • ๊ณ ๊ฐ์‚ฌ/์‚ฌ์ดํŠธ ์ •๋ณด, ๋‹ด๋‹น์ž ์—ฐ๋ฝ์ฒ˜, ์ ๊ฒ€ ์ฃผ๊ธฐ, ๋ฐฉ๋ฌธ ์œ„์น˜, ์‹œ์Šคํ…œ ํ™˜๊ฒฝ์„ ๋…ธ์…˜ DB์— ๋“ฑ๋ก ๋ฐ ์Šค๋งˆํŠธ ๊ฐฑ์‹ (Upsert)

  • ๐Ÿ“‹ ์—…๋ฌด ์ผ์ง€ ๋“ฑ๋ก (add_work_log)

    • ์˜จ์‚ฌ์ดํŠธ/์›๊ฒฉ ์ •๊ธฐ์ ๊ฒ€ ์ˆ˜ํ–‰ ์ผ์ง€, ์ฃผ์š” ์ž‘์—… ํ•ญ๋ชฉ ๋ฐ ๊ณ ๊ฐ์‚ฌ ์š”์ฒญ์‚ฌํ•ญ ์ž๋™ ํ…œํ”Œ๋ฆฟํ™”

  • ๐Ÿšจ ํŠธ๋Ÿฌ๋ธ”์ŠˆํŒ… ์‚ฌ๋ก€ ์ ์žฌ (add_troubleshooting)

    • ์žฅ์•  ํ˜„์ƒ, ์—๋Ÿฌ ๋กœ๊ทธ, ์›์ธ ๋ถ„์„, ์กฐ์น˜ ๋‚ด์šฉ, ์žฌ๋ฐœ ๋ฐฉ์ง€์ฑ…์„ ๊ตฌ์กฐํ™”ํ•˜์—ฌ ์ ์žฌ

  • ๐Ÿ” ์ด๋ ฅ ๋ฐ ์‚ฌ๋ก€ ๊ฒ€์ƒ‰ (list_maintenance_sites, list_work_logs, search_troubleshooting)

    • ๊ณผ๊ฑฐ ์ ๊ฒ€ ์ด๋ ฅ์ด๋‚˜ ์—๋Ÿฌ ํ‚ค์›Œ๋“œ(์˜ˆ: SSL, Token, DB Timeout)๋ฅผ ์ฆ‰์‹œ ๊ฒ€์ƒ‰


Related MCP server: AI-Notion Integration MCP Server

๐Ÿš€ ๋น ๋ฅธ ์‹œ์ž‘ (Quick Start)

1. ์‚ฌ์ „ ์š”๊ตฌ์‚ฌํ•ญ

  • Node.js: v18 ์ด์ƒ ๊ถŒ์žฅ

  • Notion Integration Token: Notion Developers์—์„œ ๋ฐœ๊ธ‰

2. ์„ค์น˜ ๋ฐ ๋นŒ๋“œ

# ์˜์กด์„ฑ ์„ค์น˜
npm install

# ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์„ค์ •
cp .env.example .env
# .env ํŒŒ์ผ์„ ์—ด์–ด NOTION_API_KEY ๋ฐ 3๊ฐœ DB_ID ์ž…๋ ฅ

# TypeScript ๋นŒ๋“œ
npm run build

# ๋…ธ์…˜ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ์—ฐ๋™ ํ™•์ธ
npm run inspect

3. Antigravity / Gemini CLI ์‹คํ–‰ (์˜จ๋””๋งจ๋“œ)

npm run se-agent

โš™๏ธ MCP ๋“ฑ๋ก ์„ค์ • (JSON)

Antigravity, Claude Desktop, ๋˜๋Š” ์ง€์›๋˜๋Š” AI ์—์ด์ „ํŠธ์— ๋“ฑ๋กํ•˜์—ฌ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:

{
  "mcpServers": {
    "se-notion": {
      "command": "node",
      "args": ["<ํ”„๋กœ์ ํŠธ๊ฒฝ๋กœ>/dist/index.js"],
      "env": {
        "NOTION_API_KEY": "ntn_...",
        "MAINTENANCE_DB_ID": "3cd...",
        "WORKLOG_DB_ID": "3d9...",
        "TROUBLESHOOTING_DB_ID": "3d9..."
      }
    }
  }
}

๐Ÿ“š ๊ด€๋ จ ๋ฌธ์„œ

Available Tools

6 tools
add_maintenance_siteB

์œ ์ง€๋ณด์ˆ˜ ์‚ฌ์ดํŠธ(๊ณ ๊ฐ์‚ฌ) ์ •๋ณด๋ฅผ ๋“ฑ๋กํ•˜๊ฑฐ๋‚˜ ๊ธฐ์กด ์‚ฌ์ดํŠธ ์ •๋ณด๋ฅผ ๊ฐฑ์‹ ํ•ฉ๋‹ˆ๋‹ค. ๊ธฐ์กด ๋™์ผ ์‚ฌ์ดํŠธ๊ฐ€ ์žˆ์„ ๊ฒฝ์šฐ ๋ฎ์–ด์“ฐ์ง€ ์•Š๊ณ  ๊ธฐ์กด ํŽ˜์ด์ง€๋ฅผ ์Šค๋งˆํŠธ ์—…๋ฐ์ดํŠธํ•ฉ๋‹ˆ๋‹ค.

Inputs: site_name (required), notes, location, system_info, +6 more.

add_troubleshootingC

์—๋Ÿฌ ๋ฐ ํŠธ๋Ÿฌ๋ธ”์ŠˆํŒ… ์กฐ์น˜ ๋‚ด์—ญ์„ ๋…ธ์…˜์— ์ ์žฌํ•ฉ๋‹ˆ๋‹ค.

Inputs: title (required), symptom (required), resolution (required), error_log, +3 more.

add_work_logB

์—…๋ฌด ์ผ์ง€ ๋ฐ ์ •๊ธฐ์ ๊ฒ€ ์ˆ˜ํ–‰ ๊ธฐ๋ก์„ ๋…ธ์…˜ ์—…๋ฌด์ผ์ง€ DB์— ๋“ฑ๋กํ•ฉ๋‹ˆ๋‹ค.

Inputs: title (required), summary, site_name, work_date, +3 more.

list_maintenance_sitesB

๋“ฑ๋ก๋œ ์œ ์ง€๋ณด์ˆ˜ ์‚ฌ์ดํŠธ ๋ชฉ๋ก์„ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.

Inputs: site_name.

list_work_logsC

์—…๋ฌด ์ผ์ง€ ๋ชฉ๋ก์„ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.

Inputs: query.

search_troubleshootingC

ํŠธ๋Ÿฌ๋ธ”์ŠˆํŒ… ํ•ด๊ฒฐ ์‚ฌ๋ก€๋ฅผ ๊ฒ€์ƒ‰ํ•ฉ๋‹ˆ๋‹ค.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    TDQS

    B3.3/5.0

    Scored across 6 tools

    Disambiguation4/5

    Each tool targets a distinct resource (maintenance sites, work logs, troubleshooting) with a clear action (add/list/search), so selection is generally unambiguous. Minor overlap exists between add_work_log and add_troubleshooting since a troubleshooting record could be seen as a work log, but the descriptions differentiate them adequately.

    Naming Consistency5/5

    All six tools follow a clean verb_noun pattern (add_, list_, search_ + resource), with no mixed conventions or vague verbs. The pattern is entirely predictable and readable.

    Tool Count4/5

    Six tools is well-scoped for a Notion-based maintenance tracking server covering three resource types. The set is slightly thin in that each resource gets only one or two operations, but every tool earns its place.

    Completeness3/5

    The surface covers create/list for sites and work logs and add/search for troubleshooting, plus site upsert. However, update and delete operations are absent for work logs and troubleshooting, and there is no single-item retrieval, leaving notable lifecycle gaps.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers