MCP 연결하기

와 기능명세서 등 기획 데이터를 직접 조회하고 활용할 수 있습니다.

외부 AI는 연결된 기획 문서를 작업의 컨텍스트로 참고하며, 사용 중인 플랜과 권한에 따라 매니패스트의 기획 내용을 수정할 수도 있습니다.

Jira·GitHub·Linear 연결은 MCP가 아닌 이슈 트래커 연동 기능입니다.

1. MCP를 통해 할 수 있는 일

기획을 바탕으로 개발 작업하기

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 서버 추가하기

Cursor 설정 방법

Cursor 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 항목만 추가하세요.

{
  "mcpServers": {
    "manyfast": {
      "url": "https://api.manyfast.io/mcp"
    }
  }
}

2. 설치 상태 확인하기

Cursor의 Customize > MCP 또는 Cursor Settings > Tools & MCPs에서 Installed MCP Servers 목록을 열고 manyfast가 표시되는지 확인합니다.

Cursor의 Installed MCP Servers 목록에 manyfast 서버가 Needs authentication 상태로 표시된 화면

3. 연결되지 않을 때 확인하기
연결되지 않을 때 확인하기
1. 연결되지 않을 때 확인하기

목록에 manyfast가 보이지 않음: ~/.cursor/mcp.json의 파일 위치와 JSON 문법을 확인하고 MCP 목록을 새로고침하세요. 계속 보이지 않으면 Cursor를 다시 실행하세요.
Needs authentication이 계속 표시됨: Connect를 다시 선택하고 브라우저의 로그인 및 연결 승인 절차를 완료하세요.
다른 계정이 표시됨: 승인 화면에서 다른 계정으로 로그인을 선택하세요.
필요한 프로젝트가 보이지 않음: 연결한 매니패스트 계정이 해당 프로젝트에 접근할 수 있는지 멤버 권한을 확인하세요.

OAuth 인증을 사용하므로 설정 파일에 비밀번호나 액세스 토큰을 직접 입력할 필요가 없습니다.

Claude Code 설정 방법

Claude Code MCP 공식 문서

1. 매니패스트 MCP 등록하기

터미널에서 다음 명령어를 실행합니다. --scope user를 사용하면 설정이 ~/.claude.json에 저장되어 다른 프로젝트에서도 사용할 수 있습니다.

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

2. 등록 상태 확인하기

등록된 서버 목록과 매니패스트 설정을 확인합니다.

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가 안전하게 저장하고 갱신하므로 설정 파일에 비밀번호나 액세스 토큰을 직접 입력하지 마세요.

ChatGPT 설정 방법

ChatGPT 웹에서 사용자 지정 MCP 플러그인(앱)을 연결하려면 개발자 모드를 사용할 수 있어야 합니다. 현재 OpenAI 안내 기준으로 Pro에서는 읽기·가져오기 기능을 제공하는 MCP를 연결할 수 있으며, 수정·쓰기 기능을 포함한 전체 MCP 지원은 Business와 Enterprise/Edu에서 제공됩니다. 실제 이용 범위는 계정 요금제와 워크스페이스 관리자 설정에 따라 달라질 수 있습니다.

ChatGPT 플러그인 화면에서 새 플러그인을 추가하는 더하기 버튼이 강조된 화면

프로필 메뉴에서 설정을 열고 보안 및 로그인 > 개발자 모드로 이동해 기능을 켭니다. 계정이나 워크스페이스에 따라 설정 > 앱 > 고급 설정에 표시될 수도 있으며, 관리형 워크스페이스에서는 관리자 권한이 필요할 수 있습니다.개발자 모드를 켠 뒤 왼쪽 메뉴의 플러그인 또는 설정 > 앱을 열고, 오른쪽 위의 + 버튼이나 만들기를 선택합니다.

ChatGPT의 새 플러그인 화면에 Manyfast 이름, MCP 서버 URL, OAuth 인증이 입력된 화면

OpenAI ChatGPT MCP 공식 문서

1. 연결 정보 입력하기

