Ortto MCP Server
公式Orttoの新しいMCPサーバーを使用すると、お気に入りのAIアシスタントをOrttoに接続できます。接続後、アシスタントはOrttoのCDPおよびマーケティングオートメーションプラットフォームから、顧客データ、オーディエンス、キャンペーンインサイトに安全にアクセスできます。
Ortto MCPで何ができますか？
- キャンペーン実績チェック — メール、SMS、プッシュ、またはジャーニーの実績指標（開封率やコンバージョンなど）を、
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とは？
Model Context Protocol（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 | 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 Overview」というタイトルを付けて」
- 「「Troubleshooting」という新しいカテゴリを作成して」
- 「現在のナレッジベース構造を表示して」
リクエスト制限
Ortto MCP機能を通じてAIエージェントを使用する場合、2つの異なる制限セットに直面します。AIエージェント（ClaudeやChatGPTなど）は、リクエストの長さとレスポンスサイズに関して独自の制限を適用しますが、Ortto MCPサーバーを経由するすべてのAPI呼び出しは、標準のOrtto APIレート制限の対象となります。これらのレート制限はサブスクリプションプランに基づいて適用され、システムの安定性と公平な使用を確保するために実装されています。
APIレート制限 の詳細をご覧ください。