---
title: "코딩 에이전트를 ThunderPhone 문서에 연결하기"
description: "ThunderPhone의 읽기 전용 문서 MCP 서버를 Claude Code, Codex, Cursor 또는 다른 Streamable HTTP MCP 클라이언트에 추가합니다."
---

ThunderPhone은 다음 주소에서 공개 읽기 전용 문서 MCP 서버를 제공합니다.

```text
https://thunderphone.com/docs/mcp
```

API 키가 필요하지 않습니다. 코딩 에이전트가 전체 문서 세트를 프롬프트에 로드하지 않고 최신 ThunderPhone 제품 및 API 컨텍스트가 필요할 때 사용합니다.

## Claude Code에 추가

```bash
claude mcp add --transport http thunderphone-docs https://thunderphone.com/docs/mcp
```

## Codex에 추가

`~/.codex/config.toml`에 다음을 추가합니다. 서버를 해당 프로젝트에서만 사용할 수 있게 하려면 신뢰할 수 있는 프로젝트의 `.codex/config.toml`에 추가합니다.

```toml
[mcp_servers.thunderphone-docs]
url = "https://thunderphone.com/docs/mcp"
```

## Cursor에 추가

프로젝트의 `.cursor/mcp.json`에 이 서버를 추가하거나, 이에 상응하는 전역 MCP 설정을 사용합니다.

```json
{
  "mcpServers": {
    "thunderphone-docs": {
      "url": "https://thunderphone.com/docs/mcp"
    }
  }
}
```

## 사용 가능한 도구

| 도구 | 인수 | 반환 내용 |
| --- | --- | --- |
| `list_pages` | 없음 | 제목, Markdown URL 및 설명이 포함된 모든 영어 문서 페이지입니다. |
| `search_docs` | `query` | 설명과 텍스트 스니펫이 포함된 순위별 일치 항목을 최대 10개 반환합니다. |
| `get_page` | `path` | 영어 문서 페이지 하나의 원시 Markdown/MDX 소스입니다. |

세 도구 모두 읽기 전용으로 표시됩니다. 서버는 상태를 저장하지 않으며 고객 또는 조직 데이터를 포함하지 않습니다.

<Note>
  이 서버는 문서를 읽습니다. MCP 클라이언트가 조직의 에이전트와 통화를 검사하고, 트랜스크립트를 읽거나 발신 전화를 걸 수 있도록 하려면 인증된 [ThunderPhone API MCP 서버](/ko/guides/thunderphone-mcp-server)를 사용합니다.
</Note>

## 연결 테스트

클라이언트에 다음과 같이 요청합니다.

```text
Search the ThunderPhone docs for webhook signature verification, then show me
the relevant page and a minimal implementation checklist.
```

JSON-RPC를 통해 도구 목록을 검사할 수도 있습니다.

```bash
curl -X POST https://thunderphone.com/docs/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
```