> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happycapy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Happycapy에서 MCP server를 통합으로 사용합니다.

## 개요

MCP를 사용하면 Happycapy가 Project 안에서 다른 tools와 data를 사용할 수 있습니다. context를 찾고, records를 읽고, systems를 업데이트하고, databases를 query하고, team-built actions를 실행하도록 요청할 수 있습니다.

프로토콜 자체를 이해할 필요는 없습니다. server setup guide, 접근 정보, 목표를 Happycapy에 전달하세요. Happycapy는 server가 제공하는 내용을 확인하고, 필요한 권한을 설명한 뒤, 해당 tools로 작업할 수 있습니다.

MCP는 Gmail이나 Notion 같은 공개 서비스뿐 아니라 내부 knowledge base, database, CRM, approval flow, dashboard, operations tool, legacy API에도 사용할 수 있습니다.

## MCP를 사용할 때

Happycapy가 현재 session의 files와 context만 다루는 것이 아니라, 다른 system의 능력을 사용해야 할 때 MCP가 적합합니다.

* Notion, Google Drive, Slack, 내부 wiki에서 docs, pages, messages, team knowledge 검색
* email, calendar, CRM, support, ticketing, project system의 정보 읽기 또는 업데이트
* Postgres, Supabase, Neon, internal database, dashboard, reporting tool query
* GitHub, Linear, logs, issues, release data 같은 developer / product system 작업
* approval, inventory lookup, customer record update, report generation 같은 team-built actions 사용

사용 가능 여부는 Happycapy에 제공할 MCP server 또는 setup guide가 있는지에 따라 달라집니다.

## MCP로 할 수 있는 일

<CardGroup cols={2}>
  <Card title="Context 가져오기" icon="search">
    작업을 시작하기 전에 관련 docs, tickets, messages, records, customer notes를 Happycapy가 찾게 합니다.
  </Card>

  <Card title="승인된 action 실행" icon="check-circle">
    server tools를 통해 draft, update, create, assign, comment, sync, summarize 작업을 할 수 있습니다.
  </Card>

  <Card title="내부 system 사용" icon="building">
    internal database, dashboard, approval, operations, legacy system용 team-built server를 연결합니다.
  </Card>

  <Card title="Setup 재사용" icon="repeat">
    server details를 Project에 남겨 비슷한 workflow에서 같은 connection을 다시 사용할 수 있습니다.
  </Card>
</CardGroup>

## 시작하기 전에

있으면 좋은 정보:

* MCP server link, repository 또는 setup guide
* 사용할 account, workspace, project 또는 data source
* server documentation에 있는 login, token, permission, workspace approval 안내
* server 준비 후 Happycapy가 완료해야 할 task

## 첫 사용

Happycapy에 server와 목표를 함께 알려주세요.

```text theme={null}
이 Happycapy Project에 이 MCP server를 설정해줘.
변경하기 전에 필요한 접근 권한을 설명해줘.
준비가 끝나면 먼저 노출된 tools를 보여줘.

MCP server: [link 또는 setup guide]
Goal: [Happycapy가 완료해야 할 일]
```

## 예시 workflow

```text theme={null}
우리 Notion MCP server를 사용해줘.
최신 product launch notes를 찾고 아직 결정되지 않은 사항을 요약해줘.
```

```text theme={null}
Gmail과 Calendar MCP server를 사용해줘.
이번 주 customer meeting emails를 찾고 follow-up plan을 작성해줘.
```

```text theme={null}
internal CRM MCP server를 사용해줘.
이 customer를 조회하고 최근 activity를 요약한 뒤 account update를 작성해줘.
```

```text theme={null}
Postgres MCP server를 사용해줘.
지난주 activation data를 query하고 trend를 쉬운 말로 설명해줘.
```

## 접근 권한

* 가능하면 server의 공식 login 또는 authorization flow를 사용하세요.
* task에 필요한 최소 권한만 사용하세요.
* 데이터를 변경하기 전에 Happycapy에게 사용 가능한 tools를 먼저 보여달라고 하세요.
* 민감한 작업은 Happycapy에게 무엇을 읽거나 바꿀지 먼저 설명하게 하세요.
* server가 회사 또는 고객 데이터에 접근할 수 있다면 account와 workspace를 먼저 확인하세요.

## 문제 해결

### Setup이 작동하지 않음

공식 setup guide를 공유하고 Happycapy에게 어느 step에서 실패했는지 확인하게 하세요.

### 인증 실패

server가 browser login, token, API key, environment variable, workspace approval 중 무엇을 요구하는지 확인하세요.

### 기대한 tool이 보이지 않음

Happycapy에게 server가 제공하는 tools를 나열하게 하고, server documentation과 비교하세요.

### 결과 범위가 너무 넓음

workspace, project, data source, record, date range, 원하는 output format을 추가하세요.

## 개발자용

MCP는 Model Context Protocol의 약자입니다. server를 만들거나 선택할 때는 공식 MCP 문서를 기준으로 삼으세요.

<Card title="Model Context Protocol" icon="globe" href="https://modelcontextprotocol.io">
  MCP 공식 문서와 server resources를 확인하세요.
</Card>

## 다음 단계

* 이 설정을 다시 사용할 계획이라면 server link, access notes, workspace details를 [Project](/ko/features/projects)에 남겨두세요.
* 같은 MCP workflow를 일정에 따라 실행하려면 [Automations](/ko/features/automations)를 사용하세요.