Claude Desktop 연동 가이드

AI Simple Note를 Claude Desktop과 연결하여 스마트한 개인 비서로 활용하는 방법

Claude Desktop과 AI Simple Note 연동하기

Claude를 당신만의 개인 비서로 만들어보세요. 할일, 일정, 메모를 자연어로 관리하고, AI가 당신의 맥락을 이해하여 스마트한 제안을 제공합니다.

📋 사전 준비물

  • Node.js: v18 이상 (다운로드)
  • Claude Desktop: 최신 버전 (다운로드)
  • AI Simple Note API 키: 앱의 설정 > MCP 메뉴에서 발급

🚀 설정 방법 (3단계)

1단계: MCP 설정 파일 열기

Claude Desktop의 MCP 설정 파일을 엽니다:

macOS:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

notepad %APPDATA%\Claude\claude_desktop_config.json

Linux:

code ~/.config/Claude/claude_desktop_config.json

파일이 없다면 새로 만들어주세요.


2단계: AI Simple Note MCP 서버 추가

설정 파일에 다음 내용을 추가합니다:

{
  "mcpServers": {
    "ainote": {
      "command": "npx",
      "args": ["-y", "@ainote/mcp-server"],
      "env": {
        "AINOTE_API_KEY": "여기에_복사한_API키_붙여넣기"
      }
    }
  }
}

💡 팁: AINOTE_API_KEY 값을 AI Simple Note 앱에서 복사한 실제 API 키로 교체하세요.


3단계: Claude Desktop 재시작

  1. Claude Desktop 앱을 완전히 종료합니다
  2. 앱을 다시 실행합니다
  3. 새 대화를 시작하여 연동을 확인합니다

테스트 명령:

내 할일 목록 보여줘

Claude가 AI Simple Note의 할일을 읽어온다면 연동 성공입니다! 🎉


💬 활용 예시

할일 관리

할일 추가:

내일 오전 9시까지 '프로젝트 기획서 제출' 할일 추가해줘

할일 조회:

이번 주에 끝내야 하는 '업무' 카테고리 할일 목록 보여줘

우선순위 변경:

'프로젝트 기획서 제출' 할일의 우선순위를 '높음'으로 변경해줘

스마트한 질문

일정 파악:

나 오늘 오후에 뭐하기로 했지?

우선순위 분석:

가장 급한 일이 뭐야?

진행 상황 정리:

이번 주 완료한 작업들로 주간 보고서 초안 작성해줘

맥락 기반 제안

날씨와 일정 연계:

주말 날씨 어때?

→ Claude가 주말 일정을 확인하고 날씨와 연관지어 답변합니다.

시간 배분 계획:

이번 주 내 일정을 보고 시간 배분 계획 짜줘

🛠 고급 설정

여러 작업 공간 사용

여러 AI Simple Note 계정을 사용한다면 설정을 분리할 수 있습니다:

{
  "mcpServers": {
    "ainote-work": {
      "command": "npx",
      "args": ["-y", "@ainote/mcp-server"],
      "env": {
        "AINOTE_API_KEY": "업무용_API_키"
      }
    },
    "ainote-personal": {
      "command": "npx",
      "args": ["-y", "@ainote/mcp-server"],
      "env": {
        "AINOTE_API_KEY": "개인용_API_키"
      }
    }
  }
}

로그 활성화 (디버깅용)

문제 해결이 필요한 경우 로그를 활성화하세요:

{
  "mcpServers": {
    "ainote": {
      "command": "npx",
      "args": ["-y", "@ainote/mcp-server"],
      "env": {
        "AINOTE_API_KEY": "여기에_API키",
        "AINOTE_LOG_LEVEL": "debug"
      }
    }
  }
}

🔧 문제 해결

문제 1: Claude가 할일을 읽지 못함

증상: “할일 목록을 찾을 수 없습니다” 오류

해결책:

  1. API 키가 올바르게 입력되었는지 확인
  2. AI Simple Note 앱에서 MCP가 활성화되어 있는지 확인
  3. Claude Desktop을 완전히 재시작

문제 2: MCP 서버가 시작되지 않음

증상: Claude가 MCP 서버를 찾지 못함

해결책:

  1. Node.js 버전 확인: node --version (v18 이상 필요)
  2. NPX 캐시 클리어: npx clear-npx-cache
  3. 수동으로 설치: npm install -g @ainote/mcp-server

문제 3: JSON 문법 오류

증상: Claude Desktop이 시작되지 않음

해결책:

  1. JSONLint에서 설정 파일 문법 검사
  2. 쉼표(,)와 따옴표(")가 올바른지 확인
  3. 백업 파일로 복구

📚 Best Practices

명확하고 구체적으로 지시하기

나쁜 예: “할일 추가해줘” ✅ 좋은 예: “오늘 저녁 7시까지 ‘장보기’ 할일 추가하고, ‘개인’ 카테고리에 넣어줘”

카테고리 적극 활용

AI Simple Note에서 ‘업무’, ‘개인’, ‘공부’ 등 카테고리를 미리 만들어두면 필터링이 편리합니다.

자연스러운 대화처럼 질문

단순 명령을 넘어 스케줄에 대해 질문해보세요. Claude가 맥락을 이해하고 답변합니다.


🔐 보안 안내

  • API 키 보호: 설정 파일의 권한을 확인하세요
  • 공개 저장소 주의: Git에 API 키를 커밋하지 마세요
  • 정기적 갱신: 3개월마다 API 키를 재발급하세요
  • 즉시 철회: 의심스러운 활동 발견 시 앱에서 즉시 비활성화

💡 다음 단계


도움이 필요하신가요?


업데이트 일자: 2025년 1월 26일 작성자: AI Simple Note Team

Contact: fonts_midways0d@icloud.com