> For the complete documentation index, see [llms.txt](https://docs.riido.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.riido.io/ai/mcp.md).

# MCP 서버

<figure><img src="/files/UmvIXORXrDt1Nx9TcRE2" alt=""><figcaption></figcaption></figure>

## 개요

AI 툴(Claude, Cursor 등)은 이미 개발 및 기획 과정에서 필수 도구가 되었지만, 지금까지는 AI 작업 환경과 프로젝트 관리 툴이 단절되어 있었습니다. 이로 인해 AI가 분석한 결과를 뤼이도에 적용하거나 그 반대 역시 반복적인 수작업이 필요했습니다.

뤼이도 MCP(Model Context Protocol) 서버는 이 단절을 완전히 해소합니다. AI가 직접 뤼이도 워크스페이스에 연결되어 데이터 조회, 작업 생성, 문서 업데이트까지 처리할 수 있습니다.

## 설치 가이드

<details>

<summary><strong>Claude Desktop</strong></summary>

1. Claude 좌측 사이드바에서 `Customize` 메뉴 클릭
2. `커스텀 커넥터 추가` 버튼 클릭

<figure><img src="/files/wO6vFSBl3lpga00FO571" alt=""><figcaption></figcaption></figure>

3. 원격 MCP 서버 URL에 아래 주소 붙여넣기

```
https://mcp.riido.io/mcp
```

<figure><img src="/files/k2dkYXk0MBFuoBM6G8yj" alt=""><figcaption></figcaption></figure>

4. 연결 버튼 클릭 후 뤼이도에서 권한 요청 승인
5. 뤼이도 커넥터가 정상적으로 추가되었는지 확인

<figure><img src="/files/zoNWpPnTkOtppDBQScv7" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>ChatGPT</strong></summary>

{% hint style="info" %}
ChatGPT Pro 요금제 이상부터 사용 가능합니다.
{% endhint %}

1. 설정 > 연동 및 앱 커넥터 페이지 > 고급 설정으로 이동

<figure><img src="/files/rqVBxPX3zjBun5Vnx0RG" alt=""><figcaption></figcaption></figure>

2. 개발자 모드 활성화

<figure><img src="/files/aDY6ozclVLFzdgPnoRW8" alt=""><figcaption></figcaption></figure>

3. 연동 및 앱 커넥터 페이지에서 \[앱 만들기] 선택

<figure><img src="/files/K9x9uRG4aDIL8L8QyyYI" alt=""><figcaption></figcaption></figure>

4. 앱 정보 입력 후 \[만들기] 클릭

```
· MCP 서버 URL: https://mcp.riido.io/mcp
· 인증: OAuth
```

<figure><img src="/files/PZeAe4qPBLWrIXrxVU8U" alt=""><figcaption></figcaption></figure>

5. 연동 및 앱 커넥터 페이지에서 Riido MCP 연결 확인

<figure><img src="/files/ECzW7UH3BkjOiIAEnrPm" alt=""><figcaption></figcaption></figure>

6. \[+] 버튼을 클릭하여 Riido MCP 사용

<figure><img src="/files/Kko8D2xPVKqKRvRovHDe" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Cursor</strong></summary>

1. `CMD 또는 Ctrl` + `Shift` + `p` > MCP Settings 클릭

<figure><img src="/files/nljCW3YdUoWe8mbMMUle" alt=""><figcaption></figcaption></figure>

2. Installed MCP Servers 섹션에서 \[Add Custom MCP] 버튼 클릭

<figure><img src="/files/Zukj0kGTSQrT77Fjbr6y" alt=""><figcaption></figcaption></figure>

3. 다음 내용 붙여넣기

```json
{
  "mcpServers": {
    "Riido": {
      "url": "https://mcp.riido.io/mcp"
    }
  }
}
```

4. Riido MCP 인증 진행

<figure><img src="/files/0BvcD2umdpvmGb0DRzek" alt=""><figcaption></figcaption></figure>

5. Riido가 정상적으로 추가되었는지 확인

<figure><img src="/files/5oCD3qvh0aa5aEBqSsNM" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Visual Studio Code</strong></summary>

1. `CMD 또는 Ctrl` + `Shift` + `p` > MCP: Add Server… 클릭

<figure><img src="/files/G88vJfj86lm5Jj4zIccB" alt=""><figcaption></figcaption></figure>

2. Command (stdio) 클릭

<figure><img src="/files/7bwho9Izi7ivvLWisZzb" alt=""><figcaption></figcaption></figure>

3. 다음 내용 붙여넣기 후 `Enter`

```bash
npx mcp-remote https://mcp.riido.io/mcp
```

<figure><img src="/files/katQfztwu5aBou1aAfrL" alt=""><figcaption></figcaption></figure>

4. 서버 ID 입력 창에 `Riido` 입력 후 `Enter`

<figure><img src="/files/Z7QMK0kKKZtrQQvPpd98" alt=""><figcaption></figcaption></figure>

5. 서버 등록 완료 후, `CMD 또는 Ctrl` + `Shift` + `p` > MCP: List Servers 클릭

<figure><img src="/files/t5MFwBNJLto9YIo9rRoA" alt=""><figcaption></figcaption></figure>

6. Riido MCP Server가 Running(동작 중) 상태로 표시되는 것을 확인

<figure><img src="/files/UAoCmkCOVAqAkrtInXvh" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Claude Code</strong></summary>

1. [Claude Code](https://claude.com/product/claude-code) 설치
2. 터미널에서 Riido MCP 추가

```bash
$ claude mcp add --transport http riido https://mcp.riido.io/mcp
```

3. Claude Code 실행 후 MCP 목록 확인

```bash
$ claude
$ /mcp
```

<figure><img src="/files/opfw5FSw6xiw5E1WJyja" alt=""><figcaption></figcaption></figure>

4. \[Authenticate] 선택

<figure><img src="/files/RUnsvK5g4xOl3lzcRVaV" alt=""><figcaption></figcaption></figure>

5. 브라우저를 통해 Riido MCP 권한 부여

<figure><img src="/files/cym2huiVgsSGl70FdW7o" alt=""><figcaption></figcaption></figure>

6. MCP 목록에서 Riido MCP 정상 연결 확인

<figure><img src="/files/mQWmbqTEwl9z6Fke2OaX" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Gemini CLI</strong></summary>

1. [Gemini CLI](https://geminicli.com/) 설치
2. `~/.gemini/settings.json` 파일 내에 다음 내용 붙여넣기

```json
{
  "mcpServers": {
    "Riido": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.riido.io/mcp"
      ]
    }
  }
}
```

3. Gemini 실행 후, 브라우저를 통해 Riido MCP 권한 부여

<figure><img src="/files/i9EdJeQNwxu2vJd4Erjg" alt=""><figcaption></figcaption></figure>

4. MCP 목록 확인

```bash
$ /mcp
```

5. Riido MCP 정상 연결 확인

<figure><img src="/files/6P89NvFSyGj848LEo62Z" alt=""><figcaption></figcaption></figure>

</details>

## MCP 사용 사례

#### 1️⃣ 워크스페이스 · 팀 · 작업 데이터, 실시간 조회

AI가 내 뤼이도 계정에 연결되어, 워크스페이스와 팀 구성은 물론 모든 작업 목록까지 실시간으로 불러올 수 있습니다. 더 이상 복사+붙여넣기로 데이터를 옮길 필요가 없습니다. 이제 AI가 직접 데이터를 조회하고 분석해, 더 깊은 인사이트를 제공합니다.

<figure><img src="/files/K4YRPrpaLhF9Qo5L4voC" alt=""><figcaption></figcaption></figure>

#### 2️⃣ **프로젝트 현황, AI로 한눈에**

AI가 팀의 프로젝트 현황을 실시간으로 분석해, 진행률과 핵심 지표를 한눈에 보여줘요.

“이번 프로젝트의 진행 상황은 어때?” 한마디면 충분합니다. 요약 보고서는 물론, 병목 지점과 잠재 리스크까지 AI가 자동으로 짚어드립니다.

<figure><img src="/files/eWDcfQ9A23m6TUXCLCS8" alt=""><figcaption></figcaption></figure>

#### 3️⃣ **기획에서 코드로**

이제 개발자는 뤼이도에 있는 기획서를 곧바로 바이브 코딩에 활용할 수 있습니다. “REST API 개발 요구사항대로 코드를 구현해 줘”라고 말하면, Cursor가 뤼이도 작업 기획안을 분석해 즉시 코드로 구현합니다. 문서를 찾아 헤매거나 툴을 전환할 필요 없이, 오직 개발에만 집중할 수 있습니다.

<figure><img src="/files/R3BjehyimPhQUgRJqPqt" alt=""><figcaption></figcaption></figure>

#### 4️⃣ **아이디어만 말하면 작업이 생성됩니다.**

AI는 프로젝트 맥락을 이해하여 설명만으로도 온전한 작업을 만들어냅니다. 아이디어가 떠올랐다면 한 문장으로 표현해 주세요. 제목, 상세 설명, 라벨, 마감 기한까지 모든 필드를 자동으로 채워, 사용자의 부담을 덜어드립니다.

<figure><img src="/files/Jhi8gRYGKSUnaxMLl4M2" alt=""><figcaption></figcaption></figure>

#### 5️⃣ **문서 작성까지, AI가 대신합니다.**

개발자는 더 이상 작업 결과물을 정리하느라 시간을 쓸 필요 없습니다. Cursor에서 새로운 기능을 완성했을 때, “방금 구현한 로그인 기능을 뤼이도 작업에 요약해서 팀과 공유해 줘”라고 말해보세요. AI가 코드를 분석해, 팀원들이 이해하기 쉬운 형태로 뤼이도 작업 페이지에 자동으로 정리해 줘요.

<figure><img src="/files/aHJqfsYSVrHPS9NNFOl1" alt=""><figcaption></figcaption></figure>