# MCP 연결하기 (API)

### MCP를 통해 무엇을 할 수 있나요?

MCP 서버를 활성화하면 AI 코드 에이전트(Cursor, Claude Code 등)가 매니패스트의 기획 파일에 직접 접근해 내용을 학습하고, 기획된 구조를 바탕으로 코드를 생성할 수 있습니다.\
이를 통해 기획에서 개발로의 전환 과정을 빠르고 일관되게 이어갈 수 있습니다.

**1. 기획 문서로부터 코드 자동 생성**

* 매니패스트에서 정의한 기능명세를 MCP를 통해 Cursor, Claude Code 같은 코드 에이전트에 전달하여 기획 내용 대로 코드를 생성하고 개발을 전개할 수 있습니다.

**2. 에이전트 학습 컨텍스트 제공**

* 매니패스트에서의 기획 구조와 네이밍 규칙 등을 통해 AI 개발 에이전트에게 일관된 컨텍스트를 제공합니다.

**3. 기획과 개발의 실시간 동기화**

* MCP 서버는 매니패스트에서의 변동사항을 동시에 업데이트하여, 연동된 기획 정보를 최신 상태로 유지할 수 있습니다. (\*현재는 매니패스트 문서 읽기 전용으로 연동되며, 직접 수정 기능은 제공하지 않습니다.)

## 연결하는 방법

### 1. API Key 발급

{% stepper %}
{% step %}
도큐먼트 목록 화면에서 \[그룹/결제 관리] 페이지로 이동합니다.

<figure><img src="https://3323951709-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0nDmWkcH3Ia4zEb82Qz%2Fuploads%2FkYL1NP9pl9WJoKAWismj%2FAPI_01.png?alt=media&#x26;token=5086e6de-31bb-462b-ad9c-053be1abe1c1" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
**API 키 생성** 버튼을 누르고, API 이름을 지정하면 API 키 가 생성됩니다.

<figure><img src="https://3323951709-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0nDmWkcH3Ia4zEb82Qz%2Fuploads%2F1kU1WUqYBedpZcv4Fjf4%2FAPI_02.png?alt=media&#x26;token=c9e75a5a-38cd-427a-bf9a-f15642a2d231" alt=""><figcaption></figcaption></figure>

* 매니패스트의 API 키 양식은 `mf_sk_......` 입니다.
* 발급된 API 키는 생성 시 한번만 표시되니 주의해주세요.
* 발급된 키는 외부 에이전트 연결 시 인증 수단으로 사용되므로, 안전한 공간에 보관하세요.
  {% endstep %}
  {% endstepper %}

### 2. AI 에이전트에 연결

매니패스트 MCP는 Cursor와 Claude Code에서 사용할 수 있습니다.\
각 환경별 설정 방법은 아래 내용을 참고하세요.

{% tabs %}
{% tab title="Cursor" %}

#### Cursor에 연결하기

* Cursor의 설정(Settings) > Integrations > “Custom MCP Server” 항목으로 이동합니다.

```json
{
  "mcpServers": {
    "manyfast": {
      "url": "https://api.manyfast.io/mcp",
      "headers": {
        "Authorization": "Bearer <<API_KEY>>"
      }
    }
  }
}
```

* 다음 정보를 입력합니다.
  * **`<<API_KEY>>`**: 매니패스트에서 발급받은 개인 키로 대체해주세요.

#### 연결 확인

* Installed MCP Servers에 manyfast가 확인됩니다.

<figure><img src="https://3323951709-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0nDmWkcH3Ia4zEb82Qz%2Fuploads%2Fl9mkGIhevBUp0pS9g5iK%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-11-17%20%E1%84%8B%E1%85%A9%E1%84%8C%E1%85%A5%E1%86%AB%2011.02.02.png?alt=media&#x26;token=f728a3b4-6ae3-4471-9e54-e3cfe089678e" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Claude Code" %}

#### Claude Code에 연결하기

* 터미널에 다음 명령어를 실행합니다.

```bash
claude mcp add --transport http manyfast https://api.manyfast.io/mcp --header "Authorization: Bearer <<API_KEY>>"
```

* **API\_KEY**를 매니패스트에서 발급받은 개인 키로 대체합니다.&#x20;

#### 연결 확인

* 터미널에서 `claude`를 입력하여 Claude Code를 실행합니다.
* `/mcp` 명령어를 실행합니다.

<figure><img src="https://3323951709-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv0nDmWkcH3Ia4zEb82Qz%2Fuploads%2FlWMuowEi8qhhATa1QbRa%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202025-11-17%20%E1%84%8B%E1%85%A9%E1%84%8C%E1%85%A5%E1%86%AB%2011.11.15.png?alt=media&#x26;token=c80089d7-6505-4d6d-a98a-ed91d92ffa08" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}