Ortto MCP Server
官方Ortto 的全新 MCP 服务器可让您将喜爱的 AI 助手连接到 Ortto。连接后，您的助手可以安全地访问来自 Ortto 的 CDP 和营销自动化平台的客户数据、受众群体和营销活动洞察。
你可以用 Ortto MCP 做什么？
- 活动效果检查 — 通过
get_email_report、get_sms_report、get_push_report或get_journey_report查询电子邮件、短信、推送或旅程的效果指标，如打开率和转化率。 - 联系人与受众发现 — 按姓名或受众规模查找联系人，并使用
get_contacts和get_audiences拉取包含特定字段的最新注册用户。 - 活动与资产管理 — 使用
get_campaigns、create_asset和update_asset_meta列出或搜索活动、创建 HTML 电子邮件资产并更新其元数据。 - 知识库组织 — 通过
create_category、create_article_from_html和move_article创建分类、从 HTML 生成文章并移动它们，以构建或重构帮助内容。 - 账户架构与品牌洞察 — 通过
get_schema和get_brand_book获取数据架构、自定义字段以及品牌手册中的颜色/字体。
文档
什么是 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 代理，请查看以下相应文章：
提示：您可以将 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 | 检索短信营销活动绩效数据和互动统计。 |
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 Overview'"
- "创建一个名为'Troubleshooting'的新类别"
- "显示当前的知识库结构"
请求限制
当您通过 Ortto MCP 功能使用 AI 代理时，会遇到两套不同的限制。虽然 AI 代理（如 Claude 或 ChatGPT）会强制执行其自身的请求长度和响应大小限制，但所有通过 Ortto MCP 服务器路由的 API 调用都受我们标准的 Ortto API 速率限制约束。这些速率限制根据您的订阅计划适用，旨在确保系统稳定性和公平使用。
了解更多关于我们的 API 速率限制。