Discord with OAuth
OAuth를 통해 Discord 서버와 연결하여 메시지 전송, 채널 관리, 사용자 관리 등을 수행할 수 있습니다.
주요 기능
- OAuth 기반 Discord 서버 연결
- 서버 및 채널 정보 조회
- 메시지 전송 및 조회
- 사용자 및 멤버 관리
- 역할 추가 및 제거
- 반응(이모지) 관리
- 채널 생성 및 삭제
- 메시지 모더레이션
기본 정보
인증 방식
OAuth 2.0을 사용하여 인증합니다.
Discord OAuth 승인 화면에서 연결할 서버를 선택하고 봇 권한을 승인하면, AIP가 해당 서버의 Guild ID와 Guild Name을 저장합니다.
입력 파라미터
Integration 추가 시 직접 입력해야 하는 별도 설정값은 없습니다. OAuth 승인 과정에서 연결할 Discord 서버를 선택합니다.
지원하는 MCP 도구
서버 관리 도구
get_server_info
OAuth로 연결된 Discord 서버 정보를 조회합니다.
list_channels
서버의 채널 목록을 조회합니다.
create_text_channel
새로운 텍스트 채널을 생성합니다.
delete_channel
채널을 삭제합니다.
사용자 관리 도구
get_user_info
Discord 사용자 정보를 조회합니다.
list_members
서버의 멤버 목록을 조회합니다.
add_role
사용자에게 역할을 추가합니다.
remove_role
사용자에게서 역할을 제거합니다.
채널 관리 도구
get_channel_info
특정 채널 정보를 조회합니다.
메시지 관리 도구
send_message
특정 채널에 메시지를 전송합니다. 파일 첨부가 필요한 경우 aip-temp://, aip-chat://, aip-drive:// URI를 사용할 수 있습니다.
read_messages
채널의 최근 메시지를 조회합니다.
moderate_message
메시지를 삭제하고 선택적으로 사용자를 타임아웃 처리합니다.
반응 관리 도구
add_reaction
메시지에 반응을 추가합니다.
add_multiple_reactions
메시지에 여러 반응을 추가합니다.
remove_reaction
메시지에서 반응을 제거합니다.
사용 예시
예를 들어,
- Prompt로 “공지 채널에 오늘 배포 완료 메시지를 보내줘”라고 입력하면,
- LLM은 MCP를 통해
send_message도구를 호출하여 연결된 Discord 서버의 지정 채널에 메시지를 전송합니다. - 그리고, Tool 호출 결과를 기반으로 채팅에서 응답합니다.
OAuth 연결 방법
- AIP에서 Discord with OAuth MCP Integration을 추가합니다.
- Discord OAuth 승인 화면에서 사용할 Discord 계정으로 로그인합니다.
- 연결할 서버를 선택하고 요청된 봇 권한을 승인합니다.
- 연결이 완료되면 선택한 서버의 Guild 정보가 저장됩니다.
주의사항
- OAuth 승인 시 선택한 하나의 Discord 서버를 대상으로 동작합니다.
- 채널 관리, 역할 관리, 메시지 관리 등 요청된 봇 권한이 서버에서 허용되어야 합니다.
- 필요한 최소한의 권한만 부여하는 것을 권장합니다.
- Discord API Rate Limit을 준수하여 요청하세요.
- 모더레이션 기능 사용 시 신중하게 사용하세요.
Last updated on