> For the complete documentation index, see [llms.txt](https://docs.manyfast.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.manyfast.io/use/mcp.md).
# MCP 연결하기
**와 기능명세서 등 기획 데이터를 직접 조회하고 활용**할 수 있습니다.
외부 AI는 연결된 기획 문서를 작업의 컨텍스트로 참고하며, 사용 중인 플랜과 권한에 따라 매니패스트의 기획 내용을 \
수정할 수도 있습니다.
> Jira·GitHub·Linear 연결은 MCP가 아닌 **이슈 트래커 연동 기능**입니다.
## 1. MCP를 통해 할 수 있는 일
#### 최신 기획 내용을 컨텍스트로 사용하기
외부 AI가 매니패스트에 작성된 **PRD와 기능명세서 등의 기획 데이터**를 직접 조회할 수 있습니다.
문서를 복사하여 다시 전달하지 않아도, 외부 AI가 연결된 그룹의 현재 기획 내용을 확인하고 질문에 답하거나 작업 계획을 세울 수 있습니다.
MCP 연결은 매니패스트 데이터를 AI 모델에 영구적으로 학습시키는 기능이 아닙니다. 외부 AI가 작업할 때 필요한 내용을 **현재 컨텍스트로 조회하여 활용**하는 방식입니다.
#### 기획을 바탕으로 개발 작업하기
Cursor, Claude Code, Codex 같은 개발 도구에서 기획 문서를 참고하여 다음과 같은 작업을 진행할 수 있습니다.
* PRD의 제품 목표와 요구사항 요약
* 기능명세서를 기반으로 구현 범위 정리
* 필요한 화면과 기능 목록 확인
* 개발 작업 순서와 구현 계획 작성
* 기획 정책을 반영한 코드 생성 및 수정
* 기획과 구현 결과의 누락 여부 검토
코드 생성과 수정은 연결한 외부 AI 도구에서 수행합니다. 매니패스트 MCP는 해당 도구가 참고할 수 있는 \
**기획 데이터와 작업 기능을 제공**합니다.
#### 외부 AI에서 기획 문서 수정하기
사용 중인 플랜과 계정 권한, MCP에서 제공되는 기능에 따라 외부 AI에서 매니패스트의 기획 내용을 수정할 수 있습니다.
수정 기능을 사용할 때는 AI가 변경하려는 대상과 내용을 먼저 확인하고, 외부 도구에 승인 단계가 표시되는 경우 내용을 검토한 후 진행하세요.
기획서의 변경 사항은 외부 AI가 작업을 실행한 시점에 매니패스트에 반영됩니다.
#### **MCP 지원 범위**
매니패스트 MCP에서 지원하는 구체적인 작업 범위는 다음과 같습니다.
#### **프로젝트 관리**
* **그룹 목록 조회:** 로그인한 사용자가 속한 그룹 목록을 읽습니다.
* **프로젝트 목록 조회:** 선택한 그룹의 프로젝트 목록을 읽습니다.
* **프로젝트 생성:** 선택한 그룹에 새 프로젝트를 만듭니다.
* **프로젝트 정보 수정:** 프로젝트의 제목과 설명을 수정합니다.
* **휴지통 관리:** 프로젝트를 휴지통으로 이동하거나 복원합니다.
* **프로젝트 소유자 변경:** 같은 그룹의 멤버에게 프로젝트 소유권을 변경합니다.
#### **프로젝트 읽기와 쓰기**
* **기획 문서 조회:** PRD, 기능명세서, 유저플로우, 와이어프레임을 읽습니다.
* **PRD 작성:** PRD 내용을 생성하거나 수정합니다.
* **기능명세서 작성:** 기능명세서 내용을 생성하거나 수정합니다.
* **기능 상태 수정:** 기능명세서의 진행 상태와 중요도를 수정합니다.
* **삭제 항목 표시:** 삭제할 기획 항목을 표시합니다.
* **버전 목록 조회:** 프로젝트에 저장된 버전 목록을 확인합니다.
* **버전 저장:** 현재 기획 상태를 새 버전으로 저장합니다.
* **버전 복원:** 저장된 버전으로 기획 내용을 복원합니다.
* **작업 로그 조회:** 프로젝트의 작업 로그를 확인합니다.
**유저플로우와 와이어프레임은 MCP에서 조회만 가능합니다.**
#### **기타 설정**
* **커스터마이징 설정 조회:** 매니(AI) 커스터마이징 설정을 읽습니다.
* **커스터마이징 수정 제안:** 설정 변경안을 제안하며, 실제 반영은 매니패스트 에디터에서 사용자가 승인해야 합니다.
## 2. 연결 전 확인하기
#### 지원하는 외부 도구
매니패스트 MCP는 다음과 같은 MCP 호환 도구에 연결할 수 있습니다.
* Cursor
* Claude Code
* ChatGPT
* Codex
* Lovable
* Antigravity
각 서비스의 MCP 지원 여부와 설정 화면은 서비스 업데이트에 따라 달라질 수 있습니다.
#### 플랜별 이용 범위
현재 플랜 정책에 따라 사용할 수 있는 MCP 기능의 범위가 다릅니다.
* **Starter:** MCP를 통한 PRD 작업
* **Pro 이상:** MCP 전체 기능
연결한 계정이 속한 그룹의 플랜과 권한을 기준으로 사용할 수 있는 기능이 결정됩니다.
#### MCP 서버 URL
외부 도구에 매니패스트 MCP를 직접 등록할 때는 다음 주소를 사용합니다.
`https://api.manyfast.io/mcp`
## 3. 연결하는 방법
매니패스트 MCP는 Cursor, Claude Code, Chat-gpt, Codex, Lovable, Antigravity에서 사용할 수 있습니다.\
각 환경별 설정 방법은 아래 내용을 참고하세요.
#### MCP 서버 추가하기
{% tabs %}
{% tab title="Cursor" %}
**Cursor 설정 방법**
[Cursor MCP 공식 문서](https://cursor.com/docs/mcp)
**1. Cursor에 매니패스트 MCP 등록하기**
Cursor 에이전트 채팅에 아래 요청을 붙여넣어 실행합니다. 에이전트가 파일 수정을 요청하면 변경 대상이 전역 설정 파일 `~/.cursor/mcp.json`인지 확인한 후 승인하세요.
```
Manyfast MCP를 이 에디터에 추가해줘. 서버 이름은 manyfast, URL은 https://api.manyfast.io/mcp 이야. 한 프로젝트가 아니라 전역(유저 설정, ~/.cursor/mcp.json)의 mcpServers에 remote HTTP MCP로 등록하고 저장해줘.
```
직접 등록하려면 전역 설정 파일 `~/.cursor/mcp.json`의 `mcpServers`에 다음 항목을 추가합니다. 다른 MCP 서버가 이미 있다면 기존 항목을 지우지 말고 `manyfast` 항목만 추가하세요.
```json
{
"mcpServers": {
"manyfast": {
"url": "https://api.manyfast.io/mcp"
}
}
}
```
**2. 설치 상태 확인하기**
Cursor의 **Customize > MCP** 또는 **Cursor Settings > Tools & MCPs**에서 Installed MCP Servers 목록을 열고 `manyfast`가 표시되는지 확인합니다.
3. **3. 연결되지 않을 때 확인하기**
4. 연결되지 않을 때 확인하기
3\. 연결되지 않을 때 확인하기
* **목록에 manyfast가 보이지 않음:** `~/.cursor/mcp.json`의 파일 위치와 JSON 문법을 확인하고 MCP 목록을 새로고침하세요. 계속 보이지 않으면 Cursor를 다시 실행하세요.
* **Needs authentication이 계속 표시됨:** **Connect**를 다시 선택하고 브라우저의 로그인 및 연결 승인 절차를 완료하세요.
* **다른 계정이 표시됨:** 승인 화면에서 **다른 계정으로 로그인**을 선택하세요.
* **필요한 프로젝트가 보이지 않음:** 연결한 매니패스트 계정이 해당 프로젝트에 접근할 수 있는지 멤버 권한을 확인하세요.
OAuth 인증을 사용하므로 설정 파일에 비밀번호나 액세스 토큰을 직접 입력할 필요가 없습니다.
{% endtab %}
{% tab title="Claude Code" %}
#### **Claude Code 설정 방법**
[Claude Code MCP 공식 문서](https://code.claude.com/docs/en/mcp)
**1. 매니패스트 MCP 등록하기**
터미널에서 다음 명령어를 실행합니다. `--scope user`를 사용하면 설정이 `~/.claude.json`에 저장되어 다른 프로젝트에서도 사용할 수 있습니다.
```bash
claude mcp add --transport http --scope user manyfast https://api.manyfast.io/mcp
```
**2. 등록 상태 확인하기**
등록된 서버 목록과 매니패스트 설정을 확인합니다.
```bash
claude mcp list
claude mcp get manyfast
```
목록에 `manyfast`와 `https://api.manyfast.io/mcp`가 표시되면 등록이 완료된 것입니다.
**3. 연결되지 않을 때 확인하기**
* **목록에 manyfast가 보이지 않음:** `claude mcp list`와 `claude mcp get manyfast`로 등록 상태를 확인하고 등록 명령을 다시 실행하세요. 옵션은 서버 이름 `manyfast`보다 앞에 입력해야 합니다.
* **브라우저가 자동으로 열리지 않음:** Claude Code에 표시된 인증 URL을 복사해 브라우저에서 여세요.
* **인증 후 콜백 연결 오류가 표시됨:** 브라우저 주소창의 전체 콜백 URL을 복사해 Claude Code에 표시된 URL 입력란에 붙여넣으세요.
* **다른 계정이 표시됨:** 승인 화면에서 **다른 계정으로 로그인**을 선택하세요.
* **필요한 프로젝트가 보이지 않음:** 연결한 매니패스트 계정이 해당 프로젝트에 접근할 수 있는지 멤버 권한을 확인하세요.
`/mcp` 메뉴의 **Clear authentication**으로 저장된 인증을 해제할 수 있습니다. OAuth 인증 정보는 Claude Code가 안전하게 저장하고 갱신하므로 설정 파일에 비밀번호나 액세스 토큰을 직접 입력하지 마세요.
{% endtab %}
{% tab title="ChatGPT" %}
#### ChatGPT 설정 방법
{% hint style="info" %}
ChatGPT 웹에서 사용자 지정 MCP 플러그인(앱)을 연결하려면 개발자 모드를 사용할 수 있어야 합니다. 현재 OpenAI 안내 기준으로 Pro에서는 읽기·가져오기 기능을 제공하는 MCP를 연결할 수 있으며, 수정·쓰기 기능을 포함한 전체 MCP 지원은 Business와 Enterprise/Edu에서 제공됩니다. 실제 이용 범위는 계정 요금제와 워크스페이스 관리자 설정에 따라 달라질 수 있습니다.
{% endhint %}
* 프로필 메뉴에서 설정을 열고 보안 및 로그인 > 개발자 모드로 이동해 기능을 켭니다. 계정이나 워크스페이스에 따라 설정 > 앱 > 고급 설정에 표시될 수도 있으며, 관리형 워크스페이스에서는 관리자 권한이 필요할 수 있습니다.개발자 모드를 켠 뒤 왼쪽 메뉴의 플러그인 또는 설정 > 앱을 열고, 오른쪽 위의 + 버튼이나 만들기를 선택합니다.
[OpenAI ChatGPT MCP 공식 문서](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta)
**1. 연결 정보 입력하기**
* **이름:** Manyfast
* **설명:** 매니패스트의 PRD와 기능명세서 등 기획 데이터를 조회하고 활용합니다. (선택)
* **연결 방식:** 서버 URL
* **서버 URL:** `https://api.manyfast.io/mcp`
* **인증:** OAuth
고급 OAuth 설정에는 별도 안내가 없는 한 값을 직접 입력하지 않습니다. 매니패스트 비밀번호나 개인 토큰도 입력하지 마세요.
1. 사용자 지정 MCP 서버의 위험 안내를 읽고 계속 진행 항목을 확인합니다.
2. **도구 스캔**이 표시되면 실행하고 결과가 나타날 때까지 기다립니다. 화면에 **만들기**만 표시되면 입력값을 확인한 뒤 만들기를 선택합니다.
\
**2. ChatGPT에서 사용하기**
새 채팅을 열고 이번 메시지에 사용할 플러그인(앱)으로 **Manyfast**를 선택하거나 **@Manyfast**로 호출합니다.
플러그인 선택은 대화 전체가 아니라 해당 메시지에 적용될 수 있습니다. 후속 요청에서 최신 데이터를 다시 조회해야 한다면 Manyfast를 다시 선택하거나 @멘션하세요.
\
**3. 연결이 되지 않을 때**
* **개발자 모드가 보이지 않음:** ChatGPT 요금제, 관리자·소유자 역할, 워크스페이스 권한을 확인합니다.
* **플러그인을 만들 수 없음:** 개발자 모드와 서버 URL `https://api.manyfast.io/mcp`를 확인합니다.
* **도구 스캔 또는 로그인이 멈춤:** 팝업 차단을 해제한 뒤 플러그인 관리 화면에서 연결을 다시 시도합니다.
* **다른 계정으로 연결됨:** Manyfast 연결을 해제하고 올바른 매니패스트 계정으로 다시 인증합니다.
* **프로젝트가 보이지 않음:** 로그인 계정의 프로젝트 접근 권한과 그룹 플랜을 확인합니다.
* **수정 기능을 사용할 수 없음:** ChatGPT 계정에서 전체 MCP의 쓰기·수정 기능을 지원하는지 확인합니다. Pro에서는 읽기·가져오기 기능만 제공될 수 있습니다.
* **서버 기능이 갱신되지 않음:** 워크스페이스 관리자가 앱의 작업 목록을 새로고침해야 할 수 있습니다.
* ChatGPT에서 Manyfast를 선택한 메시지에만 플러그인이 적용될 수 있습니다. 후속 요청에서 최신 매니패스트 데이터를 조회해야 한다면 Manyfast를 다시 선택하거나 @멘션하세요.
문서 수정이나 다른 변경 작업에서 확인 창이 나타나면 대상 프로젝트와 변경 내용을 검토한 뒤 승인합니다.
{% endtab %}
{% tab title="Codex" %}
#### Codex 앱 설정 방법
Codex 앱, Codex CLI, IDE 확장 프로그램은 같은 Codex 호스트의 MCP 설정을 공유합니다. 아래에서는 현재 화면에 맞춰 Codex 앱에서 연결하는 방법을 안내합니다.
[OpenAI Codex MCP 공식 문서](https://developers.openai.com/codex/mcp)
**1. MCP 서버 설정 열기**
* Codex 앱의 좌측 하단 설정 아이콘을 선택한 뒤 **설정**을 엽니다.
**2. MCP 서버 추가하기**
* 설정의 좌측 패널에서 **MCP 서버**를 선택합니다.
* 오른쪽 위의 **서버 추가**를 선택합니다.
**3. 연결 정보 입력하기**
* **이름:** manyfast
* **연결 방식:** 스트리밍 가능한 HTTP
* **URL:**
* 기본 토큰 환경 변수와 헤더는 별도 안내가 없다면 비워 둔 채 **저장**을 선택합니다.
**4. 저장하고 Codex 다시 시작하기**
* 저장 후 MCP 서버 목록에 **manyfast**가 추가되었는지 확인하고 Codex를 다시 시작합니다.
**CLI로 연결하는 방법**
터미널을 선호한다면 아래 명령을 차례로 실행합니다. Codex 앱, CLI, IDE 확장 프로그램은 같은 호스트의 설정을 공유합니다.
```
codex mcp add manyfast --url https://api.manyfast.io/mcp
codex mcp login manyfast
codex mcp list
```
**5. 연결이 되지 않을 때**
* **인증 버튼이 보이지 않음:** Codex를 완전히 종료한 뒤 다시 열고 MCP 서버 목록을 확인합니다.
* **OAuth 창이 열리지 않음:** 터미널에서 `codex mcp login manyfast`를 실행해 인증을 다시 시작합니다.
* **서버가 목록에 없음:** URL이 `https://api.manyfast.io/mcp`인지 확인한 뒤 다시 저장합니다.
* **프로젝트가 보이지 않음:** 로그인한 매니패스트 계정의 프로젝트 접근 권한과 해당 그룹의 플랜을 확인합니다.
{% endtab %}
{% tab title="Lovable" %}
#### Lovable 설정 방법
{% hint style="info" %}
사용자 지정 MCP 서버 연결은 Lovable **Business 및 Enterprise** 플랜에서 사용할 수 있습니다. 워크스페이스 관리자나 소유자가 MCP 서버 사용을 제한한 경우 먼저 **설정 > Privacy & security**에서 허용 상태를 확인하세요. [Lovable Connectors 공식 문서](https://docs.lovable.dev/integrations/introduction)
{% endhint %}
* 프롬프트 입력창 옆 + 버튼에서 Connectors(이전 UI의 Integrations) > Chat connectors로 이동합니다. Cmd+K를 열고 connectors를 검색해도 됩니다.
* Chat connectors 화면에서 New MCP server 또는 Add custom MCP server의 Add를 선택합니다.
* Server Name에는 Manyfast, Server URL에는 입력합니다. 별도 안내가 없다면 Advanced Settings는 비워 두고 Add Server를 선택합니다.
> Lovable의 Chat connector 연결은 사용자별로 관리됩니다. 다른 워크스페이스 구성원과 자동 공유되지 않으며, 배포된 앱의 기능에도 포함되지 않습니다. Lovable Agent가 앱을 기획하고 만들 때 참고하는 컨텍스트로 사용됩니다.
**1. Lovable에서 사용하기**
새 프로젝트 또는 기존 프로젝트의 채팅을 열고 Manyfast 연결을 사용할 수 있는지 확인합니다.
**2. 연결이 되지 않을 때**
* **Custom MCP 항목이 보이지 않음:** Lovable 플랜이 Business 또는 Enterprise인지 확인하고, 워크스페이스 관리자·소유자에게 MCP 서버 사용 허용 여부를 확인합니다.
* **OAuth 화면이 열리지 않음:** Manyfast 연결을 삭제하지 말고 Chat connectors에서 다시 인증 또는 연결을 시도합니다.
* **Manyfast가 채팅에서 보이지 않음:** 연결이 사용자별로 생성되었는지 확인하고 현재 로그인한 Lovable 계정에서 다시 연결합니다.
* **프로젝트가 보이지 않음:** 로그인한 매니패스트 계정의 프로젝트 접근 권한과 해당 그룹의 플랜을 확인합니다.
{% endtab %}
{% tab title="Antigravity" %}
#### Antigravity 설정 방법
* Antigravity IDE에서는 Agent 패널 우측 상단 메뉴 > MCP Servers > Manage MCP Servers로 이동합니다. 최신 Antigravity 2.0에서는 왼쪽 아래 Settings > Customizations > Installed MCP Servers로 이동합니다. 공식 문서:
* Antigravity IDE에서는 Manage MCP Servers > View raw config를 선택합니다. 설정 파일은 Antigravity 2.0·IDE·CLI가 함께 사용하는 \~/.gemini/config/mcp\_config.json입니다.
기존 mcpServers 항목을 지우지 말고 아래 manyfast 설정을 추가한 뒤 파일을 저장합니다.
```
{
"mcpServers": {
"manyfast": {
"serverUrl": "https://api.manyfast.io/mcp"
}
}
}
```
* 파일을 저장한 뒤 Settings > Customizations > Installed MCP Servers로 돌아가 Refresh를 선택합니다. Manyfast가 설치된 MCP 서버 목록에 표시되는지 확인합니다. 처음 MCP 도구를 실행할 때는 권한 승인이 필요합니다.
{% endtab %}
{% endtabs %}
#### MCP 서버 인증하고 연결하기
MCP 서버를 추가하거나 활성화하면 브라우저에 매니패스트 인증 화면이 열립니다. 사용하려는 매니패스트 계정으로 로그인합니다.
* OAuth 연결은 그룹 하나를 고르는 방식이 아닙니다. 로그인한 매니패스트 계정이 접근할 수 있는 모든 프로젝트가 연결 범위에 포함되며, 실제 조회와 수정 가능 범위는 각 그룹의 권한과 플랜에 따라 결정됩니다.
연결한 도구로 돌아가 Manyfast가 연결됨 또는 활성 상태인지 확인합니다. 외부 AI에서 “매니패스트에서 내가 접근할 수 있는 프로젝트 목록을 보여줘.”라고 요청해 연결 상태를 확인합니다.
프로젝트가 보이지 않으면 로그인한 계정의 프로젝트 접근 권한과 해당 그룹의 플랜을 확인한 뒤 새로고침하거나 다시 인증합니다. 매니패스트 비밀번호나 개인 토큰은 MCP 설정 파일에 직접 입력하지 마세요.
