quillink-mcp

Quillink 노트, 폴더, 태그에 대한 읽기 전용 액세스를 Claude Desktop, Claude Code 및 기타 MCP 호환 클라이언트와 같은 AI 도구에 제공하는 MCP 서버입니다.

Pro Quillink 요금제가 필요합니다(API 액세스는 Pro 전용 기능입니다).

PyPI에 게시되지 않음 — 소스에서 로컬로 빌드하여 실행하세요.

빌드

git clone https://github.com/dagistankaradeniz/gcp-note-taking-mcp.git
cd gcp-note-taking-mcp
python3 -m venv .venv
.venv/bin/pip install -e .

이렇게 하면 quillink-mcp 명령이 .venv/bin/에 설치됩니다. 해당 바이너리의 전체 경로(예: /Users/you/gcp-note-taking-mcp/.venv/bin/quillink-mcp)를 기록해 두세요. MCP 클라이언트는 활성화된 셸을 통하지 않고 직접 실행하므로 절대 경로가 필요합니다.

Related MCP server: Bruin

인증

두 가지 옵션:

옵션 A — OAuth 기기 로그인(대화형 사용에 권장):

.venv/bin/quillink-mcp login

기기 코드와 확인 URL이 열리며, 브라우저에서 승인하면 됩니다. 토큰은 OS 키링(또는 대체로 ~/.config/quillink-mcp/credential)에 저장됩니다.

옵션 B — 개인 액세스 토큰(PAT):

Quillink의 설정 → 개발자 → 토큰에서 생성하고(범위: notes:read, folders:read, tags:read), 환경 변수로 설정하세요:

export QUILLINK_TOKEN=qlk_pat_...

QUILLINK_TOKEN은 저장된 OAuth 로그인보다 항상 우선합니다.

Claude Desktop과 함께 사용

Claude Desktop 구성(~/Library/Application Support/Claude/claude_desktop_config.json, macOS 기준)에 추가하세요:

{
  "mcpServers": {
    "quillink": {
      "command": "/absolute/path/to/gcp-note-taking-mcp/.venv/bin/quillink-mcp"
    }
  }
}

login 대신 PAT를 사용하는 경우 구성에서 env var로 전달하세요:

{
  "mcpServers": {
    "quillink": {
      "command": "/absolute/path/to/gcp-note-taking-mcp/.venv/bin/quillink-mcp",
      "env": { "QUILLINK_TOKEN": "qlk_pat_..." }
    }
  }
}

구성 편집 후 Claude Desktop을 다시 시작하세요.

다른 MCP 클라이언트와 함께 사용

로컬 stdio MCP 서버를 실행할 수 있는 모든 클라이언트는 동일한 방식으로 작동합니다: .venv/bin/quillink-mcp의 절대 경로를 가리키면 됩니다(QUILLINK_TOKEN을 설정하거나, 자격 증명이 이미 저장되도록 quillink-mcp login을 한 번 실행한 후). 여기에는 Claude Code(claude mcp add quillink -- /absolute/path/to/.venv/bin/quillink-mcp)와 MCP stdio 전송을 지원하는 모든 OpenAI 호환 에이전트 런타임이 포함됩니다.

도구

모두 읽기 전용 — 이 서버는 어떤 것도 생성, 편집, 삭제할 수 없습니다.

볼트 노트는 여기에서 절대 접근할 수 없습니다 — 클라이언트 측에서 종단 간 암호화되므로 어떤 서버(이 서버 포함)도 읽을 수 없습니다. 조직 도구는 Team 요금제 조직에 속하지 않은 호출자에게 404를 반환합니다.

구성(환경 변수)

직접 실행(테스트용)

.venv/bin/quillink-mcp login
.venv/bin/quillink-mcp   # runs the server on stdio -- an MCP client normally launches this for you