Skip to Content

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 연결 방법

  1. AIP에서 Discord with OAuth MCP Integration을 추가합니다.
  2. Discord OAuth 승인 화면에서 사용할 Discord 계정으로 로그인합니다.
  3. 연결할 서버를 선택하고 요청된 봇 권한을 승인합니다.
  4. 연결이 완료되면 선택한 서버의 Guild 정보가 저장됩니다.

주의사항

  • OAuth 승인 시 선택한 하나의 Discord 서버를 대상으로 동작합니다.
  • 채널 관리, 역할 관리, 메시지 관리 등 요청된 봇 권한이 서버에서 허용되어야 합니다.
  • 필요한 최소한의 권한만 부여하는 것을 권장합니다.
  • Discord API Rate Limit을 준수하여 요청하세요.
  • 모더레이션 기능 사용 시 신중하게 사용하세요.
Last updated on