도움말 센터
LaTeX와 Typst 프로젝트를 작성하고 컴파일하며 공유하기 위한 실용적인 안내입니다.
외부 Agent 연결하기
MCP 호환 외부 Agent를 내가 고른 프로젝트와 범위에서만 동작하게 합니다.
로그인해서 앱 연결하기
Claude처럼 MCP 서버 URL만으로 서버를 추가하는 앱에는 토큰이 필요 없습니다. 앱이 JointTex를 열어 주면 로그인하고 승인하면 됩니다.
방법
- 계정 설정에서 액세스 토큰을 열고 MCP 서버 URL을 복사합니다.
- 앱에서 서버를 추가하는 곳에 붙여 넣습니다. Claude에서는 사용자 지정, 커넥터, 사용자 지정 커넥터 추가 순서입니다.
- 앱이 브라우저에서 JointTex를 엽니다. 요청이 나오면 로그인하고, 페이지에 표시된 돌아갈 주소를 확인한 뒤 권한과 프로젝트를 고르고 허용을 선택합니다.
- 앱은 액세스 토큰의 연결된 앱에 표시되며, 그곳에서 권한을 줄이거나 연결을 해제할 수 있습니다.
MCP 토큰 만들기
JointTex 교육 요금제, Plus, Pro는 계정 설정에 표시된 MCP 서버를 통해 Codex, Claude Code 등 호환 외부 Agent를 연결할 수 있습니다.
방법
- 계정 설정에서 액세스 토큰을 열어 ‘MCP 토큰 사용’을 펼치고, 그 Agent에 필요한 프로젝트와 권한만 선택해 MCP 토큰을 만드세요.
- 토큰은 한 번만 표시됩니다. 복사한 뒤 표시된 MCP 서버 URL과 함께 Authorization Bearer 헤더로 Agent에 설정하세요.
- 또는 ‘Agent 설정 프롬프트 복사’를 골라 Agent에 붙여 넣으세요. 프롬프트에는 엔드포인트와 토큰 전체가 들어 있으므로 신뢰하는 Agent에만 보내세요.
- 읽기 전용 범위로 시작하세요. 나중에 Agent가 소스를 바꿔야 하면 파일 쓰기 범위가 있는 새 토큰을 만드세요. 토큰에서 범위를 뺄 수는 있어도 더할 수는 없습니다.
범위와 프로젝트 고르기
토큰에는 범위 목록과 프로젝트 목록이 담기며, Agent는 그 어느 쪽 밖에서도 아무것도 할 수 없습니다. 공개된 도움말 가이드만은 어떤 토큰으로도 읽을 수 있습니다.
방법
- 범위는 projects:read, projects:create, members:invite, files:read, files:write, review:decide, compile:run, comments:read, comments:write, templates:publish, account:read입니다. 새 토큰은 읽기 범위 세 개로 시작하고, 쓰기 범위에는 항상 해당 읽기 범위가 따라옵니다.
- projects:create가 있으면 Agent가 계정에 프로젝트를 만들 수 있고, members:invite가 있으면 내가 소유한 프로젝트에 이메일로 사람을 초대할 수 있습니다. 둘 다 요금제의 프로젝트 수와 협업자 수 한도에 포함됩니다. 새 토큰에서는 선택되어 있지 않고 기존 토큰에도 추가되지 않으니, Agent에게 맡기고 싶을 때만 선택하세요.
- templates:publish가 있으면 Agent가 내가 소유한 프로젝트를 템플릿 라이브러리에 게시하거나, 내가 게시한 템플릿을 다시 게시할 수 있습니다(「템플릿으로 게시」와 같습니다). 템플릿은 바로 공개됩니다. 새 토큰에는 선택되어 있지 않고 기존 토큰에도 주어지지 않습니다.
- account:read가 있으면 Agent가 계정에 이미 설정된 내용을 보고 나머지 설정을 도울 수 있습니다. 요금제, Zotero·WebDAV·GitHub 연결 여부, 보유한 Git 및 MCP 토큰 수, Agent 커넥터와 조직이 그 대상입니다. 키, 비밀번호, 토큰은 절대 보지 못합니다. 새 토큰에서는 선택되어 있지 않습니다.
- comments:write가 있으면 Agent가 본문의 한 구절에 검토 스레드를 만들고, 스레드에 답글을 달고, 해결하거나 다시 열 수 있습니다. 댓글을 수정할 수는 없고, 삭제는 자신이 만든 스레드만 할 수 있습니다.
- Agent가 쓴 내용은 앱 안의 Agent가 한 편집처럼 추적된 변경 사항으로 남고, 프로젝트 구성원이 검토합니다. review:decide가 있으면 추적된 변경 사항을 수락하거나 거부할 수도 있습니다. 결정을 사람에게 맡기려면 이 범위를 주지 마세요.
- files:write가 있으면 Agent가 프로젝트의 컴파일 설정(루트 파일, 엔진, TeX Live 버전, 컴파일 모드)도 변경할 수 있으며, 이 설정은 모든 공동 작업자에게 적용됩니다. files:read가 있으면 컴파일된 PDF를 내려받는 링크를 받을 수 있습니다. 링크는 로그인 없이 10분 동안 유효하고, Agent 연결을 해제하면 더 이상 작동하지 않습니다.
- ‘모든 프로젝트’를 고르면 지금 접근할 수 있는 프로젝트와 앞으로 접근하게 될 프로젝트가 모두 포함됩니다. Agent가 할 일이 좁다면 프로젝트를 지정하세요.
- 토큰은 내 역할을 넘지 못합니다. 내가 뷰어인 프로젝트에서는 files:write가 있어도 Agent가 쓸 수 없습니다.
연결 감시와 철회
보이지 않는 토큰은 통제할 수 없는 토큰입니다. 모든 연결은 목록에 남고 언제든 되돌릴 수 있습니다.
방법
- ‘액세스 토큰’의 ‘MCP 토큰 사용’에서 그 토큰이 접근할 수 있는 프로젝트와 권한을 확인하세요.
- 작업이 달라지면 더 넓은 토큰을 새로 발급하지 말고 ‘접근 권한 편집’으로 프로젝트를 바꾸거나 범위를 빼세요. 범위를 더하려면 새 MCP 토큰이 필요합니다.
- 필요 없어지면 즉시 철회하세요. 철회는 곧바로 적용됩니다.
- 외부 Agent가 쓴 내용도 다른 편집과 똑같이 프로젝트 기록에 남으므로 검토하거나 되돌릴 수 있습니다.
- MCP 토큰은 10개까지 둘 수 있습니다. 요금제가 교육 요금제, Plus, Pro 아래로 내려가면 기존 토큰은 저장된 채 일시 중지됩니다.