Elastic Email MCP Server

MCP를 구현함으로써 Elastic Email은 AI 에이전트가 보안과 적절한 인증을 유지하면서 이메일 운영에 접근하고 제어할 수 있도록 합니다.

MCP가 수행할 수 있는 사용 가능한 작업

• 목록에 연락처 추가
• 연락처 업로드 및 추가
• 목록 생성
• 세그먼트 생성
• 캠페인 생성
• 캠페인 가져오기
• 캠페인 업데이트
• 캠페인 일시 중지
• 캠페인 목록 조회
• 이메일 발송: 트랜잭셔널 및 대량 발송 모두
• 연락처, 연락처 목록, 목록의 연락처 조회
• 목록 조회
• 템플릿 조회
• 세그먼트 조회
• 준비 상태 확인 (상태 점검, 연결 및 준비 상태 확인)
• 목록에서 연락처 삭제
• 계정에서 연락처 삭제

나열된 모든 엔드포인트가 모든 Elastic Email 요금제에서 사용 가능한 것은 아닙니다. 예를 들어, 캠페인 및 연락처 엔드포인트는 Email API 요금제에서 사용할 수 없습니다. 위에 나열된 기능에 대한 전체 문서 목록은 다음과 같습니다:

https://help.elasticemail.com/en/articles/4984897-contact-lists-and-segments

https://help.elasticemail.com/en/articles/5472509-how-to-send-your-first-campaign

http://help.elasticemail.com/en/articles/2300606-how-to-manage-templates

설정

MCP 서버에 연결하려면 MCP를 지원하는 모든 AI 에이전트를 사용할 수 있습니다. 설정의 핵심 요구 사항은 AI 에이전트가 외부 서비스와 안전하게 프로그래밍 방식으로 상호 작용할 수 있도록 하는 "에이전트 모드" 지원입니다.

VS Code와 Github Copilot 도구를 사용한 단계별 설정 예시를 준비했습니다.

• https://github.com Github에서 무료 계정을 생성해야 합니다.
• https://code.visualstudio.com/ 이 웹사이트에서 VS Code를 다운로드하세요.

다음으로 Github 계정을 VS Code에 연결해야 합니다.

• VS Code 설치 및 실행

• 왼쪽 메뉴에서 확장 프로그램을 열고 Github Copilot 및 Github Copilot Chat 확장 프로그램을 설치합니다.

• 이전 단계에서 생성한 계정을 사용하여 Github에 로그인합니다.

• Github Copilot에서 Visual Studio Code를 인증합니다.

• 다음 단계에서 VS Code 실행을 허용합니다.

• 채팅 창을 표시하려면 VS Code 상단 메뉴에서 보기 → 채팅으로 이동합니다. 채팅은 오른쪽에 표시되어야 합니다.

• 채팅을 에이전트 모드로 전환합니다.

• Elastic Email에서 API 키를 생성합니다. 보기 및 수정에 필요한 권한은 다음과 같습니다: 계정, 템플릿, 캠페인, 연락처, 파일, HTTP 전송. 이 외에도 최소한 액세스 토큰에 대한 "보기" 접근 권한이 필요합니다. API 키를 승인되지 않은 제3자와 절대 공유하지 않도록 주의하세요!

• VS Code 상단 바에서 검색 기능을 사용하여 다음을 찾습니다: 명령 표시 및 실행

• 검색 필드에 "MCP"를 입력하여 사용 가능한 옵션을 좁히고 "MCP: 사용자 구성 열기"를 선택합니다.

• 아래와 같은 구성 텍스트를 붙여넣습니다 (이미 서버가 있는 경우 elasticemail.mcp 데이터만으로 충분합니다)

{
"servers": {
"elasticemail.mcp": {
"url": "https://mcp.elasticemail.com",
"headers": {
"X-Auth-Token": "your_api_key"
}
}
}
}

여기서 가장 중요한 단계는 위에서 언급한 권한을 가진 실제 API 키를 입력하는 것입니다. 또한 이 필드를 수정한 후에는 진행하기 전에 변경 사항을 저장해야 합니다. 변경 사항을 저장하지 않으면 통합을 "시작"하는 옵션이 나타나지 않습니다.

• 이제 MCP 서버에 연결을 시작할 수 있습니다: 구성 파일에서 elasticemail.mcp 위의 시작을 클릭합니다.

• 대체 방법: 왼쪽 메뉴에서 확장 프로그램을 선택하고, 하단의 MCP SERVERS INSTALLED에서 서버를 선택한 후 마우스 오른쪽 버튼을 클릭하고 서버 시작을 선택합니다.

이제부터 채팅 창 내에서 Elastic Email MCP 서버가 제공하는 작업을 사용할 수 있습니다. 이러한 작업은 이 문서의 시작 부분에 설명되어 있습니다.

통합이 작동하는지 확인하기 위해 첫 번째 명령을 시도할 수 있습니다. 예를 들어 "MCP가 작동하나요" 프롬프트를 입력하면 모든 것이 정상이면 확인 응답을 받게 됩니다.

이러한 통합이 Elastic Email 측에서 어떻게 작동하는지 더 잘 이해하려면 API 문서도 검토해 보세요:

https://elasticemail.com/developers/api-documentation/rest-api

팁

1. AI 에이전트가 이전 지침을 기억하고 재시도하면서 멈출 수 있습니다. 이러한 문제를 해결하려면 새 채팅 세션을 시작하는 것이 유용합니다. 또한 에이전트에게 도구를 다시 가져오도록 지시하고 서버에 변경 사항이 있었음을 알려 실제로 새 데이터를 다시 가져오도록 할 수 있습니다.
2. 프롬프트가 정확할수록 LLM이 해석할 여지가 줄어들어 환각 관련 문제가 감소합니다.
3. 요청을 보내기 전에 검토하는 것이 유용합니다. LLM이 요청을 API 호출로 변환하는 방식에서 잠재적인 불일치를 발견할 수 있기 때문입니다.