Murfy MCP | Murfy

Claude, ChatGPT, Cursor 같은 AI 도구에 머피를 연결해 논문 프로젝트를 다루게 하는 방법입니다.

MCP(Model Context Protocol)는 AI 도구가 다른 앱을 직접 다루게 해 주는 연결 방식입니다. Murfy MCP를 연결하면 쓰던 AI 도구가 내 머피 프로젝트의 파일을 읽고 고치고, 컴파일까지 할 수 있습니다.

무료 Starter를 포함한 모든 플랜에서 쓸 수 있습니다.
따로 설치할 것은 없습니다.

연결하기

머피에서 대시보드 오른쪽 위의 프로필 사진 → 설정 → 연결된 앱으로 갑니다.
새 앱 연결에 있는 주소를 복사합니다.
쓰는 AI 도구의 MCP 서버(사용자 지정 커넥터) 추가 화면에 주소를 붙여 넣습니다.
AI 도구가 머피 화면을 열면, 내용을 확인하고 허용을 누릅니다.

AI 도구마다 MCP 서버를 추가하는 메뉴가 다릅니다. 각 도구의 공식 안내를 참고하시기 바랍니다.

도구	공식 안내
Claude (웹·데스크톱 앱)	Custom connectors
ChatGPT	Connect from ChatGPT
Cursor	MCP
Claude Code	MCP

VS Code에서도 쓸 수 있습니다.

머피 안의 연결 안내

머피에는 AI 도구별 연결 방법을 알려 주는 MCP 연결 안내 페이지가 있습니다. 로그인하지 않아도 열립니다. 이렇게 엽니다.

대시보드 오른쪽 위의 프로필 사진을 누르고 MCP 연결 안내를 고릅니다.
공지사항, 머피 가이드 페이지의 왼쪽 사이드바에서 MCP 연결 안내를 고릅니다.
설정 → 연결된 앱에서 AI별 설정 방법 보기를 누릅니다.

이 페이지는 다음으로 이뤄져 있습니다.

MCP URL: AI 도구에 추가할 주소를 복사하는 칸입니다.
AI에게 맡길 수도 있어요: 복사해서 Claude Code, Codex, Cursor에 붙여 넣을 수 있는 요청 문장입니다.
도구별 단계: Antigravity, ChatGPT, Claude, Claude Code, Codex, Cursor, VS Code 탭이 있습니다. Claude가 먼저 선택돼 있습니다.
할 수 있는 일: 요청 예시입니다.
잘 안 될 때: 자주 겪는 문제와 해결 방법입니다.

도구별 단계

모든 탭이 세 단계입니다. 도구에 머피를 추가하고, 열린 머피 화면에서 로그인하고, 허용을 누릅니다. 추가하는 방법은 도구마다 다릅니다.

도구	머피를 추가하는 방법
ChatGPT, Claude	커스텀 커넥터를 추가하고 MCP URL을 붙여 넣습니다
Claude Code, Codex	페이지에 나온 명령을 터미널에서 실행합니다
Antigravity, Cursor, VS Code	페이지에 나온 설정을 도구의 MCP 설정 파일에 추가합니다

탭마다 그 도구의 공식 안내로 가는 링크(추가하는 위치 보기)도 있습니다. 목록에 없는 AI라도 MCP를 지원하면 연결할 수 있습니다. 그 AI의 MCP나 커넥터 설정에 MCP URL을 넣고, 로그인한 뒤 허용을 누릅니다. 접근을 허용하면 그 AI가 연결된 앱에 나타납니다.

할 수 있는 일

예시	AI가 하는 일
새 실험 결과 반영	실험 폴더의 결과를 읽어 표와 그래프를 고치고 컴파일합니다. 실험 파일이 있는 Claude Code나 Cursor에서 됩니다
페이지 제한 맞추기	컴파일해 페이지 수를 세고, 긴 문장을 줄인 뒤 맞을 때까지 다시 컴파일합니다
제출 전 점검	`.tex` 파일과 `refs.bib`를 읽고 찾은 것을 알려 줍니다. 프로젝트는 바뀌지 않습니다
관련 연구 추가	`refs.bib`에 BibTeX 항목을 넣고 관련 연구 절에 문단을 씁니다

