MCP 연동
Monjiro는 MCP(Model Context Protocol) 서버를 제공합니다. Claude Code나 Codex 등의 AI 도구를 연결하면 AI에게 문서를 읽게 하거나 페이지를 만들게 할 수 있습니다.
AI 도구를 연결하는 방법은 두 가지입니다. 보통은 토큰을 발급하지 않고 로그인해 연결하는 방법을 사용해 주세요. 브라우저로 로그인할 수 없는 환경(CI나 서버에서 실행하는 처리 등)이나 로그인 연결을 지원하지 않는 AI 도구에서는 토큰으로 연결하는 방법을 사용해 주세요.
할 수 있는 일
| 권한 | 할 수 있는 일 |
|---|---|
| 읽기 전용 | 문서·페이지 목록, 본문 읽기, 검색, 페이지 스크린샷, 작성 가이드 읽기, 번역 현황 확인, 질문 이력(독자가 AI 채팅에서 한 질문과 AI의 답변·독자의 평가) 읽기 |
| 읽기와 편집 | 위의 내용에 더해 페이지 작성·업데이트·삭제, 이미지 추가, 페이지 트리의 순서·깊이 변경, 페이지 설정(비공개, 헤더·페이지 트리·이동 경로·이전/다음 페이지 링크·푸터 표시) 변경, 번역 입력, 커버 이미지·헤더 로고·파비콘 설정 |
권한은 로그인해 연결하는 경우에는 허용 화면에서, 토큰으로 연결하는 경우에는 토큰을 발급할 때 선택합니다. 어느 방법이든 AI 도구는 연결한 사용자의 계정으로, 그 사용자의 권한 범위 안에서 문서를 이용합니다.
AI가 편집하는 것은 작업 중인 내용뿐입니다. 공개는 자동으로 이루어지지 않습니다. 커버 이미지·로고·파비콘도 작업 중인 내용에 설정됩니다. 화면에서 내용을 확인한 뒤 문서 공개의 절차로 공개해 주세요.
MCP에는 Monjiro의 문서 작성 가이드(페이지 구성, AI 채팅이 답하기 쉬운 글쓰기, 블록의 쓰임새 등)가 포함되어 있습니다. AI 도구는 이 가이드를 읽은 뒤 페이지를 만듭니다.
로그인해 연결하기
인증용 토큰을 발급할 필요가 없습니다. AI 도구가 여는 브라우저에서 Monjiro에 로그인해 연결을 허용합니다(MCP의 OAuth 방식을 사용합니다). MCP 서버를 URL로 추가할 수 있고 OAuth 로그인을 지원하는 AI 도구라면 이 방법으로 연결할 수 있습니다.
AI 도구에 추가할 MCP 서버의 URL은 다음과 같습니다.
https://app.monjiro.io/api/mcp연결 과정은 모든 AI 도구에서 같습니다.
- AI 도구에 위의 URL을 MCP 서버로 추가합니다.
- AI 도구에서 인증(로그인)을 시작합니다. 브라우저에서 Monjiro 화면이 열립니다.
- Monjiro에 로그인하지 않은 경우에는 로그인 화면이 표시됩니다. 로그인하면 연결을 허용하는 화면으로 넘어갑니다.
- 허용 화면에서 허용할 내용("읽기 전용" 또는 "읽기와 편집")을 선택하고 "허용"을 클릭합니다.
- 브라우저에서 AI 도구로 돌아가면 Monjiro의 MCP를 사용할 수 있게 됩니다.
URL을 추가하는 방법과 인증을 시작하는 방법은 AI 도구마다 다릅니다. 각 AI 도구의 설명도 함께 확인해 주세요.
허용 화면에는 연결을 요청한 앱의 이름과, 허용한 뒤 돌아갈 위치(사용 중인 컴퓨터의 localhost나 AI 도구 서비스의 주소)가 표시됩니다. 앱의 이름은 앱이 스스로 밝힌 것입니다. 직접 시작한 연결이 아니라면 "거부"를 클릭해 주세요.
예: Claude Code의 경우
- 터미널에서 다음 명령을 실행해 MCP 서버를 추가합니다.
claude mcp add --transport http monjiro https://app.monjiro.io/api/mcp- Claude Code에서 /mcp를 입력하고 목록에서 monjiro를 선택해 인증을 시작합니다. 브라우저가 열리면 위의 3단계부터와 같이 로그인해 연결을 허용합니다.
연결 후 사용 방법
연결한 뒤에는 AI 도구에 다음과 같은 요청을 할 수 있습니다.
- "Monjiro 문서 목록을 보여 줘"
- "○○ 페이지를 써 줘"
- "○○ 페이지를 △△ 페이지 아래로 옮겨 줘", "페이지 순서를 절차 순서대로 바꿔 줘"
- "○○ 페이지를 비공개로 해 줘"
- "공지 페이지에서는 이전·다음 페이지 링크를 표시하지 않게 해 줘"
- "지난달 질문 이력을 보고, 답변 평가가 좋지 않았던 질문에 답할 수 있도록 페이지를 고쳐 줘"
- "이 로고 이미지를 헤더 로고로 설정해 줘"
로그인해 연결한 경우 연결은 계속 사용할 수 있습니다. 단, 30일 동안 한 번도 사용하지 않으면 다시 로그인해 연결을 허용해야 합니다.
질문 이력에는 독자가 AI 채팅에 입력한 문장이 그대로 포함됩니다. AI 도구에 읽게 할 경우, 독자가 입력한 개인정보 등도 AI 도구에 전달된다는 점에 주의해 주세요.
연결된 앱 확인·취소하기
화면 오른쪽 위의 계정 메뉴에서 "계정 설정"을 열면, "MCP로 연결된 앱"에 로그인해 허용한 앱 목록이 표시됩니다. 앱마다 허용한 내용, 연결한 날, 마지막으로 사용한 일시를 확인할 수 있습니다.
연결을 취소하려면 해당 앱의 "취소"를 클릭하고, 확인 창에서 "취소하기"를 클릭합니다. 취소한 앱은 즉시 사용할 수 없게 됩니다. 다시 사용하려면 로그인해 연결을 다시 허용해 주세요.
허용한 내용을 바꾸려면 AI 도구에서 다시 로그인해 허용하면, 새로 선택한 내용으로 바뀝니다.
토큰으로 연결하기
브라우저로 로그인할 수 없는 환경이나 로그인 연결을 지원하지 않는 AI 도구에서는 계정 설정에서 발급한 토큰으로 연결합니다.
토큰 발급하기
- 화면 오른쪽 위의 계정 메뉴에서 "계정 설정"을 엽니다.
- "MCP 토큰"의 "토큰 발급"을 클릭합니다.
- 이름(예: Claude Code), 유효 기간(30일·90일·1년), 권한을 선택하고 "발급"을 클릭합니다.
- 발급한 토큰과 연결 예시(Claude Code·Codex)가 표시됩니다. 토큰은 이때만 표시됩니다. 복사해서 안전한 곳에 보관해 주세요.
Claude Code에 토큰으로 연결하기
터미널에서 다음 명령을 실행합니다. <token>은 발급한 토큰으로 바꿔 주세요.
claude mcp add --transport http monjiro \
https://app.monjiro.io/api/mcp \
--header "Authorization: Bearer <token>"Codex에 연결하기
Codex에서는 토큰 값을 명령에 직접 지정할 수 없습니다. 토큰을 환경 변수에 설정하고, 그 환경 변수의 이름을 지정합니다.
- 터미널에서 다음 명령을 실행합니다.
codex mcp add monjiro \
--url https://app.monjiro.io/api/mcp \
--bearer-token-env-var MONJIRO_MCP_TOKEN- 토큰을 환경 변수 MONJIRO_MCP_TOKEN에 설정합니다. 셸 설정 파일(~/.zshrc 등)에 다음 줄을 추가하고 터미널을 다시 열어 주세요. <token>은 발급한 토큰으로 바꿉니다.
export MONJIRO_MCP_TOKEN="<token>"- Codex를 다시 시작하면 Monjiro의 MCP를 사용할 수 있게 됩니다. 요청하는 방법은 다른 AI 도구와 같습니다.
토큰은 Codex 설정에도 명령 기록에도 남지 않으며, 환경 변수에서 읽어옵니다.
Codex 버전에 따라서는 codex mcp add에서 --url을 지정할 수 없는 경우가 있습니다. 이 경우에는 설정 파일(~/.codex/config.toml)에 다음 내용을 추가한 뒤 2단계로 진행해 주세요.
[mcp_servers.monjiro]
url = "https://app.monjiro.io/api/mcp"
bearer_token_env_var = "MONJIRO_MCP_TOKEN"토큰 취소하기
계정 설정의 "MCP 토큰" 목록에서 해당 토큰의 "취소"를 클릭하고, 확인 창에서 "취소하기"를 클릭합니다. 취소한 토큰은 즉시 사용할 수 없게 됩니다.