Journal Mandala MCP

Name: Journal Mandala MCP
Author: takezone

Journal Mandala에 Claude로부터 직접 일기 항목을 작성하기 위한 MCP 서버입니다.

대화 도중 '생각의 흐름'을 만다라에 기록하고 싶을 때 사용합니다.

필요한 것

Node.js 20+
Claude Desktop (또는 Claude Code)
Journal Mandala의 API 키 (발급 방법은 'API 키 발급' 참조)

설치

npm을 사용하여 전역으로 설치합니다.

npm install -g github:takezone/journal-mandala-mcp

업데이트할 때는 동일한 명령어를 다시 실행합니다.

Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json (macOS)을 편집합니다:

1계정 운영

{
  "mcpServers": {
    "journal-mandala": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_XXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

2계정(personal / work)을 전환하고 싶은 경우

{
  "mcpServers": {
    "journal-mandala-personal": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_PERSONAL_KEY"
      }
    },
    "journal-mandala-work": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_WORK_KEY"
      }
    }
  }
}

각각 별도의 도구로 Claude에서 인식됩니다. "work에 기록해줘"와 같이 자연어로 전환 가능합니다.

설정 후 Claude Desktop을 재시작하세요.

API 키 발급

현재는 Journal Mandala 관리자(@takezone)에게 다음 내용을 전달하여 발급받아야 합니다:

본인의 Google 계정 이메일 주소
라벨 이름 (예: alice-personal)

관리자로부터 API 키를 받으면 위 설정의 JOURNAL_MANDALA_API_KEY에 복사하여 붙여넣습니다.

참고: 향후 브라우저에서 자동 발급할 수 있도록 할 예정입니다.

사용 방법

Claude와의 대화에서 "오늘 있었던 일을 일기에 기록해줘"와 같이 요청하면 add_journal_entry 도구가 호출되어 Journal Mandala에 항목이 추가됩니다.

기록 가능한 항목:

title 제목 (생략 가능)
event 사건 (무슨 일이 있었는지)
thought 생각 (어떻게 느꼈는지)
entry_date 날짜 YYYY-MM-DD (생략 시 JST 기준 오늘)
entry_time 시간 HH:MM
tags 태그 배열
star_rating 1-5점 평가

title / event / thought 중 하나는 필수입니다.

옵션 환경 변수

JOURNAL_MANDALA_API_URL — API 엔드포인트 (기본값: https://journal-mandala.vercel.app)

문제 해결

Claude에 도구가 표시되지 않음 → 설정 파일의 JSON 구문 오류 가능성. Claude Desktop의 Developer 메뉴에서 MCP 로그 확인
API 오류 401 → JOURNAL_MANDALA_API_KEY가 유효하지 않음. 관리자에게 재발급 요청
네트워크 오류 → Vercel 가동 상태 확인