# AI 도구 연결하기 (MCP)

> ChatGPT, Claude, Cursor 같은 AI 도구에 매니패스트를 연결해 그 도구에서 기획서를 읽고 쓰게 해요.

MCP는 AI 도구가 다른 서비스와 연결되는 표준 방식이에요. 매니패스트를 연결하면 내가 쓰던 AI에서 매니패스트 기획서를 읽고 쓸 수 있어요. AI와 나눈 기획 대화나 개발 도구의 코드 맥락을 그대로 기획서로 이어 갈 수 있어요.

## 연결하면 할 수 있는 일

- **기획서 읽기**: 프로젝트 목록, PRD, 기능명세서, 유저플로우, 와이어프레임, 코멘트를 읽어요.
- **기획서 쓰기**: PRD, 요구사항, 기능, 상세 기능, 프로덕트 정책을 쓰고 고치고, 와이어프레임 요소를 직접 고쳐요. 이렇게 직접 고칠 때는 크레딧을 쓰지 않아요.
- **AI 실행**: 매니패스트 AI 채팅을 돌리고, 유저플로우와 와이어프레임을 생성해요. 웹에서 쓸 때와 같은 규칙으로 그룹 [크레딧](https://manyfast.io/docs/account/credits)을 써요.
- **프로젝트 다루기**: 프로젝트를 만들고 이름을 바꾸고 복제하고, 휴지통으로 보내거나 복원하고, 버전을 저장해요. 권한이 있으면 소유자도 바꿔요. 폴더, 자료실 기록, 프로젝트 자료도 다뤄요.

연결한 AI에게 이렇게 요청해 보세요.

- "방금까지 나눈 아이디어 정리해서 Manyfast에 PRD와 핵심 요구사항을 정리해줘"
- "Manyfast 기획서의 기능명세와 유저플로우를 읽어서 이 화면부터 바로 구현 시작해줘"
- "Manyfast에서 내 기획서 읽고 개발 계획 세워줘"

AI 도구가 쓴 요구사항, 기능, 상세 기능, 프로덕트 정책과 이미 있던 PRD를 고친 내용은 바로 확정되지 않고 승인을 기다리는 AI 제안으로 들어와요. 매니패스트에서 확인하고 승인해요. 방법은 [AI 제안 검토하기](https://manyfast.io/docs/ai/suggestions)에 있어요.

> [!IMPORTANT]
> - AI 도구로 직접 쓸 수 있는 범위는 프로젝트가 속한 그룹의 요금제에 따라 달라요. [요금제 비교](https://manyfast.io/docs/account/plans#planning)를 참고해요.
> - 그룹에서 뷰어 역할이면 AI 도구로도 읽기만 할 수 있어요. 자료실 기록에 코멘트를 남기는 것만 예외예요. [역할과 권한](https://manyfast.io/docs/team/roles)을 참고해요.

## 커넥터 화면 열기

연결 방법은 커넥터 화면에 도구별로 정리돼 있어요. 아래 어디서든 열 수 있어요.

- 사이드바의 **커넥터**
- 홈 인사말 위의 **내 AI 도구 연결하기**
- 에디터 왼쪽 레일의 **커넥터** (에디터 안에 패널로 열려요)

1. 사이드바에서 **커넥터**를 눌러요.
2. 위쪽 탭(**전체**, **AI**, **개발**, **프로젝트 관리**)으로 목록을 좁혀요.
3. 연결할 도구를 고르면 오른쪽에 **연결 방법**이 나와요.
4. 단계를 따라 해요. 붙여 넣을 주소, 명령어, 프롬프트는 옆의 **복사**를 눌러 복사해요. **바로가기**를 누르면 그 도구가 열려요.

![커넥터 화면의 전체 탭. 왼쪽에 AI 도구와 이슈 트래커 목록이, 오른쪽에 연결 안내가 보인다.](https://manyfast.io/content-assets/connectors.list-D_aAkfox.webp)

## 공통 연결 정보

어느 도구든 아래 정보로 연결해요.

| 항목 | 값 |
|---|---|
| 서버 주소 | `https://api.manyfast.io/mcp` |
| 연결 이름 | `manyfast` (이름 칸이 있는 양식에는 `Manyfast`) |
| 인증 방식 | OAuth (매니패스트 계정으로 로그인) |

![커넥터 화면에서 Claude를 고른 모습. 연결 방법 단계와 서버 주소 복사 칸이 보인다.](https://manyfast.io/content-assets/connectors.detail-JOUU83fU.webp)

## 로그인하고 연결 승인하기

어느 도구든 마지막에는 매니패스트 로그인과 승인을 거쳐요.

1. AI 도구에서 연결을 시작하면 브라우저에 **MCP 인증** 창이 열려요.
2. **Google로 계속**을 누르거나 이메일과 비밀번호를 넣고 **이메일 로그인**을 눌러요. 이미 로그인돼 있으면 **이 계정으로 계속**을 누르고, 다른 계정을 쓰려면 **다른 계정으로 로그인**을 눌러요.
3. **MCP 연결 승인** 화면에서 **클라이언트:** 옆의 이름이 지금 연결하는 도구와 같은지 확인해요. 콜백 주소와 권한도 함께 보여요.
4. **이 계정으로 연결**을 눌러요. AI 도구로 돌아가면 연결이 끝나요. 연결하지 않으려면 **연결 거부**를 눌러요.

> [!IMPORTANT]
> 승인하면 그 AI 도구는 이 계정으로 들어갈 수 있는 모든 프로젝트를 읽고 쓸 수 있어요. 이 권한에는 그룹 크레딧을 쓰는 AI 실행과 되돌릴 수 없는 삭제(프로젝트 자료, 자료실 기록 등)도 들어가요. 이 화면의 클라이언트 이름과 콜백 주소는 AI 도구가 보낸 정보라 매니패스트가 검증하지 않아요. 모르는 도구라면 승인하지 마세요.

## 도구별 연결 방법

각 도구의 메뉴 이름은 그 도구가 화면을 바꾸면 달라질 수 있어요. 커넥터 화면의 안내가 가장 최신이에요.

### ChatGPT

1. ChatGPT 왼쪽 메뉴에서 **플러그인**에 들어가 검색창 옆 **+**를 눌러요. **+**가 보이지 않으면 **설정** > **플러그인** 맨 아래에서 **개발자 모드**를 켜요.
2. 이름은 `Manyfast`, 인증은 **OAuth**로 고르고 서버 URL에 서버 주소를 넣어요.
3. **Manyfast 계정으로 로그인**을 누르고 [로그인과 승인](https://manyfast.io/docs/connect/mcp#approve)을 마쳐요.

> [!NOTE]
> ChatGPT 요금제에 따라 연결이 제한될 수 있어요.

### Claude

1. Claude 왼쪽 사이드바에서 **사용자 지정**을 골라요.
2. **커넥터**를 고르고 오른쪽 위 **추가** > **커스텀 커넥터 추가**를 눌러요.
3. 이름은 `Manyfast`, 서버 URL에는 서버 주소를 붙여 넣고 **추가**를 눌러요.
4. **연결**을 누르고 [로그인과 승인](https://manyfast.io/docs/connect/mcp#approve)을 마쳐요.

### Codex

1. 커넥터 화면 Codex 안내의 프롬프트를 **복사**해 Codex 채팅에 붙여 넣고 실행해요. 이 프롬프트는 `manyfast` 서버를 스트리밍 가능한 HTTP 방식으로 전역 설정(`~/.codex/config.toml`)에 등록하고, `codex mcp login manyfast`로 OAuth 인증까지 진행하도록 Codex에게 요청해요.
2. 브라우저가 열리면 [로그인과 승인](https://manyfast.io/docs/connect/mcp#approve)을 마쳐요.
3. Codex를 다시 실행하면 연결이 끝나요.

### Claude Code

1. 터미널에 아래 명령어를 붙여 넣어 실행해요. `--scope user`를 붙이면 어느 폴더에서 Claude Code를 열어도 연결돼요.

   ```bash
   claude mcp add --transport http manyfast https://api.manyfast.io/mcp --scope user
   ```

2. `claude`를 실행하고 채팅창에 `/mcp`를 입력해 manyfast를 골라요.
3. **Authenticate**를 고르고 [로그인과 승인](https://manyfast.io/docs/connect/mcp#approve)을 마쳐요.

### Antigravity

1. 커넥터 화면 Antigravity 안내의 프롬프트를 **복사**해 Antigravity 채팅에 붙여 넣고 실행해요. 이 프롬프트는 아래 설정을 `~/.gemini/config/mcp_config.json`과 `~/.gemini/antigravity/mcp_config.json` 두 파일에 등록하도록 요청해요. 직접 고칠 수 없는 파일은 에디터로 열어 달라는 내용도 들어 있어요. 파일이 열리면 아래 설정을 직접 붙여 넣어요.

   ```json
   {
     "mcpServers": {
       "manyfast": {
         "serverUrl": "https://api.manyfast.io/mcp"
       }
     }
   }
   ```

2. **Settings** > **Customizations** > **Installed MCP Servers**에서 **Refresh**를 눌러요.
3. 목록에 생긴 manyfast 옆 **Authenticate**를 누르고 [로그인과 승인](https://manyfast.io/docs/connect/mcp#approve)을 마쳐요.

### Cursor

1. 커넥터 화면 Cursor 안내의 프롬프트를 **복사**해 Cursor 채팅에 붙여 넣고 실행해요. 이 프롬프트는 `manyfast` 서버를 전역 사용자 설정(`~/.cursor/mcp.json`)의 `mcpServers`에 원격 HTTP MCP로 등록하도록 요청해요.
2. **Cursor Settings** > **Tools & MCPs** > **Installed MCP Servers** 목록에서 manyfast를 확인해요.
3. manyfast 옆 **Connect**를 누르고 [로그인과 승인](https://manyfast.io/docs/connect/mcp#approve)을 마쳐요.

> [!TIP]
> Cursor가 설치돼 있으면 커넥터 화면 Cursor 안내의 **바로가기**를 눌러 manyfast 서버를 추가하는 Cursor 화면을 바로 열 수 있어요.

### Lovable

1. Lovable 왼쪽 사이드바 **Connectors**에서 **Custom**을 골라요.
2. 이름은 `Manyfast`, 서버 URL에는 서버 주소를 붙여 넣어요.
3. **Add & authorize**를 누르고 [로그인과 승인](https://manyfast.io/docs/connect/mcp#approve)을 마쳐요.

### 기타 MCP 도구

목록에 없는 도구도 원격 MCP 서버 연결과 OAuth 인증을 지원하면 연결할 수 있어요. 그 도구의 MCP 서버 추가 화면에 서버 주소 `https://api.manyfast.io/mcp`를 넣고, 이름을 묻는다면 `manyfast`로 적어요. 로그인 창이 열리면 [로그인과 승인](https://manyfast.io/docs/connect/mcp#approve)을 마쳐요.

## 연결이 안 될 때

- **AI 도구에 저장된 매니패스트 연결 정보가 만료됐거나 더 이상 쓸 수 없어요.**가 보이면 창을 닫고, 쓰는 AI 도구에서 매니패스트 연결의 로그인 정보를 지운 뒤 다시 연결해요.
- Claude Code라면 터미널에서 아래 명령을 실행한 뒤 다시 연결해요. 다른 이름으로 추가했다면 `manyfast` 대신 그 이름을 넣어요.

  ```bash
  claude mcp logout manyfast
  ```

- **유효하지 않은 인증 요청입니다.**가 보이면 창을 닫고 AI 도구에서 연결을 처음부터 다시 시작해요.
- **연결을 거부했어요**가 보이면 승인하지 않은 거예요. 준비되면 AI 도구에서 새로 연결해요.
- 연결은 됐는데 요구사항이나 기능이 써지지 않으면 프로젝트가 속한 그룹의 요금제([요금제 비교](https://manyfast.io/docs/account/plans#planning))와 내 역할을 확인해요. 뷰어는 읽기만 할 수 있어요.

## 다음 단계

- [연결한 AI로 기획서 만들기](https://manyfast.io/docs/connect/build-from-ai)
- [이슈 트래커 연결하기](https://manyfast.io/docs/connect/issue-trackers)
- [AI 제안 검토하기](https://manyfast.io/docs/ai/suggestions)
- [요금제 비교](https://manyfast.io/docs/account/plans)

원문: https://manyfast.io/docs/connect/mcp
