API 키 대신 OAuth 2.1
모든 플랫폼은 브라우저에서 CIMD 또는 PKCE 기반 OAuth로 직접 로그인합니다. 채팅에 비밀번호나 동기화 토큰, 모델 키를 붙여넣지 않습니다.
PaperEnjoyer MCP · v0.1.1
AI 도우미를 PaperEnjoyer에 연결하세요. 논문 추가, 검색, 정독, 주석 저장 후 기기에 변경 사항이 동기화됩니다.
https://api.paperenjoyer.com/mcp“이 논문을 내 PaperEnjoyer에 추가해 줘: https://arxiv.org/abs/1706.03762”
클라우드 라이브러리에 추가하고 자동 분석을 시작했습니다. 동기화가 켜진 데스크톱·모바일 앱을 열면 자동으로 반영됩니다.
“PaperEnjoyer에서 어텐션 관련 논문을 찾아 3.2절을 확인해 줘.”
Attention Is All You Need 3.2.1절을 확인했습니다. 내적을 √dk로 나누면 차원이 커질 때 softmax 기울기가 소실되는 것을 완화합니다.
“PaperEnjoyer에서 정독을 시작하고 스케일링 인수 메모를 주석으로 저장해 줘.”
클라우드에서 PaperCore 정독을 시작했고 3.2.1절 해당 문장에 주석을 정확히 연결해 저장했습니다.
“중복된 초안 논문을 휴지통으로 옮겨 줘.”
‘Attention Draft (2017)’을 휴지통으로 이동합니다(복구 가능, 영구 삭제 불가). 계속 진행할까요?
작동 방식
모든 플랫폼은 브라우저에서 CIMD 또는 PKCE 기반 OAuth로 직접 로그인합니다. 채팅에 비밀번호나 동기화 토큰, 모델 키를 붙여넣지 않습니다.
MCP 도구는 동기화된 클라우드 라이브러리를 직접 다룹니다. 가져오기 분석과 PaperCore 정독은 서버에서 진행되고 각 기기로 동기화됩니다.
열람과 가져오기는 바로 진행되지만, 삭제·작업 취소·타인의 주석 변경은 action_prepare로 영향을 먼저 보여 주고 확인을 받은 뒤 실행합니다.
25가지 클라우드 도구
폴더 구조, 태그, 논문 수를 확인하고 제목·저자·초록·DOI·arXiv ID로 동기화된 논문을 검색합니다.
원문 PDF와 정독 버전을 문단 단위로 읽어 오며 검증된 스냅샷과 UTF-16 인용 위치를 함께 제공합니다.
PDF, arXiv, OpenReview, DOI 링크를 전달하면 가져온 뒤 MinerU와 PaperCore로 자동 분석합니다.
200 MiB, 200페이지 이하의 암호화되지 않은 PDF를 플러그인 도우미나 이 페이지의 일회성 브라우저 링크로 업로드합니다.
PaperEnjoyer를 언급한 정독 요청만 클라우드 작업으로 실행하고 상태를 추적해 모든 기기에 동기화합니다.
폴더 생성, 논문 이동, 메타데이터 수정과 함께 원문이나 정독 노트의 특정 문장에 주석을 남길 수 있습니다.
01 · 플랫폼 선택
아래에서 사용하는 AI 플랫폼을 선택하면 설치 단계, 복사 가능한 명령어, 상세 가이드 및 문제 해결 방법을 바로 확인할 수 있습니다.
먼저 ChatGPT 웹 Plugins에서 사용자 지정 MCP 연결을 생성·승인하세요. 아래 ZIP은 선택형 워크플로 Skill입니다.
요구 사항:사용자 지정 MCP를 지원하는 ChatGPT 계정 및 워크스페이스
빠른 시작
먼저 연결하고 나중에 워크플로를 추가하는 이유
0.1.1부터는 각 사용자가 ChatGPT에서 직접 원격 MCP 연결(offline_access 포함)을 생성하므로 공용 App ID가 필요하지 않습니다.
paperenjoyer-chatgpt-0.1.1.zip에는 Skill과 업로드 도우미만 들어 있으며 MCP 설정이나 .app.json은 없습니다. 설정 창에 연결 버튼이 없는 것이 정상입니다.
이전에 ChatGPT에 구버전 paperenjoyer-codex-0.1.0.zip을 설치했다면 먼저 새 MCP 연결을 만들고 테스트한 뒤 구버전을 제거하세요.
문제 해결
Add custom MCP server 메뉴가 없음: 계정 요금제나 워크스페이스 관리자 정책에서 사용자 지정 연결을 허용하는지 확인하세요. 워크플로 ZIP만으로는 우회할 수 없습니다.
도구가 보이지 않음: 생성한 연결을 설치했고 새 대화에서 @로 선택했는지 확인하세요.
권한 만료 또는 해제됨: 아래 연결 목록에서 다시 활성화한 다음 ChatGPT의 해당 연결 설정에서 재인증하세요.
plugin.json, mcp.json, skills/ 및 Codex 호환 매니페스트를 포함한 Agent Plugins 1.0 패키지입니다.
요구 사항:플러그인 마켓플레이스 또는 로컬 ZIP을 지원하는 Codex
빠른 시작
상세 안내 및 설정 참고
codex plugin marketplace add watericetangcw/PaperEnjoyer-Plugins패키지 구성 및 로컬 PDF 안내
SKILL.md만 복사하고 mcp.json을 빠뜨리지 마세요. 마켓플레이스에서 전체 플러그인을 설치해야 합니다.
ChatGPT 사용자는 Codex 패키지 대신 위의 ChatGPT 탭 절차를 따르세요.
호스트가 로컬 PDF 파일을 직접 전달할 수 없을 때는 Codex가 제공하는 웹 업로드 링크로 이 페이지에서 업로드하세요.
문제 해결
설치 후 도구가 나타나지 않음: SKILL.md만 수동 복사하지 않고 전체 플러그인을 설치했는지 확인하세요.
인증 만료: Codex MCP 설정에서 다시 연결하고, 아래에서 해제했다면 먼저 ‘다시 활성화’를 누르세요.
Claude Code 마켓플레이스 설치와 Claude 웹/데스크톱/Cowork용 원격 커넥터 및 별도 Skill을 지원합니다.
요구 사항:Claude Code CLI 또는 Connectors/Skills 지원 Claude
빠른 시작
상세 안내 및 설정 참고
/plugin marketplace add watericetangcw/PaperEnjoyer-Plugins
/plugin install paperenjoyer@paperenjoyerclaude --plugin-dir /absolute/path/to/paperenjoyerClaude Code와 Claude 웹/데스크톱의 차이
paperenjoyer-claude-0.1.1.zip은 Claude Code용 플러그인으로 .claude-plugin/plugin.json, .mcp.json, skills가 함께 포함됩니다.
Claude 웹/데스크톱에서는 원격 커넥터(No sign in 대신 Use Claude’s published identity 선택)와 Custom Skills(paperenjoyer-claude-skill-0.1.1.zip)를 각각 설정합니다.
새 논문을 가져온 뒤에는 task_get으로 분석 완료를 확인한 다음 PaperCore 정독을 시작하세요.
문제 해결
로그인이 실패함: 커넥터의 OAuth 클라이언트가 ‘Use Claude’s published identity’인지 확인하세요.
Skill 업로드 오류: Claude Code 플러그인 ZIP이 아닌 paperenjoyer-claude-skill-0.1.1.zip을 업로드하세요.
저장소 루트 또는 .tgz로 바로 설치할 수 있으며 내장 stdio OAuth 브리지로 로그인합니다.
요구 사항:DSH 0.2.0-rc.2 이상 및 PATH의 Node 22.19+
빠른 시작
상세 안내 및 설정 참고
https://github.com/watericetangcw/PaperEnjoyer-Plugins.gitdsh plugin --profile desktop add https://github.com/watericetangcw/PaperEnjoyer-Plugins.git버전 고정 및 원격 SSH 주의 사항
플러그인을 활성화하는 것만으로는 유료 정독 작업이 실행되지 않습니다.
롤백 가능한 업데이트가 필요하면 릴리스의 40자리 커밋 해시를 #<sha> 형식으로 지정하세요.
원격 SSH 호스트에서 실행할 때 콜백은 해당 호스트의 127.0.0.1로 전송됩니다. 로컬에서 실행하거나 SSH 포트 포워딩을 사용하며 인증 코드를 채팅에 붙여넣지 마세요.
문제 해결
브리지 시작 실패: DSH가 사용하는 PATH에 Node 22.19+가 있는지 확인하세요.
재인증 필요: paperenjoyer_connect를 다시 실행하세요(가능한 경우 OS 키체인에 보관됩니다).
@opencode/plugin으로 원격 MCP와 Skill을 등록하며, OpenCode 1용 JSON 예시도 제공합니다.
요구 사항:OpenCode 2(또는 원격 MCP OAuth를 지원하는 OpenCode 1)
빠른 시작
상세 안내 및 설정 참고
npm install --ignore-scripts{
"$schema": "https://opencode.ai/config.json",
"plugins": ["/absolute/path/to/paperenjoyer"]
}{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"paperenjoyer": {
"type": "remote",
"url": "https://api.paperenjoyer.com/mcp",
"oauth": {}
}
}
}OpenCode 2와 OpenCode 1 비교
OpenCode 2는 ctx.mcp.transform 및 ctx.skill.transform으로 등록하며 같은 이름의 기존 설정이 우선합니다.
OpenCode 1을 사용 중이라면 위의 mcp 블록을 기존 설정에 병합하고 skills/paperenjoyer를 복사하세요(v1에 v2 플러그인 진입점을 로드하지 마세요).
문제 해결
플러그인이 로드되지 않음: 압축 해제 폴더에서 npm install --ignore-scripts를 실행했는지와 절대 경로를 확인하세요.
기존 설정과 충돌: 기존 설정 URL이 https://api.paperenjoyer.com/mcp인지 확인하세요.
registerMcpServer와 스킬을 담은 전용 Pi 패키지로 별도 어댑터가 필요 없습니다.
요구 사항:네이티브 MCP(registerMcpServer) 지원 Pi 버전
빠른 시작
상세 안내 및 설정 참고
pi install /absolute/path/to/package전용 .tgz 사용 이유
전용 .tgz는 Pi Git 설치기가 멀티 플랫폼 저장소의 하위 폴더를 찾지 못하는 문제를 방지합니다.
Pi가 네이티브 registerMcpServer를 지원하면 별도의 커뮤니티 MCP 어댑터가 필요하지 않습니다.
설정 파일에 같은 이름의 MCP 서버를 선언한 경우 파일 설정이 우선하므로 URL이 https://api.paperenjoyer.com/mcp인지 확인하세요.
문제 해결
registerMcpServer 없음 오류: 네이티브 MCP를 지원하는 최신 Pi로 업그레이드한 후 /reload를 실행하세요.
Qoder 네이티브 매니페스트, mcp.json, 스킬을 포함하며 첫 실행 시 고정 버전 브리지를 자동 구동합니다.
요구 사항:Node 22.19+ 및 Qoder에서 실행 가능한 npx
빠른 시작
브리지 인증 방식
mcp.json이 npx로 해당 릴리스의 고정 OAuth stdio 브리지를 실행해 연결합니다.
로그인 후 도구 목록이 바로 갱신되지 않으면 Qoder에서 MCP 서버를 한 번 다시 연결하세요.
시스템 키체인이 지원되면 로그인 상태가 유지되어 매번 다시 로그인할 필요가 없습니다.
문제 해결
로그인 후 도구가 안 보임: Qoder MCP 설정에서 PaperEnjoyer를 한 번 다시 연결해 주세요.
브리지 실행 실패: 기본 PATH의 node 버전이 22.19+인지 확인하세요.
GitHub 마켓플레이스 또는 로컬 ZIP으로 간편하게 설치되며 Plugin MCP 서버 그룹에 표시됩니다.
요구 사항:Node 22.19+ 및 ZCode에서 실행 가능한 npx
빠른 시작
상세 안내 및 설정 참고
watericetangcw/PaperEnjoyer-Plugins보안 및 확인 절차
연결이 완료되면 도구는 ZCode의 Plugin MCP 서버 그룹에 표시됩니다.
인증은 로컬 브라우저 PKCE 흐름으로만 진행되며 채팅에 비밀번호나 토큰을 입력하지 않습니다.
논문 삭제나 작업 취소 전에는 항상 action_prepare로 영향 목록을 먼저 보여 주고 확인을 기다립니다.
문제 해결
첫 실행이 약간 느림: npx가 고정 버전 브리지를 처음 내려받는 동안만 시간이 걸립니다.
재연결 필요: 아래에서 연결을 해제하고 다시 활성화한 뒤 paperenjoyer_connect를 다시 실행하세요.
자주 쓰는 프롬프트
클릭하면 복사됩니다. 일반적인 논문 읽기 요청은 기존 AI가 처리하며 PaperEnjoyer를 언급할 때만 연결된 도구로 실행됩니다.
“이 논문을 내 PaperEnjoyer에 추가해 줘.”
“PaperEnjoyer에서 어텐션 관련 논문을 찾아 줘.”
“PaperEnjoyer에서 이 논문을 정독해 줘.”
“PaperEnjoyer에 최근 추가한 논문 5편을 보여 줘.”
목록 조회, 본문 읽기, 한도 확인, 요청한 논문 가져오기는 별도 확인 없이 바로 실행됩니다. 중복 PDF는 기존 논문을 재사용해 중복 과금하지 않습니다.
가져오기 시 자동 분석이 소량의 크레딧을 사용할 수 있고 정독은 PaperCore 크레딧을 사용합니다. 외부 모델 API 키는 플러그인에 저장하지 않습니다.
휴지통 이동, 작업 취소, 다른 출처의 주석 수정은 action_prepare로 5분간 유효한 영향 미리 보기를 표시하고 명시적 동의를 받은 뒤 실행합니다.
가져오면 자동 분석되며 소량의 크레딧이 사용될 수 있습니다. 정독에는 PaperCore 크레딧이 사용됩니다. 삭제, 작업 취소, 다른 작성자의 주석 변경은 확인이 필요합니다.
내 PaperEnjoyer 클라우드 라이브러리에 접근 권한이 있는 플랫폼을 관리합니다.
연결을 해제하면 새 요청은 즉시 차단되며 이미 제출된 백그라운드 작업은 계속 완료됩니다. 다시 활성화하면 새 연결 ID가 발급되므로 AI 플랫폼에서 재인증하세요.
200 MiB, 200페이지 이하 PDF를 선택하세요. 자동 분석됩니다.
MCP 자주 묻는 질문
아니요. MCP 도구는 동기화된 클라우드 라이브러리를 직접 읽고 씁니다. 분석과 PaperCore 정독은 클라우드에서 진행되며 동기화가 켜진 기기에서 나중에 자동으로 받습니다.
클라우드 MCP는 PaperEnjoyer 계정에 동기화된 논문, 폴더, 노트만 볼 수 있습니다. 동기화하지 않은 로컬 전용 파일은 원격 도우미에게 노출되지 않습니다.
MCP에는 영구 삭제 도구가 없으며 삭제는 휴지통 이동만 가능합니다. 또한 삭제, 작업 취소, 다른 출처의 주석 수정은 action_prepare 확인 절차가 강제됩니다.
도우미에게 PaperEnjoyer 업로드를 준비해 달라고 하면 이 페이지의 전용 링크(?upload=...)를 돌려줍니다. 로그인 후 최대 200 MiB / 200페이지 PDF를 바로 올릴 수 있습니다.