MCP 키로 md-log 연결하기

연결에는 아래 두 가지가 필요합니다. 둘 다 md-log 웹 앱에서 확인·발급할 수 있으며, 연결에 필요한 전부입니다.

연결 도구는 Node.js 22 이상에서 자동으로 내려받아 실행됩니다(npx). 이미 설치돼 있으면 건너뛰세요.

node -v    # v22.x 이상이면 OK

버전이 낮거나 명령을 못 찾으면 nodejs.org 에서 LTS 버전을 설치하세요(Windows·macOS 설치 파일 제공).

① Claude Code (터미널)

터미널에서 한 줄로 등록합니다(값 2개만 본인 것으로 교체).

claude mcp add md-log \
  --scope user \
  --env MDLOG_API_BASE_URL=https://app.md-log.com/api/v1 \
  --env MDLOG_PAT=mdlog_pat_여기에_본인_키 \
  -- npx -y md-log-mcp

등록 뒤 claude mcp list 로 확인하고, 채팅 중에는 /mcp 로 상태를 봅니다.

② Claude Desktop (데스크톱 앱)

설정 파일을 열어 mcpServers 항목을 추가하고 앱을 완전히 종료 후 재실행합니다.

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

{
  "mcpServers": {
    "md-log": {
      "command": "npx",
      "args": ["-y", "md-log-mcp"],
      "env": {
        "MDLOG_API_BASE_URL": "https://app.md-log.com/api/v1",
        "MDLOG_PAT": "mdlog_pat_여기에_본인_키"
      }
    }
  }
}

연결되면 입력창의 도구(🔌) 메뉴에 도구 목록이 나타납니다.

③ OpenAI Codex (터미널)

~/.codex/config.toml 파일에 아래 블록을 추가합니다(형식은 JSON 이 아니라 TOML).

# ~/.codex/config.toml
[mcp_servers.md-log]
command = "npx"
args = ["-y", "md-log-mcp"]
env = { MDLOG_API_BASE_URL = "https://app.md-log.com/api/v1", MDLOG_PAT = "mdlog_pat_여기에_본인_키" }

최신 버전은 codex mcp add md-log --env … -- npx -y md-log-mcp 명령도 지원합니다.

④ Cursor

Settings → MCP → Add new server, 또는 ~/.cursor/mcp.json 에 추가합니다.

{
  "mcpServers": {
    "md-log": {
      "command": "npx",
      "args": ["-y", "md-log-mcp"],
      "env": {
        "MDLOG_API_BASE_URL": "https://app.md-log.com/api/v1",
        "MDLOG_PAT": "mdlog_pat_여기에_본인_키"
      }
    }
  }
}

Settings → MCP 에서 초록색 점이 뜨면 연결 성공입니다.

⑤ 그 외 MCP 클라이언트

대부분 동일하게 실행 명령 + 환경변수 2개만 넣으면 됩니다.

command : npx
args    : -y  md-log-mcp
env     : MDLOG_API_BASE_URL = https://app.md-log.com/api/v1
          MDLOG_PAT          = mdlog_pat_여기에_본인_키

1. 클라이언트를 재시작합니다(설정 변경 반영).
2. 도구 목록에 md-log 가 연결됨(connected) 으로 보이는지 확인합니다. (Claude Code 는 /mcp)
3. AI 에게 자연어로 시켜 봅니다 — 아래 §5 예시.

연결되면 AI 에게 평소처럼 말로 시키면 됩니다. 예:

할 수 있는 일: 경로로 마크다운 저장/수정/이어쓰기, 읽기, 삭제, 이동·이름변경(히스토리·주석 보존), 버전 히스토리 조회·과거 버전 읽기, 폴더 만들기·이동·이름변경·삭제·목록, 전문 검색, 이미지 첨부. 폴더는 저장 시 자동으로 생성됩니다.

claude.md 로 자동 저장 (별도 지시 없이)

매번 “저장해줘”라고 말하지 않아도 됩니다. 프로젝트 루트의 claude.md(또는 CLAUDE.md)에 규칙을 한 번 적어두면, Claude Code 가 작업·분석을 마칠 때마다 자동으로 .md 리포트를 만들어 md-log 에 저장합니다. 폴더가 없으면 경로대로 자동 생성되고, 이미지도 함께 올라가며, 모든 저장은 불변 버전으로 쌓입니다.

예시 — claude.md 에 이런 규칙을 추가:

## 작업 기록 규칙 (md-log)
- 의미 있는 작업/분석을 마치면, "무엇을 · 왜 · 어떤 영향" 을 요약한 리포트를 작성한다.
- 그 리포트를 md-log MCP 의 save_markdown 으로 다음 경로에 저장한다:
    reports/<YYYY>/<YYYY-MM-DD>-<작업주제>.md
- 큰 변경에는 변경 이유 · 영향 범위 · 후속 항목(TODO)을 포함한다(리뷰·온보딩용).
- 사용자가 피드백을 주면 반영한 뒤 같은 경로 문서에 이어서 기록한다.

그러면 작업 흐름이 다음처럼 자동화됩니다:

• ① Claude Code 가 작업을 마치면 리포트(.md)를 작성 → ② md-log 에 경로로 저장(폴더 자동 생성) → ③ 웹 · 모바일 · 태블릿에서 바로 리뷰 · 주석 → ④ 피드백을 주면 같은 문서에 이어서 기록 · 동기화.

• 여러 사람과 공유되는 설정 파일에는 키를 직접 적지 말고, 가능하면 본인 PC의 환경변수로 관리하세요.
• 키가 노출되었다면 웹 앱 설정 → 토큰에서 직접 폐기(revoke)하고 새 키를 발급하세요.
• 안심 포인트 — 이 키는 문서 작업 전용입니다. 키만으로는 비밀번호 변경·다른 키 발급·로그인 세션 관리를 할 수 없습니다. 즉 키가 새더라도 계정 전체가 넘어가지는 않습니다.
• 서비스 주소는 항상 https:// 인지 확인하세요.

위로도 해결되지 않으면, 사용 중인 클라이언트 이름과 화면의 오류 메시지를 캡처해 md-log 고객 지원(support@md-log.com)에 문의하세요. (캡처에 키가 보이지 않도록 가려주세요.)

Q. 무언가 설치해야 하나요?

Node.js 만 있으면 됩니다. 연결 도구는 npx 가 처음 사용 시 자동으로 받아 실행하므로 별도 설치/빌드가 필요 없습니다.

Q. 키 하나를 여러 기기에서 써도 되나요?

네. 같은 키와 주소를 각 기기의 클라이언트 설정에 넣으면 됩니다. 다만 키는 비밀로 관리하세요.

Q. 키를 바꾸거나 폐기하려면?

웹 앱 설정 → 토큰에서 기존 키를 폐기하고 새 키를 직접 발급할 수 있습니다. 새 키를 받으면 설정의 MDLOG_PAT 값만 교체하고 클라이언트를 재시작하면 됩니다.

Q. 인터넷 없이도 되나요?

아니요. 문서는 서비스 서버에 저장되므로, MDLOG_API_BASE_URL 서버에 접속할 수 있는 네트워크가 필요합니다.