# 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="/files/N6KO3bNPNCNS045GDyDy" alt=""><figcaption></figcaption></figure>

{% endstep %}

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

<figure><img src="/files/IO7R6KCWAxgpjqgkXDuU" 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="/files/Mn6pTrIIohoNI0QDdsHH" 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="/files/VDjmn7CXfJ8TR7eEL48s" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.manyfast.io/use/mcp-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.