📚 本記事は 4 本シリーズの第 1 回です。AI 時代のマーケ基盤を構築する記録:
1. (現在) UTAGE API/MCPの実装制限と外部連携の現実解 ← この記事
2. Vercel/XServerのデプロイ先誤認を防ぐDNS確認手順
3. 診断ツールのタイプ判定アルゴリズム5つの落とし穴
4. SPF/DKIM/DMARCのGmail全PASS設定方法
5 月 5 日、午前 1 時 22 分。本番 API キーで GET /v1/funnels を叩いた瞬間、HTTP/2 200 が返ってきました。レスポンスヘッダには X-RateLimit-Limit: 6000。ドキュメントの例示値「60」とは桁が 2 つ違いました。
UTAGE は 2026 年 4 月 4 日に REST API + MCP サーバー(v2.0.0)をリリースしました。Claude Desktop から自然言語でファネルを構築できるという触れ込みです。実際に使えるのか? 本記事では 9 つのエンドポイントを実機検証した結果 をもとに、API/MCP の境界と「外部連携の唯一の現実解」を共有します。
なお UTAGE 自体は配信機能・LINE 統合・決済連携が強力な MA ツールです。本記事は API/MCP の 現時点の境界 を整理する目的であり、製品全体への評価ではありません。今後の API 拡張に期待しています。
結論を先に — できる 3 個 / できない 10 個
ドキュメントだけ読むと「マーケティングオートメーションのフル API」のように見えます。しかし実機検証すると 本質は LP 構築の自動化ツール だと分かりました。
| カテゴリ | 状態 | 例 |
|---|---|---|
| できる(自動化対象) | ✅ | ファネル / ステップ / ページ / 配信アカウント / シナリオの作成 |
| できる(参照のみ) | ✅ | メディア(動画・音声)一覧、要素タイプ取得 |
| できない(API 未提供) | ❌ | 読者(リード)の追加・更新・削除 |
| できない(API 未提供) | ❌ | フリー項目(読者項目)の作成・更新 |
| できない(API 未提供) | ❌ | ステップメール本文の作成・更新 |
| できない(API 未提供) | ❌ | 配信予約・配信実行 |
| できない(API 未提供) | ❌ | LINE 配信トリガー |
| できない(API 未提供) | ❌ | 顧客情報の検索・取得 |
| できない(API 未提供) | ❌ | 申込履歴・売上データ取得 |
| できない(API 未提供) | ❌ | ラベル付与/解除 |
| できない(API 未提供) | ❌ | Webhook 受信エンドポイント |
| できない(API 未提供) | ❌ | シナリオ間の移行ロジック設定 |
つまり API/MCP で 「LP の枠組みは作れる」 が、「読者を扱う・配信する・分析する」 はすべて手動操作が必要です。
API の実態 — 9 エンドポイント検証結果
検証は 2026 年 5 月 5 日、本番アカウントで実施しました。
Authorization: Bearer を付与して GET /v1/funnels を叩くと、200 でファネル一覧が meta.per_page=20 のページネーション付きで返ってきました。GET /v1/accounts では配信アカウント一覧、すべて type: "mail_line"(メール + LINE 併用)型です。
一方で読者を扱おうとした瞬間に詰まりました。
``bash
$ curl /v1/accounts/<アカウントID>/scenarios/<シナリオID>/readers
{"data":[],"meta":{"current_page":1,"per_page":20,"total":0}}取得はできる(空)
$ curl -X POST /v1/accounts/<アカウントID>/scenarios/<シナリオID>/readers
{"error":{"code":"404","message":"Not Found"}}
追加は 404
`
POST /readers は存在しません。/v1/reader-items、/v1/scenarios/{id}/items、/v1/free-items` も全て 404 でした。API でリードを追加する正規ルートは存在しない のが結論です。
💡 KEY TAKEAWAYS
UTAGE API/MCP は「マーケ自動化の万能 API」ではなく、「ファネル構築自動化ツール」です。読者・配信・分析は引き続き管理画面操作が必要。設計時にこの境界を取り違えると、後工程で詰みます。
レート制限・ID 形式 — ドキュメントと実機の乖離
設計時にドキュメントだけ信じると事故ります。実値との差を 3 点記録しておきます。
| 観点 | ドキュメント記載 | 実機実測 |
|---|---|---|
X-RateLimit-Limit | 例示 60 | 6000 |
| ID 形式 | fn_abc123 形式の例 | 実値は 12 文字英数字 |
| 認証フロー | OAuth 2.0 | OAuth 2.1(MCP セットアップ画面に明記) |
llms-full.txt | AI 読み込み用フルドキュメント | サンプルページのテキストを返すだけで未整備(2026-05-05 時点) |
レート 6000/時は十分余裕がありますが、設計初期に「60/時しかない、リトライ戦略必須」と誤読すると、無駄に複雑なキューイング機構を作り込みかねません。最初に 1 度実機で curl -i してヘッダを確認してください。
唯一の現実解 — フォーム埋込 + URL クエリパラメータ
外部サイト(自社 LP・診断ツール・チャットボットなど)から UTAGE に読者を流す方法は 1 つだけ です。
UTAGE のフォーム要素には form-input というコンポーネントがあり、input_type に hidden を指定して default_value を渡すと、ページ表示時に値が確定します。item="scenario" モードでは reader_item_id を指定してフリー項目に紐付けできます。
``json`
{
"type": "form",
"scenario_id": "<シナリオID>",
"use_reader_item": 1,
"children": [
{ "type": "form-input", "item": "mail", "input_type": "email", "required": 1 },
{ "type": "form-input", "item": "name", "input_type": "text", "required": 1 },
{
"type": "form-input",
"item": "scenario",
"input_type": "hidden",
"scenario_id": "<シナリオID>",
"reader_item_id": "diagnosis_type",
"default_value": "A"
}
]
}
このフォームを funnel_page_create で UTAGE LP に埋め込み、外部サイトから以下の URL で遷移します。
`
https://utage-system.com/r/<シナリオID>/register?
diagnosis_type=A&
diagnosis_score=42&
axis_fat=4&axis_muscle=8&...
UTAGE 側がクエリパラメータを default_value に上書きし、フォーム送信時に該当フリー項目へ保存されます。この導線が唯一の現実解 で、Make/Zapier 経由でも HTTP モジュールから API を叩いても、読者追加 API 自体がない以上ここに帰着します。
落とし穴: フリー項目の作成は API 未対応
連携の前提となる「フリー項目」は API で作成できません。30 個必要なら、画面で 1 個 ずつ手で作るしかありません。
実時間で言うと 1 個あたり 30 秒、30 個で 15 分 です。ただし 1 つでも「他シナリオ連携=する」のチェックを忘れると、後段のシナリオ移行時に値が消失して全体が破綻します。設定時に最も注意すべき箇所がこれです。
突破: 30 個分の項目 ID(name_str)を事前に決めて Excel/Notion で一覧化し、画面では「コピペ → タイプ選択 → 連携 ON → 保存」のリズムで作業します。作業前に MCP/API で自動化できる前提で設計し始めると、この 15 分の手作業を見落として工程が崩れます。
MCP の本質 — 23 ツールはすべて「ファネル構築」用
MCP 経由で利用できる 23 ツールの内訳は以下です。
| カテゴリ | ツール数 | 主な機能 |
|---|---|---|
| ディスカバリー | 1 | find_tools(ツール検索) |
| ファネル管理 | 12 | ファネル/ステップ/ページの作成・更新・削除 |
| 配信枠組み | 4 | 配信アカウント・シナリオの作成・一覧 |
| メディア参照 | 4 | 動画・音声・フォルダの一覧取得 |
| リファレンス | 2 | 要素タイプ・プロパティ定義の取得 |
「自然言語で UTAGE を操作」はできますが、できる対象は 構築フェーズだけ です。Claude に「メタボ型用のステップメール 7 通を作って配信スケジュール組んで」と頼んでも、本文作成・配信予約はどちらも API 未対応のため実行できません。
💡 KEY TAKEAWAYS
MCP は「自然言語で UTAGE を全部動かせる魔法」ではなく、「ファネル構築 IDE のショートカット」です。本文作成・配信実行・分析は人間が画面で行う運用設計が必要です。
設計時に踏むべきチェック項目
UTAGE API/MCP を採用する前に、以下を確認しておくと後悔を回避できます。
`text`
□ 取得したいデータが API のリストに含まれるか実機で確認したか
□ 読者追加が必要なら、フォーム LP 埋込前提の UI 設計になっているか
□ フリー項目を画面で何個作るか事前に確定したか(後追いで増やすと手戻り)
□ 「他シナリオ連携=する」を全フリー項目で ON にする運用ルールを決めたか
□ シナリオ間移行ロジックを画面で組む工数を見積もったか
□ 配信スケジュール・テンプレ作成は人間担当だと工数表に入っているか
□ レート制限を実機ヘッダで確認したか(ドキュメントの例示値ではなく)
実機検証コマンド集(社内チームへの共有用)
`bashベース URL
BASE=https://api.utage-system.com/v1
KEY=
H="Authorization: Bearer $KEY"
ファネル一覧 → レート制限ヘッダ確認
curl -sI -H "$H" "$BASE/funnels" | grep X-RateLimit配信アカウント一覧
curl -s -H "$H" "$BASE/accounts" | jq '.data[] | {id,name,type}'シナリオ一覧
curl -s -H "$H" "$BASE/accounts/<アカウントID>/scenarios" | jq読者一覧(取得は OK、追加は 404)
curl -s -H "$H" "$BASE/accounts/<アカウントID>/scenarios/<シナリオID>/readers" | jq要素タイプ・フォーム要素のプロパティ
curl -s -H "$H" "$BASE/element-types/funnel?include=form" | jq curl -s -H "$H" "$BASE/element-types/funnel/properties?types=form-input" | jq ``次のアクション
UTAGE API/MCP は「LP 構築の自動化ツール」として捉え直すと、20-30 % の工程は確実に削減できます。一方で読者・配信・分析の 70 % は人間の運用設計が必要です。
御社のマーケが「ツールに任せれば回る」状態なのか、それとも「人間の工夫が前提」のフェーズなのか、判定したい方は 細マッチョ企業診断 で 3 分セルフチェックしてみてください。5 軸スコアで贅肉(無駄業務)・筋力(集客力)・基盤(デジタル化度)の現在地が定量化されます。
→ 次の記事: Vercel/XServerのデプロイ先誤認を防ぐDNS確認手順