> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ko/llms.txt

# 불화

Discord 채널을 사용하면 Mastra Agent가 Discord 상호 작용 및 봇 메시지를 받을 수 있습니다. Mastra는 Agent 연결 및 웹훅 경로를 처리합니다. Chat SDK Discord 어댑터 문서에서는 Discord 애플리케이션 설정, 봇 권한 및 게이트웨이 동작을 다룹니다.

## 어댑터 설치

Chat SDK에서 Discord 어댑터를 설치합니다.

**npm**:

```bash
npm install @chat-adapter/discord
```

**pnpm**:

```bash
pnpm add @chat-adapter/discord
```

**Yarn**:

```bash
yarn add @chat-adapter/discord
```

**Bun**:

```bash
bun add @chat-adapter/discord
```

## Agent 구성

`createDiscordAdapter()`를 Agent의 `channels.adapters` 객체에 추가하세요.

```typescript
import { Agent } from '@mastra/core/agent'
import { createDiscordAdapter } from '@chat-adapter/discord'

export const discordAgent = new Agent({
  id: 'discord-agent',
  name: 'Discord Agent',
  instructions: 'Answer questions and help with tasks in Discord.',
  model: 'openai/gpt-5.6-sol',
  channels: {
    adapters: {
      discord: createDiscordAdapter(),
    },
  },
})
```

Mastra 인스턴스에 Agent를 등록합니다.

```typescript
import { Mastra } from '@mastra/core'
import { discordAgent } from './agents/discord-agent'

export const mastra = new Mastra({
  agents: { discordAgent },
})
```

## 어댑터 설정

애플리케이션 생성, 봇 토큰, 상호 작용 엔드포인트, 권한 및 Gateway 동작을 포함한 Discord 관련 설정은 [Chat SDK Discord 어댑터 문서](https://chat-sdk.dev/adapters/official/discord)를 따르세요. 어댑터는 다음과 같은 환경 변수에서 Discord 자격 증명을 읽습니다.

```bash
DISCORD_BOT_TOKEN=your-discord-bot-token
DISCORD_PUBLIC_KEY=your-discord-application-public-key
DISCORD_APPLICATION_ID=your-discord-application-id
```

## 웹훅 URL

Mastra는 Agent ID 및 어댑터 키에서 Discord 웹훅 경로를 생성합니다.

```text
/api/agents/discord-agent/channels/discord/webhook
```

공개 Mastra 서버 URL을 기본 URL로 사용하십시오.

```text
https://your-app.example.com/api/agents/discord-agent/channels/discord/webhook
```

Discord 어댑터 문서에서 상호 작용 끝점 또는 웹훅 URL을 요청하는 곳이면 어디든 이 URL을 사용하세요. Discord의 일반 메시지 이벤트에는 생성된 웹훅 경로 외부에 게이트웨이 설정이 필요할 수 있습니다. 해당 경로에 대한 Chat SDK 어댑터 문서를 따르세요.

## 관련된

- [채널 개요](https://mastra.zisheng.pro/ko/docs/capabilities/channels/overview)
- [더](https://mastra.zisheng.pro/ko/docs/capabilities/channels/other-adapters)