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

# MCP 서버

> 원격 MCP 서버를 연결하면 해당 서버가 제공하는 모든 도구를 에이전트에서 사용할 수 있습니다.

이미 [Model Context Protocol](https://modelcontextprotocol.io)을 지원하는 도구 서버를 운영하고 있다면 ThunderPhone에 직접 연결할 수 있습니다. **연결 → MCP** (`/dashboard/mcp-connections`)에서 서버를 한 번 추가하면 도구가 자동으로 검색되며 모든 에이전트에 연결할 수 있습니다.

ThunderPhone은 **Streamable HTTP**를 통해 MCP 서버에 연결합니다. 이것이 유일하게 지원되는 전송 방식이므로 서버는 HTTP URL에서 접근할 수 있어야 합니다(stdio 전용 로컬 서버는 작동하지 않습니다).

## 서버 추가

<Steps>
  <Step title="서버 추가를 클릭합니다">
    서버의 **이름**과 **URL**(예: `https://example.com/mcp`)을 입력합니다.
  </Step>

  <Step title="서버에 필요한 헤더를 추가합니다">
    서버에 필요한 정적 HTTP 헤더를 추가합니다. 일반적으로 `Authorization` 헤더입니다. UI에서 헤더 값은 쓰기 전용입니다. 나중에 서버를 수정할 때 기존 값을 유지하려면 해당 값을 비워 둡니다.
  </Step>

  <Step title="저장하고 동기화합니다">
    저장하면 즉시 서버의 도구 목록이 동기화됩니다. 서버 카드에는 검색된 모든 도구가 이름별로 표시됩니다. 아무것도 표시되지 않으면 서버가 응답했지만 도구를 제공하지 않은 것입니다.
  </Step>
</Steps>

## 서버 관리

각 서버 카드에는 URL과 캐시된 도구 목록이 표시되며, 다음 작업을 수행할 수 있습니다.

* 서버를 삭제하지 않고 **활성화/비활성화**합니다.
* **도구 동기화** — 서버가 변경된 후 도구 목록을 다시 가져옵니다.
* 이름, URL 또는 헤더를 **수정**합니다.
* 서버를 **삭제**합니다.

<Note>
  도구 목록은 마지막 동기화 시점의 내용으로 캐시됩니다. 서버에 도구를 추가하거나 변경한 경우 에이전트가 새 목록을 볼 수 있도록 **도구 동기화**를 클릭합니다.
</Note>

## 에이전트에 연결

연결된 서버는 에이전트가 사용하기 전까지 아무 작업도 수행하지 않습니다. 빌더에서 에이전트를 열고([에이전트 구축](/ko/guides/build-an-agent)) MCP 섹션에서 서버를 연결합니다. 그러면 해당 서버의 도구를 에이전트의 대화 중에 호출할 수 있습니다.

## 다음 단계

<CardGroup cols={2}>
  <Card title="API 연결" icon="plug" href="/ko/guides/api-connections">
    MCP 서버 없이 단일 HTTP 엔드포인트를 에이전트 함수로 사용합니다.
  </Card>

  <Card title="앱 연결" icon="cable" href="/ko/guides/connect-apps">
    사전 구축된 Google, Slack, HubSpot, Salesforce, Cal.com 도구입니다.
  </Card>
</CardGroup>