@channel.io/channel-talk-integration-mcp/README.md

Channel Talk Integration MCP - Installation guides for Channel Talk SDK across multiple platforms

# Channel Talk Integration MCP

Channel Talk SDK 설치 가이드를 제공하는 Model Context Protocol(MCP) 서버입니다. 다양한 플랫폼(웹, 모바일, 웹뷰)에서 Channel Talk을 쉽게 설치할 수 있도록 상세한 가이드를 제공합니다.

## 🚀 기능

이 MCP 서버는 다음과 같은 Channel Talk 설치 가이드를 제공합니다:

- **초기 가이드**: Channel Talk 소개 및 플랫폼 선택 안내 (한국어/영어)
- **웹사이트**: JavaScript SDK 설치 가이드 (직접 로드/NPM 모듈)
- **Android**: Android SDK 설치 가이드 (Kotlin/Java)
- **iOS**: iOS SDK 설치 가이드 (Swift/Objective-C)
- **React Native**: React Native SDK 설치 가이드
- **웹뷰**: 웹뷰 환경에서의 설치 가이드 (Android/iOS)

## 📦 설치

```bash
npm install @channel.io/channel-talk-integration-mcp
```

또는

```bash
yarn add @channel.io/channel-talk-integration-mcp
```

## 🛠️ 사용법

### MCP 클라이언트에서 사용

1. MCP 클라이언트 설정에 서버 추가:

```json
{
  "mcpServers": {
    "channel-talk-integration": {
      "command": "npx",
      "args": ["@channel.io/channel-talk-integration-mcp"]
    }
  }
}
```

2. 사용 가능한 도구들:

| 도구명                   | 설명                           | 언어 지원   |
| ------------------------ | ------------------------------ | ----------- |
| `get_initial_guide`      | Channel Talk 소개 및 초기 안내 | 한국어/영어 |
| `get_web_guide`          | 웹사이트 설치 가이드           | 한국어/영어 |
| `get_android_guide`      | Android 앱 설치 가이드         | 한국어/영어 |
| `get_ios_guide`          | iOS 앱 설치 가이드             | 한국어/영어 |
| `get_react_native_guide` | React Native 앱 설치 가이드    | 한국어/영어 |
| `get_webview_guide`      | 웹뷰 설치 가이드               | 한국어/영어 |

### 언어 설정

모든 도구는 선택적 `language` 파라미터를 지원합니다:

- `language: "ko"` 또는 파라미터 없음: 한국어 가이드
- `language: "en"`: 영어 가이드

## 🏗️ 프로젝트 구조

```
src/
├── tools/                    # MCP 도구 정의
│   ├── get-initial-guide.ts     # 초기 가이드 도구
│   ├── get-web-guide.tool.ts    # 웹 가이드 도구
│   ├── get-android-guide.tool.ts # Android 가이드 도구
│   ├── get-ios-guide.tool.ts    # iOS 가이드 도구
│   ├── get-react-native-guide.tool.ts # React Native 가이드 도구
│   └── get-webview-guide.tool.ts # 웹뷰 가이드 도구
└── index.ts                  # 메인 진입점
```

## 🔧 개발

### 로컬 개발 환경 설정

```bash
# 의존성 설치
pnpm install

# 개발 모드 실행 (파일 변경 감지)
pnpm dev

# 빌드
pnpm build

# 타입 체크
pnpm typecheck

# 린트
pnpm lint
pnpm lint:fix
```

### 새로운 가이드 추가

1. `src/tools/` 디렉토리에 새 도구 파일 생성
2. Zod 스키마를 사용한 파라미터 정의
3. 한국어/영어 가이드 함수 구현
4. 공통 코드는 별도 함수로 분리
5. `src/index.ts`에서 도구 등록

## 📚 관련 문서

- [Channel Talk 개발자 문서](https://developers.channel.io)
- [Channel Talk 웹 설치 가이드](https://developers.channel.io/reference/web-quickstart-kr)
- [Channel Talk Android 설치 가이드](https://developers.channel.io/reference/android-quickstart-kr)
- [Channel Talk iOS 설치 가이드](https://developers.channel.io/reference/ios-quickstart-kr)
- [Channel Talk React Native 설치 가이드](https://developers.channel.io/reference/react-native-quickstart-kr)
- [Channel Talk 웹뷰 설치 가이드](https://developers.channel.io/reference/webview-quickstart-kr)

## 🤝 기여

버그 리포트나 기능 요청은 [https://root.channel.io](https://root.channel.io)에서 제출해주세요.

## 📄 라이선스

MIT License

## 👨‍💻 개발자

**Byeongchan Park** (perry@channel.io)

---

© 2025 Channel Corp. All rights reserved.