Ortto MCP Server

MCP란 무엇인가요?

**Model Context Protocol(MCP)**은 AI 에이전트(Claude 또는 ChatGPT 등)가 외부 도구 및 데이터 소스와 안전하게 상호작용할 수 있도록 하는 개방형 표준입니다.

**AI 에이전트(MCP 클라이언트)**를 Ortto의 MCP 서버에 직접 연결할 수 있습니다. 이를 통해 에이전트가 Ortto 데이터를 이해하고 이를 기반으로 작업을 수행할 수 있습니다.

그러면 에이전트가 자연어 프롬프트를 사용하여 다양한 작업을 도와줄 수 있습니다. 예를 들어:

• "지난 30일간 내 이메일 캠페인의 성과를 보여줘."
• "전환 측면에서 가장 성과가 좋은 저니는 무엇인가요?"
• "이번 달 가장 참여도가 높은 연락처 목록을 가져와줘."

---

MCP 데이터 소스 구성

MCP 기능을 시작하려면 Ortto 계정에 MCP를 데이터 소스로 생성해야 합니다. 다음 단계에 따라 설정하세요:

1. Ortto 계정에서 CDP > 데이터 소스로 이동합니다.
2. 새 데이터 소스를 클릭하고 MCP를 검색합니다.
3. MCP 데이터 소스의 이름을 입력하고 연결을 클릭합니다.

4. 데이터 소스가 생성되면 Scoped key에 액세스할 수 있습니다. 이 키를 사용하여 Ortto를 선택한 AI 에이전트(Claude, ChatGPT 등)에 연결해야 합니다.

이제 Ortto를 AI 에이전트에 연결할 준비가 되었습니다. 사용 중인 AI 에이전트에 따라 아래의 해당 문서를 확인하세요:

• Claude와 함께 Ortto MCP 사용하기
• ChatGPT와 함께 Ortto MCP 사용하기

팁: 사용자 지정 커넥터를 지원하는 모든 앱에 Ortto MCP를 연결할 수 있습니다. 사용 중인 앱이 위에 나열되지 않은 경우, Ortto 계정이 호스팅된 위치에 따라 적절한 원격 MCP 서버 URL을 사용하세요.

• 미국: https://mcp-api-us.ortto.app/mcp?jwt=your-scoped-key
• 유럽: https://mcp-api-eu.ortto.app/mcp?jwt=your-scoped-key
• 호주: https://mcp-api-au.ortto.app/mcp?jwt=your-scoped-key

계정이 호스팅된 위치를 확실하지 않은 경우, 앱 내에서 설정 > 개인정보 보호, 보안 및 GDPR > 데이터 호스팅으로 이동하여 확인할 수 있습니다.

---

지원되는 도구/작업

Ortto MCP 서버는 AI 에이전트가 특정 도구/작업을 통해 Ortto 데이터와 상호작용할 수 있게 합니다. 아래 표는 데이터 범주별로 구성되어 있으며 지원되는 도구/작업과 그 정의를 자세히 설명합니다.

팁: 아래 표에 설명된 도구/작업은 MCP 기능에서 사용하는 명명 규칙일 뿐입니다. AI 에이전트 도구에서 이러한 이름을 명시적으로 사용할 필요는 없습니다. 에이전트는 자연어 요청에 따라 적절한 도구/작업을 자동으로 선택하여 사용합니다.

캠페인 관리

도구/작업	설명
get_campaigns	필터링 및 페이지네이션 옵션을 지원하는 캠페인 목록을 검색합니다. 캠페인 유형, 상태 및 검색어로 필터링할 수 있습니다.

예시:

• "지난 달의 모든 이메일 캠페인을 보여줘"
• "현재 실행 중인 캠페인을 가져와줘"
• "이름에 'summer'가 포함된 캠페인을 찾아줘"

연락처 및 오디언스

도구/작업	설명
get_contacts	오디언스 ID, 필드 선택 및 검색 기능을 포함한 포괄적인 필터링 옵션으로 연락처를 검색합니다.
get_audiences	검색 및 페이지네이션을 지원하여 계정의 모든 오디언스를 나열합니다.

예시:

