Ortto MCP Server
공식Ortto의 새로운 MCP 서버를 사용하면 즐겨 사용하는 AI 어시스턴트를 Ortto에 연결할 수 있습니다. 연결되면 어시스턴트가 Ortto의 CDP 및 마케팅 자동화 플랫폼에서 고객 데이터, 오디언스, 캠페인 인사이트를 안전하게 액세스할 수 있습니다.
문서
ortto.com으로 이동
홈 Ortto MCP Ortto MCP
Ortto MCP
MCP란 무엇인가요?
모델 컨텍스트 프로토콜(MCP) 은 AI 에이전트(예: Claude 또는 ChatGPT)가 외부 도구 및 데이터 소스와 안전하게 상호 작용할 수 있도록 하는 개방형 표준입니다.
AI 에이전트(MCP 클라이언트) 를 Ortto의 MCP 서버에 직접 연결합니다. 이를 통해 에이전트가 Ortto 데이터를 이해하고 이에 따라 작업을 수행할 수 있습니다.
그러면 에이전트가 자연어 프롬프트를 사용하여 다양한 작업을 지원할 수 있습니다. 예를 들어:
- "지난 30일간의 이메일 캠페인 성과를 보여줘."
- "전환 측면에서 가장 성과가 좋은 여정은 무엇인가요?"
- "이번 달 가장 참여도가 높은 연락처 목록을 알려줘."
MCP 데이터 소스 구성하기
MCP 기능을 시작하려면 Ortto 계정에서 MCP를 데이터 소스로 생성해야 합니다. 다음 단계에 따라 설정하세요:
- Ortto 계정에서 CDP > 데이터 소스로 이동합니다.
- 새 데이터 소스를 클릭하고 MCP를 검색합니다.
- MCP 데이터 소스의 이름을 입력하고 연결을 클릭합니다.
4. 데이터 소스가 생성되면 범위 지정 키에 액세스할 수 있습니다. 이 키를 사용하여 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 | 필터링 및 페이지 매김 옵션을 사용하여 캠페인 목록을 검색합니다. 캠페인 유형, 상태 및 검색어별 필터링을 지원합니다. |
예시:
- "지난달의 모든 이메일 캠페인을 보여줘"
- "현재 실행 중인 캠페인 가져오기"
- "이름에 '여름'이 포함된 캠페인 찾기"
연락처 및 오디언스
| 도구/액션 | 설명 |
|---|---|
| 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 | 푸시 알림 캠페인 분석 및 전달 지표에 액세스합니다. |
예시:
- "'할인 판매' 캠페인에 대한 이메일 보고서 생성하기"
- "'장바구니 이탈' 여정의 전반적인 성과는 무엇인가요?"
사용자 지정 보고서
| 도구/액션 | 설명 |
|---|---|
| list_reports | 차트 유형별 필터링 및 검색 기능을 사용하여 Ortto 계정에서 사용자 생성 보고서에 액세스합니다. |
| get_report | 사용자 지정 가능한 기간 및 새로 고침 옵션으로 특정 보고서 데이터를 검색합니다. |
예시:
- "내 계정의 모든 원형 차트 보고서 나열하기"
- "'3분기 수익' 보고서 데이터 검색하기"
계정 및 구성
| 도구/액션 | 설명 |
|---|---|
| get_schema | 사용자 지정 필드 및 데이터 구조를 포함하여 Ortto 인스턴스의 전체 데이터 스키마를 검색합니다. |
| get_brand_book | 색상, 글꼴 및 브랜딩 요소를 포함한 브랜드 북 설정에 액세스합니다. |
예시:
- "브랜드 북에 정의된 기본 및 보조 브랜드 색상은 무엇인가요?"
- "이름에 'example'이 포함된 내 계정의 모든 사용자 지정 필드 검색하기"
자산 관리
| 도구/액션 | 설명 |
|---|---|
| create_asset | 사용자 지정 가능한 콘텐츠 및 메타데이터로 새 자산(주로 HTML 이메일)을 생성합니다. |
| get_asset_html | 검토 또는 수정을 위해 기존 자산의 HTML 콘텐츠를 검색합니다. |
| update_asset_meta | 이름, 제목 줄 및 발신자 정보를 포함한 자산 메타데이터를 업데이트합니다. |
예시:
- "사용자가 다가오는 할인을 놓치면 안 되는 이유를 설명하는 콘텐츠로 '놓칠 수 없는 할인'이라는 제목의 새 프로모션 이메일 자산 만들기"
- "'환영 이메일 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 속도 제한에 대해 자세히 알아보세요.