이 페이지는 프로젝트 이름을 말하고, 고치기 전에 바뀔 내용을 먼저 보여 달라고 요청하라는 팁도 알려 줍니다. AI가 지운 파일은 히스토리에서 되살릴 수 있습니다.

잘 안 될 때

문제	페이지의 안내
커스텀 커넥터를 추가할 수 없습니다	커넥터를 누가 추가할 수 있는지는 AI 앱마다 정합니다. 플랜에 따라 조직 소유자나 관리자만 추가할 수 있습니다. 그분께 문의하거나 그 도구의 설정 가이드를 열어 보시기 바랍니다
로그인 화면이 열리지 않습니다	대부분의 AI 앱은 창이나 터미널에도 로그인 링크를 보여 줍니다. 그 링크를 복사해 브라우저에서 열어 주시기 바랍니다
다른 머피 계정으로 연결했습니다	`연결된 앱`에서 연결을 해제한 뒤 AI에서 다시 연결해 주시기 바랍니다. 머피 화면에서 허용하기 전에 `계정 전환`을 눌러 주시기 바랍니다
AI가 머피를 쓰지 않습니다	어떤 AI 앱은 대화마다 커넥터를 켜야 합니다. 요청에 머피를 직접 언급해도 됩니다
AI가 프로젝트를 찾지 못합니다	보관한 프로젝트는 따로 말하지 않으면 빠집니다. 멤버인 프로젝트만 보이니, 맞는 계정으로 연결했는지 확인해 주시기 바랍니다
수정이 거부됩니다	그 프로젝트에서 뷰어 권한이라서 그렇습니다. AI가 읽고 컴파일할 수는 있지만, 파일은 소유자와 편집자만 바꿀 수 있습니다
AI가 다시 로그인하라고 합니다	30일 동안 쓰지 않거나 연결을 해제하면 연결이 끝납니다. AI에서 다시 로그인하고 `허용`을 눌러 주시기 바랍니다

허용 화면에서 확인할 것

허용을 누르기 전에 머피가 다음 내용을 보여 줍니다.

연결을 요청한 도구와 요청한 곳. 출처를 확인할 수 없으면 "출처를 확인할 수 없는 도구"라고 나옵니다.
연결할 머피 계정. 다른 계정으로 연결하려면 계정 전환을 누릅니다.
도구가 할 수 있는 일
- 프로젝트와 파일 보기
- 파일 내용 읽기
- 파일 만들기·수정·이동·삭제
- 컴파일 실행과 결과 확인

이 도구는 내 계정 권한으로 동작해요. 이미 접근할 수 있는 프로젝트에만 닿고, 열람만 가능한 프로젝트에서는 아무것도 바꾸지 못해요.

연결 관리하기

설정 → 연결된 앱의 연결 목록에서 연결한 도구, 연결한 날짜, 마지막 사용 시각을 볼 수 있습니다.

연결 해제: 도구 옆의 연결 해제를 누르면 그 도구의 접근이 바로 끊깁니다. 프로젝트는 아무것도 바뀌지 않습니다.
만료: 30일 동안 쓰지 않으면 연결이 끊기고 만료됨으로 표시됩니다. 그 도구에서 다시 연결하면 이어서 쓸 수 있습니다. 만료된 항목은 지우기로 목록에서 지웁니다.

알아 두면 좋은 점

AI 도구가 고친 내용은 직접 입력한 것처럼 문서에 바로 들어가고, 공동 저자에게도 보입니다. 먼저 확인하고 싶다면 바꾸기 전에 보여 달라고 요청하시기 바랍니다.
지운 파일은 히스토리에서 되살릴 수 있습니다.