• "이름에 'smith'가 포함된 연락처를 검색해줘"
• "회원 수가 1,000명 미만인 오디언스를 찾아줘"
• "최근 가입한 10명의 연락처에 대한 이메일 주소와 이름을 보여줘"

캠페인 보고서

도구/작업	설명
get_email_report	열람률, 클릭률 및 참여 지표를 포함한 상세한 이메일 캠페인 성과 보고서를 생성합니다.
get_journey_report	사용자 지정 기간으로 포괄적인 저니 성과 분석을 제공합니다.
get_journey_shape_report	특정 저니 형태와 해당 지표를 분석합니다.
get_sms_report	SMS 캠페인 성과 데이터 및 참여 통계를 검색합니다.
get_push_report	푸시 알림 캠페인 분석 및 전달 지표에 액세스합니다.

예시:

• "'Holiday Sale' 캠페인에 대한 이메일 보고서를 생성해줘"
• "'Abandoned Cart' 저니의 전반적인 성과는 어떤가요?"

사용자 지정 보고서

도구/작업	설명
list_reports	차트 유형별 필터링 및 검색 기능을 지원하여 Ortto 계정에서 사용자가 생성한 보고서에 액세스합니다.
get_report	사용자 지정 기간 및 새로 고침 옵션으로 특정 보고서 데이터를 검색합니다.

예시:

• "내 계정의 모든 파이 차트 보고서를 나열해줘"
• "'Q3 Revenue' 보고서의 데이터를 검색해줘"

계정 및 구성

도구/작업	설명
get_schema	사용자 지정 필드 및 데이터 구조를 포함하여 Ortto 인스턴스의 전체 데이터 스키마를 검색합니다.
get_brand_book	색상, 글꼴 및 브랜딩 요소를 포함한 브랜드 북 설정에 액세스합니다.

예시:

• "브랜드 북에 정의된 기본 및 보조 브랜드 색상은 무엇인가요?"
• "이름에 'example'이 포함된 내 계정의 모든 사용자 지정 필드를 검색해줘"

자산 관리

도구/작업	설명
create_asset	사용자 지정 콘텐츠 및 메타데이터로 주로 HTML 이메일인 새 자산을 생성합니다.
get_asset_html	검토 또는 수정을 위해 기존 자산의 HTML 콘텐츠를 검색합니다.
update_asset_meta	이름, 제목 줄 및 발신자 정보를 포함한 자산 메타데이터를 업데이트합니다.

예시:

• "사용자가 다가오는 세일을 놓치지 말아야 하는 이유를 설명하는 콘텐츠가 포함된 'Can't Miss Savings'라는 제목의 새 프로모션 이메일 자산을 생성해줘"
• "'Welcome Email v2'라는 자산의 HTML 콘텐츠를 검색해줘"

지식 베이스

도구/작업	설명
get_index	카테고리 및 문서 계층 구조를 포함한 지식 베이스 구조를 검색합니다.
create_category	선택적 상위-하위 관계로 새 지식 베이스 카테고리를 생성합니다.
create_article_from_html	HTML 콘텐츠에서 카테고리화와 함께 지식 베이스 문서를 생성합니다.
move_article	지식 베이스의 카테고리 간에 문서를 이동합니다.
modify_index	지식 베이스 인덱스 구조 및 구성을 업데이트합니다.

예시:

• "이 HTML에서 지식 베이스 문서를 생성하고 'MCP 개요'로 제목을 지정해줘"
• "'문제 해결'이라는 새 카테고리를 생성해줘"
• "현재 지식 베이스 구조를 보여줘"

---

요청 한도

Ortto MCP 기능을 통해 AI 에이전트를 사용할 때 두 가지 서로 다른 한도가 적용됩니다. AI 에이전트(Claude 또는 ChatGPT 등)는 요청 길이 및 응답 크기에 대한 자체 한도를 적용하지만, Ortto MCP 서버를 통해 라우팅되는 모든 API 호출은 표준 Ortto API 속도 제한의 적용을 받습니다. 이러한 속도 제한은 구독 요금제에 따라 적용되며 시스템 안정성과 공정한 사용을 보장하기 위해 시행됩니다.

API 속도 제한에 대해 자세히 알아보세요.