Ortto MCP Server

官方

Ortto 的全新 MCP 服务器可让您将喜爱的 AI 助手连接到 Ortto。连接后，您的助手可以安全地访问来自 Ortto 的 CDP 和营销自动化平台的客户数据、受众群体和营销活动洞察。

访问 ortto.com

文档

前往 ortto.com

首页 Ortto MCP Ortto MCP

Ortto MCP

什么是 MCP？

模型上下文协议 (MCP) 是一项开放标准，允许 AI 代理（如 Claude 或 ChatGPT）安全地与外部工具和数据源进行交互。

您可以将 AI 代理（MCP 客户端） 直接连接到 Ortto 的 MCP 服务器。这使您的代理能够理解并处理您的 Ortto 数据。

然后，您的代理可以使用自然语言提示协助完成各种任务。例如：

  • “显示我过去 30 天电子邮件营销活动的表现。”
  • “哪些旅程在转化方面表现最佳？”
  • “获取本月互动最频繁的联系人列表。”

配置 MCP 数据源

要开始使用我们的 MCP 功能，您需要在 Ortto 账户中创建 MCP 作为数据源。请按照以下步骤进行设置：

  1. 在您的 Ortto 账户中，导航至 CDP > 数据源。
  2. 点击 新建数据源 并搜索 MCP。
  3. 输入您的 MCP 数据源名称，然后点击 连接。

4. 数据源创建后，您将获得一个范围密钥。您需要使用此密钥将 Ortto 连接到您选择的 AI 代理（Claude、ChatGPT 等）。

现在，您已准备好将 Ortto 连接到您的 AI 代理。根据您使用的 AI 代理，请查看以下相应文章：

  • 将 Ortto MCP 与 Claude 结合使用
  • 将 Ortto MCP 与 ChatGPT 结合使用

提示：您可以将 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访问推送通知营销活动分析和送达指标。

示例：

  • “为‘假日促销’营销活动生成电子邮件报告”
  • “‘弃购’旅程的整体表现如何？”

自定义报告

工具/操作描述
list_reports访问您 Ortto 账户中用户创建的报告，支持按图表类型和搜索功能进行筛选。
get_report检索特定的报告数据，支持自定义时间范围和刷新选项。

示例：

  • “列出我账户中所有的饼图报告”
  • “检索‘第三季度收入’报告的数据”

账户与配置

工具/操作描述
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 速率限制。