md-log

MCP 키로 md-log 연결하기

md-log에서 발급받은 MCP 키 하나로 사용하시는 AI 클라이언트(Claude Code · Claude Desktop · Codex · Cursor)에서 곧바로 문서를 저장·검색하세요. URL 하나로 연결되며 설치가 필요 없습니다.

URL로 연결 설치 불필요 키 + 주소만 입력

1 연결에 필요한 정보

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

MCP 키mdlog_pat_ 로 시작하는 긴 문자열 — 예: mdlog_pat_3f9a… (비밀번호처럼 취급)
연결 주소 (URL)https://mcp.md-log.com/mcp (원격 URL 연결 — 권장)
서비스 주소 (로컬 방식만)https://app.md-log.com/api/v1 (로컬 npx 방식의 MDLOG_API_BASE_URL)
키가 없다면 웹 앱 설정 → 토큰에서 직접 발급하세요. 서비스 주소는 위 값(https://app.md-log.com/api/v1)으로 고정입니다. 키는 발급 시 한 번만 표시되니 안전한 곳에 보관해 두세요.

2 사용하는 클라이언트에 연결

연결 방법은 두 가지입니다 — 아래 탭에서 하나만 고르세요. 어느 쪽이든 MDLOG_PAT(MCP 키)만 발급받은 본인 값으로 바꾸면 됩니다.

설치 없이 URL 하나로 연결합니다. Node.js도 npx도 필요 없습니다. 클라이언트에 주소 + 키(Bearer 헤더)만 넣으세요.

Claude Code (터미널)

bash
claude mcp add --transport http md-log https://mcp.md-log.com/mcp \
  --header "Authorization: Bearer mdlog_pat_여기에_본인_키"

Cursor · Claude Desktop · 그 외 (JSON)

~/.cursor/mcp.json · claude_desktop_config.json · 프로젝트 .mcp.json 등에 넣습니다.

json
{
  "mcpServers": {
    "md-log": {
      "type": "http",
      "url": "https://mcp.md-log.com/mcp",
      "headers": { "Authorization": "Bearer mdlog_pat_여기에_본인_키" }
    }
  }
}

type 은 반드시 http 여야 합니다(생략하면 stdio로 오인). 원격 방식에서는 이미지를 인라인(base64)으로 넣으세요 — 로컬 파일 경로 업로드는 로컬(npx) 방식에서만 동작합니다.

준비 로컬 방식은 Node.js 22 이상이 필요합니다 — npx 가 커넥터를 자동으로 받아 실행하므로 별도 설치는 없습니다. 로컬 파일 경로 이미지 업로드가 필요할 때 이 방식을 쓰세요. 버전 확인: node -v (v22.x 이상이면 OK; 낮으면 nodejs.org 에서 LTS 설치).

① Claude Code (터미널)

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

bash
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
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).

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 에 추가합니다.

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개만 넣으면 됩니다.

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

3 연결 확인

  1. 클라이언트를 재시작합니다(설정 변경 반영).
  2. 도구 목록에 md-log 가 연결됨(connected) 으로 보이는지 확인합니다. (Claude Code 는 /mcp)
  3. AI 에게 자연어로 시켜 봅니다 — 아래 §4 예시.
성공 “내 문서에서 ‘지난주 리포트’ 검색해줘” 처럼 말했을 때 결과가 돌아오면 정상 연결된 것입니다.

4 사용 예 & 자동화

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

📝 “이 분석 결과를 리포트/주간/2026-W26.md 로 저장해줘.”
➕ “방금 그 문서에 결론 섹션을 이어서 추가해줘.”
🔎 “내 문서들에서 ‘전환율’ 들어간 보고서 찾아줘.”
📂 “리포트 폴더에 어떤 파일들이 있는지 보여줘.”
🗂 “작년 리포트들을 아카이브/2025 폴더로 옮겨서 정리해줘.”
🕘 “이 문서의 버전 히스토리 보여주고, 두 버전 전 내용과 비교해줘.”

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

규칙 파일로 자동 저장 (별도 지시 없이)

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

예시 — 규칙 파일에 이런 규칙을 추가:

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

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

활용 팁 매 작업이 자동으로 쌓이므로, 며칠 뒤 · 다른 기기에서 “지난주에 무엇을 했는지”를 다시 열어보거나, 신규 합류자 · 새 에이전트에게 프로젝트 히스토리를 그대로 넘길 수 있습니다. diff 를 일일이 다 읽지 않고 리포트 단위로 사람이 검토하는 휴먼-인-더-루프 흐름에 적합합니다.

5 키 보안

중요 MCP 키(mdlog_pat_…)는 비밀번호와 같습니다. 화면 공유·캡처·채팅·공개 저장소에 노출하지 마세요.

6 문제 해결

증상확인 / 해결
md-log 가 목록에 없음 / not connected설정 저장 후 클라이언트를 완전히 재시작했는지 확인. (로컬 npx 방식이라면 node -v 가 22 이상인지도 확인.)
npx / node 를 찾을 수 없음Node.js 미설치 — nodejs.org 에서 LTS 설치 후 터미널/앱 재시작.
모든 작업이 인증 오류(401)키가 틀렸거나 만료/폐기됨. 키를 다시 정확히 붙여넣거나(mdlog_pat_ 포함, 공백 없이) 설정 → 토큰에서 재발급.
연결은 되는데 응답이 없음/타임아웃MDLOG_API_BASE_URL 이 서비스 주소(https://app.md-log.com/api/v1, 끝 /api/v1 포함)와 정확히 같은지 확인.
저장은 되는데 “토큰/세션 관리”는 거부됨정상입니다 — 이 키는 문서 작업 전용이며 계정 관리 권한은 없습니다.
파일 경로 오류(VALIDATION)파일명은 .md 로 끝나야 하고, ..·역슬래시·빈 폴더명은 사용할 수 없습니다.

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

7 자주 묻는 질문

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

원격(URL) 방식은 아무것도 설치할 필요 없이 주소와 키만으로 연결됩니다(권장). 로컬(npx) 방식은 Node.js 만 있으면 되고, 연결 도구를 처음 사용 시 npx 가 자동으로 받아 실행하므로 별도 설치/빌드가 필요 없습니다.

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

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

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

웹 앱 설정 → 토큰에서 기존 키를 폐기하고 새 키를 직접 발급할 수 있습니다. 새 키를 받으면 URL 방식은 헤더의 Bearer 토큰을, 로컬 npx 방식은 MDLOG_PAT 값을 교체하고 클라이언트를 재시작하면 됩니다.

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

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