> ## Documentation Index
> Fetch the complete documentation index at: https://docurise.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AI 앱 연결하기 (MCP)

> MCP 서버로 DocuRise를 Claude, ChatGPT 등 AI 앱에 연결합니다

DocuRise는 [MCP](https://modelcontextprotocol.io) 서버를 제공합니다. Claude나 ChatGPT 같은 AI 앱에 추가하고 평소 사용하는 DocuRise 계정으로 로그인하면, 앱이 내 대신 몇 가지 DocuRise 도구를 사용할 수 있습니다. API 키를 만들거나 붙여넣을 필요가 없습니다.

> [!NOTE]
>
> MCP 서버는 **프리뷰**입니다. 일부 계정에서만, 그리고 MCP를 포함한 요금제에서만 사용할 수 있으며,
> 도구와 이름, 동작은 바뀔 수 있습니다.

## 시작하기 전에

* AI 앱을 사용하는 브라우저와 같은 브라우저에서 DocuRise에 로그인해 두세요. 로그인하지 않았다면 승인 페이지에서 로그인하라고 안내합니다.
* MCP는 일부 계정에서만, MCP를 포함한 요금제에서 사용할 수 있습니다(위 안내 참고). 내 계정에서 사용할 수 없으면 승인 페이지에서 알려 주며, 아무것도 연결되지 않습니다.
* 웹에서 Claude나 ChatGPT를 쓸 때는 따로 설치할 것이 없습니다. Claude Code는 터미널에서 실행하므로 먼저 설치해야 합니다.

## 서버 URL

어떤 AI 앱이든 필요한 주소는 이것 하나입니다. 아래 상자 오른쪽 위의 복사 버튼을 누르세요.

```
https://docurise.io/api/mcp
```

뒤에 아무것도 붙이지 말고 그대로 붙여넣으세요. 서버는 MCP Streamable HTTP 전송을 사용하고, OAuth로 로그인하며, 요청 사이에 세션을 유지하지 않습니다.

## AI 앱에 DocuRise 추가하기

아래에서 사용하는 앱을 고르세요. 단계는 조금씩 다르지만 흐름은 항상 같습니다.

1. 서버 URL을 사용해 앱에 DocuRise를 사용자 지정 커넥터 또는 원격 MCP 서버로 추가합니다.
2. DocuRise 페이지가 열립니다. 필요하면 로그인한 뒤 **승인**(Approve)을 누릅니다.
3. 앱으로 돌아오면 DocuRise가 연결되어 있습니다.

앱 메뉴 이름은 가끔 바뀝니다. 아래 이름이 화면과 다르면 커넥터나 MCP 서버를 추가하는 메뉴를 찾으세요.

### Claude

claude.ai와 Claude 데스크톱 앱에서 사용할 수 있습니다.

**1. 커넥터 설정 열기**

왼쪽 사이드바에서 **사용자 지정**(Customize)을 열고 **커넥터**를 선택합니다. 이전 버전의 앱에서는 **설정 → 커넥터**입니다.

**2. 사용자 지정 커넥터 추가**

오른쪽 위의 **추가**를 누르고 **커스텀 커넥터 추가**를 선택합니다. 입력란이 두 개 있는 작은 창이 열립니다.

**3. 두 입력란 채우기**

**이름**에는 `DocuRise`를 입력하고, **MCP 서버 URL**에는 아래 주소를 붙여넣습니다.

```
https://docurise.io/api/mcp
```

그다음 **계속**을 누릅니다. Claude가 새 커넥터를 **연결**(Connect) 버튼과 함께 보여 주면 그 버튼을 누르세요.

**4. DocuRise 페이지에서 승인**

브라우저에서 DocuRise 페이지가 열립니다. 필요하면 로그인하세요. 내 계정, 요청한 앱, 그리고 **읽기**와 **읽기 및 쓰기** 중 고르는 선택지가 보입니다. 가장 안전한 **읽기**가 이미 선택되어 있으니 그대로 **승인**을 누르면 됩니다. 나중에 Claude가 무언가를 만들게 하려면 다시 연결하면서 읽기 및 쓰기를 선택하세요.

**5. Claude의 도구 권한 확인**

승인하면 Claude가 DocuRise 커넥터 화면을 보여 주고, 그 안에 **도구 권한** 항목("Claude가 이러한 도구를 사용할 수 있는 시기를 선택하세요")이 있습니다. 도구는 **읽기 전용 도구**와 **쓰기/삭제 도구** 두 묶음으로 나뉘고, 도구마다 항상 허용, 승인 필요, 차단 세 가지 옵션이 있습니다.

**여기서는 아무것도 바꾸지 않아도 됩니다.** 기본값은 모두 그대로 사용해도 되니 그대로 두고 창을 닫으세요. 이 설정은 Claude가 도구를 쓰기 전에 얼마나 자주 물어볼지만 정하며, 언제든 다시 와서 바꿀 수 있습니다. 쓰기 권한이 필요한 도구는 **읽기 및 쓰기**로 승인했을 때만 목록에 나타납니다.

사용해 보려면 새 대화를 열고 *"DocuRise에서 최근 문서 5개를 보여 줘"* 라고 요청해 보세요. Claude가 DocuRise 도구를 써도 되는지 물으면 허용하세요.

### ChatGPT

**1. 플러그인 설정 열기**

**플러그인**을 열고 오른쪽 위 **추가** → **맞춤형 MCP 서버 만들기**를 선택합니다.

**2. 양식 채우기**

이름 입력란에는 `DocuRise`를 입력하고, 서버 URL 입력란에는 아래 주소를 붙여넣습니다.

```
https://docurise.io/api/mcp
```

인증 방식은 **OAuth**로 둡니다. OAuth 설정은 ChatGPT가 DocuRise에서 자동으로 읽어 오므로 클라이언트 ID와 시크릿은 비워 둡니다.

**3. 만들고 승인하기**

확인란에 체크하고 서버를 만듭니다. DocuRise 페이지가 열리면 필요 시 로그인하고 **승인**을 누릅니다. **읽기**가 이미 선택되어 있으며 대부분의 경우 이대로 충분합니다.

**4. 대화에서 사용하기**

대화창에서 `@DocuRise`를 입력해 사용합니다. 예: *"@DocuRise 최근 문서 5개를 보여 줘"*

### Claude Code

Claude Code는 터미널에서 쓰는 Claude입니다. 먼저 설치되어 있어야 합니다.

**1. 서버 추가**

터미널을 열고 아래 명령어를 붙여넣은 뒤 Enter를 누릅니다.

```bash theme={null}
claude mcp add --transport http docurise https://docurise.io/api/mcp
```

**2. Claude Code를 시작하고 로그인**

`claude`를 실행합니다. Claude Code 안에서 `/mcp`를 입력하고 `docurise`를 선택한 뒤 로그인 링크를 따라가세요. 브라우저에서 DocuRise 페이지가 열리면 필요 시 로그인하고 **승인**을 누릅니다. **읽기**가 이미 선택되어 있습니다.

**3. 연결 확인**

`/mcp`를 다시 실행하면 `docurise`가 연결됨으로 표시됩니다. 일반 터미널에서 `claude mcp list`로도 확인할 수 있습니다.

### 다른 앱

OAuth를 지원하는 원격 MCP 서버를 추가할 수 있는 앱이라면, 원격 MCP 서버(HTTP)를 추가하고 서버 URL을 물을 때 아래 주소를 입력하세요.

```
https://docurise.io/api/mcp
```

그다음 열리는 DocuRise 페이지에서 연결을 승인하면 됩니다.

* 지금까지 확인한 앱: Claude, ChatGPT, Claude Code
* Cursor는 아직 지원하지 않습니다.

## 승인하는 내용

어떤 앱을 쓰든 연결은 DocuRise 승인 페이지 하나를 거칩니다. 이 페이지에는 내 계정, 연결을 요청한 앱, 접근 수준이 표시됩니다. 무엇을 골라야 할지 모르겠다면 미리 선택된 **읽기**를 그대로 두고 **승인**을 누르세요.

| 접근 수준 | 앱이 할 수 있는 일 |
| - | - |
| 읽기 | 읽기 전용 도구를 사용합니다. 기본으로 선택되어 있습니다. |
| 읽기 및 쓰기 | 계정에서 무언가를 만들거나 바꾸는 도구도 사용합니다. |

앱에는 접근 수준이 허용하는 도구만 보입니다.

이미 만든 연결의 접근 수준은 바꿀 수 없습니다. 읽기와 읽기 및 쓰기 사이를 바꾸려면 앱을 다시 연결하면서 다른 수준을 선택하세요.

## 도구

| 도구 | 접근 수준 | 기능 |
| - | - | - |
| `docurise_get_account` | 모두 | 이 연결의 접근 수준과 권한, 요금제가 MCP를 포함하는지 알려줍니다. 인증 정보는 절대 반환하지 않습니다. |
| `docurise_list_documents` | 읽기 | 문서를 최신순으로 보여 줍니다. 상태(공개 중, 초안, 비활성, 만료)로 걸러볼 수 있습니다. |
| `docurise_get_document` | 읽기 | 문서 하나의 상태, 만료일, 수정할 때 함께 보내야 하는 버전, 비밀번호 보호·이메일 입력 요구·허용 목록 설정 여부를 보여 줍니다. 비밀번호와 허용된 열람자 목록은 반환하지 않습니다. |
| `docurise_get_document_analytics` | 읽기 | 문서 하나 또는 계정 전체의 조회수·고유 방문자·리드, 일별·주별 추이, 유입 경로별 비교, 폼 퍼널, 또는 상위 문서를 보여 줍니다. 계정 전체 보기의 고유 방문자와 리드는 문서별 수치를 더한 값이라 계정 전체에서 중복 없는 수치가 아니에요. |
| `docurise_list_library` | 읽기 | 폴더, 태그, 그룹, 상품 목록과 자동화에 쓸 수 있는 승인된 카카오 메시지 템플릿 목록을 보여 줍니다. |
| `docurise_list_email` | 읽기 | 이메일 1회성 발송과 자동화 목록, 또는 1회성 발송 하나의 발송·오픈·클릭·반송 합계를 보여 줍니다. 본문과 수신자는 반환하지 않습니다. |
| `docurise_list_instagram_rules` | 읽기 | 인스타그램 댓글 DM 규칙의 상태, 키워드, 일정, 발송 수와 각 DM이 보내는 링크를 보여 줍니다. 링크는 웹 주소(`?`나 `#` 뒤의 내용은 제외)와, 내 문서로 연결되면 그 문서의 제목과 상태를 함께 보여 줍니다. 메시지 문구와 버튼 문구는 반환하지 않습니다. |
| `docurise_list_group_conditions` | 읽기 | 그룹을 만들 때 쓸 수 있는 조건(예: "이 태그가 있음", "최근 30일 안에 이 문서를 봄", "이 상품을 구매함")과 조건마다 받는 옵션, 필요한 ID를 찾는 방법을 알려 줍니다. 모든 계정에 같은 내용이며 내 데이터는 읽지 않습니다. 어떤 연산자·ID 형태가 어느 목록에서 거부되는지도 알려 줍니다. 사용자 정의 필드 조건은 아직 사용할 수 없습니다. |
| `docurise_preview_group` | 읽기 | 그룹 조건에 해당하는 연락처가 몇 명인지 저장하지 않고 세어, 앱이 그룹을 만들기 전에 규모를 보여 줄 수 있게 합니다. 숫자만 돌려주며 이름, 이메일 등 연락처 정보는 반환하지 않습니다. |
| `docurise_check_connections` | 읽기 | 내 설정의 연결 상태를 점검합니다. 트리거 문서가 삭제된 활성 이메일 자동화, 삭제된 내 문서로 연결되는 인스타그램 DM 규칙, 폼이 이름을 받지 않는데 수신자 이름을 쓰는 이메일 자동화를 찾아 줍니다. ID와 이름만 알려주며 메시지 문구나 링크는 반환하지 않습니다. |
| `docurise_create_document` | 읽기 및 쓰기 | 이메일 수집 폼이나 포스트를 만들고 바로 공개합니다. 만들어지는 즉시 공개 상태가 되며, 앱은 공개 링크와 함께 대시보드에서 확인하고 수정하거나 끌 수 있는 링크를 돌려받습니다. 공개해도 되는 문서일 때만 만드세요. 게시된 문서 한도에 포함되며, 한도에 여유가 없으면 아무것도 만들어지지 않습니다. 폼은 마케팅 수신 동의 체크박스를 둘지 앱이 반드시 정해야 하며, 후속 자동화는 마케팅 수신에 동의한 연락처에게 이메일을 보내며, 이 폼에서는 체크박스를 선택하면 동의가 기록됩니다. 폼은 질문 위에 보이는 소개 글을 서식(굵게, 밑줄, 형광펜, 글자색, 제목 크기, 목록, 링크)과 함께 쓸 수도 있으며, 폼의 짧은 설명은 링크 미리보기에만 쓰이고 폼에는 보이지 않습니다. 포스트는 앱이 서식 있는 글(모든 계정에서 사용 가능) 또는 HTML(최대 200,000자, HTML 포스트를 쓸 수 있는 계정에서만)로 페이지를 보냅니다. 둘 다 저장할 때 정리되므로(스크립트, 폼, iframe 등은 제거) 공개된 페이지를 열어 확인하세요. 포스트는 따로 요청하지 않으면 누구나 열 수 있으며, 요청하면 앱이 이메일 입력 게이트(와 함께 이메일 인증, 업무용 이메일만 허용, 흐린 미리보기)를 켤 수 있습니다. 폼은 항상 이메일을 받습니다. 게이트는 포스트를 만들 때 설정하며, 나중에 바꾸려면 대시보드의 문서 설정을 이용하세요. 공개 링크는 인스타그램 DM 규칙의 버튼에 쓸 수 있습니다. 제출된 데이터와 포스트의 내용은 반환하지 않습니다. 같은 요청을 다시 보내도 문서가 두 개 만들어지지 않습니다. |
| `docurise_update_document` | 읽기 및 쓰기 | 내 폼이나 HTML 포스트의 내용을 수정하고 바로 저장합니다. 제목과 설명, 포스트의 HTML, 폼의 서식 있는 소개 글, 폼의 이름·회사·전화번호 항목과 마케팅 수신 동의 체크박스를 바꿀 수 있고, 폼에는 질문을 추가할 수 있습니다. 질문은 기존 질문 뒤에 추가만 할 수 있고(추가 질문은 모두 합쳐 최대 10개), 기존 질문의 문구 수정·순서 변경·삭제는 AI 앱이 할 수 없으므로 대시보드에서 직접 해야 합니다. 공개 중인 문서라면 방문자에게 변경 사항이 즉시 보입니다. 앱은 먼저 문서를 읽고 읽은 버전을 함께 보내야 하며, 그 사이 대시보드에서 저장한 내용이 있으면 덮어쓰지 않도록 수정이 거부됩니다. 문서에 자동화나 카카오 리드 알림톡이 설정돼 있거나(제목과 설명 변경은 계속 가능하지만 소개 글 변경은 불가능합니다), 폼이 결제를 받거나(항목, 질문, 마케팅 수신 동의 체크박스), 폼의 저장된 구성을 AI 앱이 안전하게 읽을 수 없거나, 포스트가 HTML이 아니라 에디터로 작성됐거나, 포스트에 동영상이 있는데 HTML을 바꾸려 하면(HTML을 바꾸면 동영상이 포스트에서 분리됩니다. 제목과 설명은 계속 바꿀 수 있습니다) 수정을 거부하고, 이유를 알려 준 뒤 대시보드에서 직접 수정하도록 안내합니다. 폼에 남은 자리보다 많은 질문을 추가하려 할 때도 거부합니다. 포스트의 HTML과 폼의 질문은 반환하지 않습니다. |
| `docurise_create_automation_draft` | 읽기 및 쓰기 | 내 폼 하나에 대한 후속 메시지를 만듭니다. 누군가 폼을 제출하면, 정해 둔 대기 시간 뒤에 앱이 쓴 이메일이 발송되거나, 승인된 템플릿으로 만든 카카오 알림톡이 발송됩니다(알림톡은 앱이 승인된 템플릿 목록을 보여 주면 내가 쓸 템플릿을 고르며, 앱이 대신 고르지 않습니다). 항상 초안이며 스스로 켜지지 않습니다. 반환된 링크를 열어 메시지를 확인하고 대시보드에서 직접 켜기 전에는 아무것도 발송되지 않습니다. 앱은 링크와 순서를 안내하고, 켜면 어떻게 되는지 설명해야 합니다. 대시보드에서 만든 폼이 아직 초안이면 먼저 공개하고, 꺼져 있으면 먼저 켜야 방문자가 제출할 수 있습니다. 마케팅 수신에 동의한 연락처에게만 보내며(폼의 동의 체크박스를 체크하면 동의가 기록됩니다), 이 체크박스가 없는 폼에서 들어온 새 연락처에게는 가지 않습니다. 앱이 이를 알려 주도록 되어 있습니다. 앱은 자동화마다 이를 직접 정합니다. 확인 메시지나 사용자가 요청한 자료 전달 같은 거래성(트랜잭션) 메시지는 '마케팅 수신 동의 필수'를 끈 채로 만들어지고, 그러면 폼을 제출한 모든 사람에게 보냅니다(수신거부한 연락처, 주소가 반송된 연락처, 카카오 수신 거부자에게는 여전히 보내지 않습니다). 앱은 이를 알려야 하고, 홍보 메시지에는 절대 쓰지 않도록 되어 있습니다. 카카오 메시지는 전화번호로 가므로 폼에 전화번호 입력란이 있어야 하며, 없으면 앱이 알려 주도록 되어 있습니다. 카카오 자동화를 켜려면 카카오 크레딧이 필요하고, 초안을 만드는 데는 비용이 들지 않습니다. 제출된 데이터, 수신자, 카카오 메시지 본문은 반환하지 않습니다. 같은 요청을 다시 보내도 자동화가 두 개 만들어지지 않습니다. 켜지 않은 자동화는 계정당 최대 50개까지 둘 수 있습니다. [확인하고 켜는 방법](https://docurise.io/docs/ko/mcp-review-and-activate.md). |
| `docurise_create_group` | 읽기 및 쓰기 | 그룹을 만듭니다. 그룹은 조건으로 정해지는 이름 있는 연락처 목록으로, 예를 들어 "vip" 태그가 있고 최근 30일 안에 문서를 본 사람입니다. 연락처가 바뀌면 그룹도 자동으로 갱신됩니다. 만들어도 누구에게도 아무것도 보내지 않고 연락처도 바꾸지 않으며, 나중에 대시보드에서 이메일이나 자동화의 대상으로 쓰면 됩니다. 태그, 문서, 폴더, 상품, 다른 그룹을 쓰는 조건은 내 것이어야 하며, 잘못된 조건은 이유와 함께 거부됩니다. 일부 조건 형태는 연락처를 조용히 빠뜨리게 되므로 거부됩니다. 제외 목록의 위치·반송 상태 `is`, 상품·폼 범위의 구매 조건이 해당하며, 거부 메시지가 대신 쓸 방법을 알려 줍니다. 매우 무거운 규칙은 앱이 인원을 세는 동안 약 10초 뒤에 시간 초과될 수 있으며, 앱은 규칙을 단순하게 만들거나 다시 시도하도록 안내받습니다. 같은 요청을 반복해도 그룹이 두 개 만들어지지 않습니다. 그룹 페이지 링크를 돌려줍니다. 이 방법으로는 계정당 최대 100개까지 만들 수 있고, 그룹을 수정하거나 삭제할 수는 없습니다. |
| `docurise_create_instagram_rule` | 읽기 및 쓰기 | 다음 게시물용 인스타그램 댓글 DM 규칙을 만듭니다. 규칙은 항상 일시중지 상태로 만들어지며, 대시보드에서 직접 켜기 전에는 아무것도 발송되지 않습니다. 댓글 답글을 켜 둘 때는 서로 다른 답글이 3개 이상 필요합니다(답글을 꺼 둘 수도 있습니다). 규칙으로 가는 링크만 알려 주고 메시지 문구는 반환하지 않습니다. 같은 요청을 다시 보내도 규칙이 두 개 만들어지지 않습니다. |
| `docurise_update_instagram_rule` | 읽기 및 쓰기 | 다음 게시물 규칙을 일시중지합니다. 일시중지만 할 수 있어서 규칙을 켜거나 메시지를 바꿀 수는 없습니다. 이미 일시중지된 규칙을 다시 일시중지해도 괜찮습니다. |
| `docurise_create_tag` | 읽기 및 쓰기 | 이름으로 태그 하나를 만듭니다(예: `webinar-oct`). 태그는 나중에 연락처에 붙이고 그룹과 자동화에서 쓰는 라벨이며, 만든다고 아무것도 발송되거나 그룹이 바뀌지 않습니다. 같은 이름(대소문자와 앞뒤 공백은 무시)의 태그가 이미 있으면 새로 만들지 않고 기존 태그를 돌려줍니다. 연락처에 태그를 붙이지는 않습니다. |

직접 또는 방문자가 쓴 텍스트(제목, 이름, 키워드)는 지시가 아니라 데이터로만 전달됩니다.
읽기 도구는 읽기만 합니다. 읽기 및 쓰기 접근이 필요한 도구는 계정에 무언가를 만들고, 확인할 수 있는 대시보드 링크를 알려 줍니다. 인스타그램 규칙과 이메일·카카오 자동화는 멈춘 상태로 만들어지며 직접 켜기 전에는 아무것도 보내지 않습니다. 공개하는 도구는 폼이나 포스트를 만들자마자 공개하는 `docurise_create_document` 하나뿐입니다. `docurise_update_document`는 이미 가지고 있는 폼이나 포스트를 수정하고 바로 저장하므로, 공개 중인 문서라면 방문자에게 변경 사항이 즉시 보입니다. 다만 공개 여부를 바꾸지는 않습니다. `docurise_create_group`은 연락처 그룹을 저장할 뿐이며, 그룹은 그 자체로는 아무것도 보내지 않습니다. 어떤 도구도 발송하거나 규칙·자동화를 켜지 않습니다. 도구는 앞으로 추가됩니다. 기존 도구 이름은 바뀌지 않습니다.

## 제한

계정당 분당 최대 60회, 하루 최대 5,000회까지 MCP 요청을 보낼 수 있습니다. 이 제한은 API 요청 제한과 별개라서, AI 앱과 API 키가 서로의 요청 횟수를 차지하지 않습니다. 제한을 넘은 요청은 `Retry-After` 헤더와 함께 `429`를 받습니다. 그 시간만큼 기다린 뒤 재시도하세요.

또한 한 계정이 동시에 실행 중인 MCP 요청은 최대 20개입니다. 일반적인 AI 앱은 이보다 훨씬 적게 쓰므로, 앱이 아주 많은 호출을 한꺼번에 보낼 때만 보게 됩니다. 초과한 요청은 `Retry-After: 1`과 함께 `429`를 받으며, 앱이 그만큼 기다린 뒤 다시 시도하면 됩니다. 거절된 요청도 위의 분당·일일 제한에 포함됩니다.

## 연결 해제하기

대시보드의 **설정 → 개발자**를 여세요. 연결된 AI 앱 목록에 승인별로 접근 수준, 생성일, 마지막 사용일이 표시됩니다. 연결에서 **삭제**를 선택하면 앱의 다음 요청부터 작동하지 않으며, 앱이 다시 로그인을 요청해야 합니다.

새 앱이 연결될 때마다 이메일도 받습니다. 직접 시작한 연결이 아니라면 바로 해제하세요.

## 문제 해결

* **앱이 연결되지 않거나 로그인 후 오류가 납니다.** URL을 경로 추가 없이 그대로 복사했는지, 내 계정과 요금제에서 MCP를 사용할 수 있는지 확인하세요.
* **도구가 보이지 않습니다.** 읽기 전용으로 승인했을 수 있습니다. 다시 연결하면서 읽기 및 쓰기를 선택하세요. Claude에서는 **도구 권한**에서 해당 도구가 차단으로 설정되어 있지 않은지도 확인하세요.
* **Claude가 도구를 쓸 때마다 먼저 물어봅니다.** Claude의 도구 권한에서 "승인 필요"로 설정되어 있기 때문입니다. 더 이상 묻지 않길 원하면 해당 도구를 항상 허용으로 바꾸세요.
* **갑자기 작동하지 않습니다.** 연결이 해제되었거나 만료되었거나, 요금제가 더 이상 MCP를 포함하지 않을 수 있습니다. 앱에서 다시 연결하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.