# 🛠️ 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)를 즉시 검색

---

## 🚀 빠른 시작 (Quick Start)

### 1. 사전 요구사항
* **Node.js**: v18 이상 권장
* **Notion Integration Token**: [Notion Developers](https://www.notion.so/profile/integrations)에서 발급

### 2. 설치 및 빌드
```bash
# 의존성 설치
npm install

# 환경 변수 설정
cp .env.example .env
# .env 파일을 열어 NOTION_API_KEY 및 3개 DB_ID 입력

# TypeScript 빌드
npm run build

# 노션 데이터베이스 연동 확인
npm run inspect
```

### 3. Antigravity / Gemini CLI 실행 (온디맨드)
```bash
npm run se-agent
```

---

## ⚙️ MCP 등록 설정 (JSON)

Antigravity, Claude Desktop, 또는 지원되는 AI 에이전트에 등록하여 사용할 수 있습니다:

```json
{
  "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..."
      }
    }
  }
}
```

---

## 📚 관련 문서
* [초기 환경 구축 및 세부 가이드 (SETUP_GUIDE.md)](./SETUP_GUIDE.md)
* [향후 개선 제안 및 기능 로드맵 (IMPROVEMENTS.md)](./IMPROVEMENTS.md)