Elastic Email MCP

공식

Elastic Email MCP 서버는 GitHub Copilot, ChatGPT, Claude 및 기타 호환 가능한 어시스턴트와 같은 AI 에이전트가 Elastic Email 계정과 원활하게 통합될 수 있도록 합니다.

Elastic Email MCP(으)로 무엇을 할 수 있나요?

  • 연락처 목록 관리 — 어시스턴트에게 목록 생성, 연락처 추가, 연락처 대량 업로드, 또는 목록이나 계정에서 연락처 제거를 요청하세요.
  • 캠페인 구축 및 실행 — 어시스턴트에게 이메일 캠페인 생성, 목록 조회, 업데이트, 또는 일시 중지를 요청하고 기존 캠페인 세부 정보를 가져오세요.
  • 트랜잭션 및 대량 이메일 전송 — 어시스턴트에게 Elastic Email 계정을 통해 개별 또는 대량 이메일 전송을 지시하세요.
  • 계정 데이터 검색 — 어시스턴트에게 검토 또는 보고를 위해 연락처, 연락처 목록, 템플릿, 또는 세그먼트를 가져오도록 요청하세요.
  • 서버 연결 확인 — 작업을 시작하기 전에 어시스턴트에게 MCP 연결 및 준비 상태를 확인하기 위한 상태 점검을 실행하도록 요청하세요.

문서

MCP 서버 주소인 https://mcp.elasticemail.com는 AI 에이전트 연결에만 사용됩니다. 이는 Elastic Email REST API의 주소가 아니며 다른 통합에서 API 호스트로 사용할 수 없습니다. API 주소에 대해서는 "API 설정" 문서를 참조하세요.

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 도구를 사용한 단계별 설정 예시를 준비했습니다.

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

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

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

  • 채팅 창을 표시하려면 VS Code 상단 메뉴에서 View → Chat으로 이동하세요. 채팅이 오른쪽에 표시됩니다.

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

  • Elastic Email에서 API 키를 생성합니다. 보기 및 수정에 필요한 권한은 다음과 같습니다: Account, Templates, Campaigns, Contacts, Files, Send HTTP. 또한 최소한 Access Tokens에 대한 "보기" 권한이 필요합니다. API 키를 승인되지 않은 제3자와 절대 공유하지 마세요!
  • VS Code 상단 바에서 검색 기능을 사용하여 Show and run commands를 찾습니다
  • 검색 필드에 "MCP"를 입력하여 사용 가능한 옵션을 좁히고 "MCP: Open user configuration"을 선택합니다.
  • 아래와 같은 구성 텍스트를 붙여넣습니다 (이미 서버가 있는 경우 elasticemail.mcp 데이터만 있으면 충분합니다)
{
    "servers": {
        "elasticemail.mcp": {
            "url": "https://mcp.elasticemail.com",
            "headers": {
                "X-Auth-Token": "your_api_key"
            }
        }
    }
}

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

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

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

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

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

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

팁

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