이름: Manyfast
설명: 매니패스트의 PRD와 기능명세서 등 기획 데이터를 조회하고 활용합니다. (선택)
연결 방식: 서버 URL
서버 URL: https://api.manyfast.io/mcp
인증: OAuth

고급 OAuth 설정에는 별도 안내가 없는 한 값을 직접 입력하지 않습니다. 매니패스트 비밀번호나 개인 토큰도 입력하지 마세요.

사용자 지정 MCP 서버의 위험 안내를 읽고 계속 진행 항목을 확인합니다.
도구 스캔이 표시되면 실행하고 결과가 나타날 때까지 기다립니다. 화면에 만들기만 표시되면 입력값을 확인한 뒤 만들기를 선택합니다.

2. ChatGPT에서 사용하기

새 채팅을 열고 이번 메시지에 사용할 플러그인(앱)으로 Manyfast를 선택하거나 @Manyfast로 호출합니다.

플러그인 선택은 대화 전체가 아니라 해당 메시지에 적용될 수 있습니다. 후속 요청에서 최신 데이터를 다시 조회해야 한다면 Manyfast를 다시 선택하거나 @멘션하세요.

3. 연결이 되지 않을 때

개발자 모드가 보이지 않음: ChatGPT 요금제, 관리자·소유자 역할, 워크스페이스 권한을 확인합니다.
플러그인을 만들 수 없음: 개발자 모드와 서버 URL https://api.manyfast.io/mcp를 확인합니다.
도구 스캔 또는 로그인이 멈춤: 팝업 차단을 해제한 뒤 플러그인 관리 화면에서 연결을 다시 시도합니다.
다른 계정으로 연결됨: Manyfast 연결을 해제하고 올바른 매니패스트 계정으로 다시 인증합니다.
프로젝트가 보이지 않음: 로그인 계정의 프로젝트 접근 권한과 그룹 플랜을 확인합니다.
수정 기능을 사용할 수 없음: ChatGPT 계정에서 전체 MCP의 쓰기·수정 기능을 지원하는지 확인합니다. Pro에서는 읽기·가져오기 기능만 제공될 수 있습니다.
서버 기능이 갱신되지 않음: 워크스페이스 관리자가 앱의 작업 목록을 새로고침해야 할 수 있습니다.
ChatGPT에서 Manyfast를 선택한 메시지에만 플러그인이 적용될 수 있습니다. 후속 요청에서 최신 매니패스트 데이터를 조회해야 한다면 Manyfast를 다시 선택하거나 @멘션하세요.

문서 수정이나 다른 변경 작업에서 확인 창이 나타나면 대상 프로젝트와 변경 내용을 검토한 뒤 승인합니다.

Codex 앱 설정 방법

Codex 앱, Codex CLI, IDE 확장 프로그램은 같은 Codex 호스트의 MCP 설정을 공유합니다. 아래에서는 현재 화면에 맞춰 Codex 앱에서 연결하는 방법을 안내합니다.

OpenAI Codex MCP 공식 문서

1. MCP 서버 설정 열기

Codex 앱의 좌측 하단 설정 아이콘을 선택한 뒤 설정을 엽니다.

Codex 앱 설정의 MCP 서버 화면에서 서버 추가 버튼이 표시된 화면

2. MCP 서버 추가하기

설정의 좌측 패널에서 MCP 서버를 선택합니다.
오른쪽 위의 서버 추가를 선택합니다.

Codex 앱의 맞춤형 MCP 연결 화면에 manyfast 이름과 스트리밍 가능한 HTTP URL을 입력하는 화면

3. 연결 정보 입력하기

이름: manyfast
연결 방식: 스트리밍 가능한 HTTP
URL: https://api.manyfast.io/mcp
기본 토큰 환경 변수와 헤더는 별도 안내가 없다면 비워 둔 채 저장을 선택합니다.

Codex 앱 MCP 서버 목록에서 manyfast 서버와 인증 버튼이 표시된 화면

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인지 확인한 뒤 다시 저장합니다.
프로젝트가 보이지 않음: 로그인한 매니패스트 계정의 프로젝트 접근 권한과 해당 그룹의 플랜을 확인합니다.

