---
title: "MCP 서버"
description: "원격 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` 헤더입니다. 헤더 값은 쓰기 전용이며 저장 시 암호화됩니다.
    나중에 서버를 수정할 때 기존 값을 유지하려면 값을 비워 둡니다.
  </Step>
  <Step title="저장하고 동기화합니다">
    저장하면 서버의 도구 목록이 즉시 동기화됩니다. 서버
    카드에는 검색된 모든 도구가 이름별로 표시됩니다. 아무것도 표시되지 않으면 서버가
    응답했지만 도구를 제공하지 않은 것입니다.
  </Step>
</Steps>

## 서버 관리

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

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

<Note>
  도구 목록은 마지막 동기화 시점의 상태로 캐시됩니다. 서버에 도구를 추가하거나
  변경한 경우 에이전트가 새 도구 세트를 인식하도록 **도구 동기화**를 클릭합니다.
</Note>

## 에이전트에 연결

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

## 다음 단계

<CardGroup cols={2}>
  <Card title="ThunderPhone을 MCP 서버로 사용" icon="server" href="/ko/guides/thunderphone-mcp-server">
    외부 AI 클라이언트에서 에이전트 목록을 조회하고, 전화를 걸고, 통화 결과를 확인할 수 있습니다.
  </Card>
  <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>