Lovable 설정 방법

사용자 지정 MCP 서버 연결은 Lovable Business 및 Enterprise 플랜에서 사용할 수 있습니다. 워크스페이스 관리자나 소유자가 MCP 서버 사용을 제한한 경우 먼저 설정 > Privacy & security에서 허용 상태를 확인하세요. Lovable Connectors 공식 문서

Lovable 프롬프트의 더하기 메뉴에서 Integrations와 Manage Integrations를 선택하는 기존 화면

프롬프트 입력창 옆 + 버튼에서 Connectors(이전 UI의 Integrations) > Chat connectors로 이동합니다. Cmd+K를 열고 connectors를 검색해도 됩니다.

Lovable의 Your MCP servers 목록에서 New MCP server Add 버튼이 표시된 화면

Chat connectors 화면에서 New MCP server 또는 Add custom MCP server의 Add를 선택합니다.

Lovable Add MCP Server 대화상자에 Manyfast 서버 이름과 URL을 입력한 화면

Server Name에는 Manyfast, Server URL에는 https://api.manyfast.io/mcp를 입력합니다. 별도 안내가 없다면 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 계정에서 다시 연결합니다.
프로젝트가 보이지 않음: 로그인한 매니패스트 계정의 프로젝트 접근 권한과 해당 그룹의 플랜을 확인합니다.

Antigravity 설정 방법

Antigravity IDE의 Agent 패널에서 MCP Servers와 Manage MCP Servers 메뉴를 여는 화면

Antigravity IDE에서는 Agent 패널 우측 상단 메뉴 > MCP Servers > Manage MCP Servers로 이동합니다. 최신 Antigravity 2.0에서는 왼쪽 아래 Settings > Customizations > Installed MCP Servers로 이동합니다. 공식 문서: https://antigravity.google/docs/mcp

Antigravity IDE의 Manage MCP servers 화면에서 View raw config 버튼을 선택하는 화면

Antigravity IDE에서는 Manage MCP Servers > View raw config를 선택합니다. 설정 파일은 Antigravity 2.0·IDE·CLI가 함께 사용하는 ~/.gemini/config/mcp_config.json입니다.

Antigravity 설정 파일에 manyfast 서버 URL을 추가한 코드 예시

기존 mcpServers 항목을 지우지 말고 아래 manyfast 설정을 추가한 뒤 파일을 저장합니다.

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

Antigravity에서 Manyfast MCP 인증 링크를 브라우저로 여는 확인 팝업

파일을 저장한 뒤 Settings > Customizations > Installed MCP Servers로 돌아가 Refresh를 선택합니다. Manyfast가 설치된 MCP 서버 목록에 표시되는지 확인합니다. 처음 MCP 도구를 실행할 때는 권한 승인이 필요합니다.

MCP 서버 인증하고 연결하기

MCP 서버를 추가하거나 활성화하면 브라우저에 매니패스트 인증 화면이 열립니다. 사용하려는 매니패스트 계정으로 로그인합니다.

OAuth 연결은 그룹 하나를 고르는 방식이 아닙니다. 로그인한 매니패스트 계정이 접근할 수 있는 모든 프로젝트가 연결 범위에 포함되며, 실제 조회와 수정 가능 범위는 각 그룹의 권한과 플랜에 따라 결정됩니다.

연결한 도구로 돌아가 Manyfast가 연결됨 또는 활성 상태인지 확인합니다. 외부 AI에서 “매니패스트에서 내가 접근할 수 있는 프로젝트 목록을 보여줘.”라고 요청해 연결 상태를 확인합니다.

프로젝트가 보이지 않으면 로그인한 계정의 프로젝트 접근 권한과 해당 그룹의 플랜을 확인한 뒤 새로고침하거나 다시 인증합니다. 매니패스트 비밀번호나 개인 토큰은 MCP 설정 파일에 직접 입력하지 마세요.

이전내보내기

다음Jira, GitHub, Linear 연동하기

마지막 업데이트 13일 전