Claude Customer.io連携の使い方 — 読み取り・書き込み・削除を承認制で

Claude Customer.io連携とは

Claude Customer.io連携は、顧客エンゲージメントプラットフォームのCustomer.io自身が開発・保守する公式Connectorです。カテゴリは「Communication」「Data & analytics」「Sales & marketing」の3つで、開発元は「Customer.io」、サインインが必須です。ディレクトリへの追加時期は2026年2月です。

Customer.ioワークスペース上でオートメーション・セグメント・メールの作成、キャンペーン実績の分析、顧客データの管理を行える連携です。接続範囲について公式ページは「Connect Claude to your Customer.io workspace with full read, write, and delete access — granted independently, per workspace, via OAuth(読み取り・書き込み・削除のフルアクセスをワークスペースごとに独立してOAuthで付与する)」と明記しています。

8個の汎用ツールで権限を区切る構成

Customer.io連携は操作ごとの個別ツールではなく、汎用的な動詞スコープのツール8個で構成されています。

この連携はJourneys UI APIとData Pipelines APIを動詞スコープのツールで公開し、読み取り・書き込み・削除をそれぞれ別々に承認できる設計です(公式: "so reads, writes, and deletes are approved separately")。個別の操作ごとにツールを増やすのではなく、HTTPメソッド単位で権限を区切るアーキテクチャです。cio_schema と cio_skills_list / cio_skills_read が、アカウントのプランに応じた最新のガイダンス(オートメーションの組み方・セグメント条件・メールデザインのパターンなど)をClaudeに供給し、汎用ツールだけでも複雑な作業を組み立てられるようにしています。

Claude Customer.io連携でできることの例

公式ページが挙げる利用例は次の7カテゴリです。

• オートメーション(キャンペーン)・ブロードキャスト・ニュースレターの作成と編集
• 自然文で書いた条件からセグメントを作成(原文はplain-English)
• 顧客プロファイルと属性の確認・更新
• Design Studioでのメール下書き作成・QA・公開
• 配信数・開封・クリック・コンバージョンの分析、配信不良の原因診断
• CDP Data Pipelines(ソース・デスティネーション・逆ETL)の管理
• SDKセットアップとアプリ統合のエンドツーエンドの案内

公式が例示する指示文はこの4つです。

• 「先月のウェルカムオートメーションの実績を分析して」
• 「90日間非アクティブなユーザーのセグメントを作成して」
• 「再エンゲージメント用のメールを作成してQAして」
• 「今週配信数が落ちた理由を教えて」

いずれも cio_read_api によるデータ取得と cio_schema / cio_skills_read によるガイダンス参照を組み合わせ、必要に応じて cio_write_api が実行される流れになります。

dry-runプレビューという安全装置

すべての書き込み・削除操作は実行前にdry-runプレビューをサポートし、認証情報がClaudeを経由することはありません(公式: "Safety is built in: every write and delete supports a dry-run preview before execution, and credentials never pass through Claude")。

cio_write_api や cio_delete_api を呼び出す前に、実際に適用される変更内容を確認できる仕組みが組み込まれています。削除操作まで扱えるフルアクセスのConnectorだからこそ、この一段階が実運用での事故を防ぐ役割を持ちます。認証はOAuthで、ワークスペースと権限スコープは接続時に選択します。

接続手順

Customer.ioはConnectorsディレクトリ掲載のコネクタです。Web connectorsはClaude・Cowork・Claude Desktop・Claude Mobile(iOS/Android)の全ユーザーが利用でき、Claude Codeからも接続方法が用意されています。

1. チャット欄左下の「+」ボタン(または「/」)からメニューを開き、「Connectors」→「Manage connectors」を選ぶ
2. ディレクトリの「Sales & marketing」カテゴリか、検索窓から「Customer.io」を探して選択する
3. 「Connect」をクリックして接続を開始する
4. 認証プロンプトに従い、Customer.ioアカウントでサインインし、対象のワークスペースと権限スコープを選ぶ
5. 要求される権限の範囲を確認する

claude.aiアカウントでClaude Codeにログインしている場合は、claude.ai側で接続済みのCustomer.ioが /mcp パネルに自動的に表示され、改めて登録し直す必要はありません。これはclaude.aiのサブスクリプションログインを認証方式にしている場合の挙動で、ANTHROPIC_API_KEY などAPIキー認証でClaude Codeを動かしている場合はこの自動反映が起こりません。APIキー認証時にCustomer.ioのMCPサーバーを個別登録する具体的な手順は、今回参照した一次ソースには記載がなく確認できませんでした。

権限とセキュリティの注意点

Claudeは接続したユーザー自身のCustomer.ioワークスペース権限をそのまま引き継ぎます。そのワークスペースで見えないセグメントやキャンペーンにはClaude経由でもアクセスできません。ワークスペースごとに独立してOAuth付与される設計のため、複数ワークスペースを扱う組織では、どのワークスペースに対して接続したかを都度確認する必要があります。

コネクタ設定の「Tool permissions」では、読み取り・書き込み・削除系ツールが種類ごとに分類され、それぞれ「Always allow」「Needs approval」「Blocked」から選べます。cio_write_api と cio_delete_api は動詞スコープでまとめて権限管理できます。ただし個別の操作単位では制御できないため、削除を伴う操作を許可する際は、dry-runプレビューを必ず確認する運用にしておくと事故を防ぎやすくなります。

Team・Enterpriseプランでは、Ownerが組織全体に対して特定のアクションを一律に制限できます。この制限は組織全体に適用され、個々のメンバーが自分の判断で上書きすることはできません。読み取り専用の運用から始めたい場合の考え方は業務SaaS連携は読み取り専用アクセスから始める理由にまとめています。

うまく接続できないときの確認

接続や認証でつまずいたときは、次の順に確認します。

• インターネット接続が安定しているか
• Customer.ioのアカウントとワークスペースが有効な状態か
• そのアカウントに、接続しようとしている操作を行う権限があるか
• 認証が失敗する場合は、いったん接続を解除してから再接続する

よくあるつまずき

削除操作の実行前に内容を確認したい

cio_delete_api はdry-runプレビューに対応しています。実行前にどのレコードが削除対象になるかを確認するよう明示的に依頼すると、想定外の削除を防ぎやすくなります。

セグメント作成の条件が想定と違う

平易な言葉での指示は便利な反面、対象期間や条件の境界(「90日間非アクティブ」の起点をいつにするかなど)が曖昧だと、Claudeが独自解釈で埋めることがあります。起点となる日付や指標名を具体的に指定すると再現性が上がります。

Team・Enterpriseで「Customer.ioが見当たらない」

個人の設定画面にCustomer.ioの選択肢自体が出てこない場合、組織側でまだConnectorが有効化されていません。個人の操作では解決せず、オーナーへの依頼が唯一の手段です。

複数ワークスペースのうちどれに接続したか分からなくなる

OAuth付与はワークスペースごとに独立しているため、意図したワークスペースと違う場所に変更が入るのを避けるには、接続時に選んだワークスペース名を都度確認する習慣が有効です。

まとめ

Claude Customer.io連携は、読み取り・書き込み・削除のフルアクセスを持つディレクトリコネクタで、オートメーション作成からセグメント設計、メールのドラフト・QA、実績分析、Data Pipelinesの管理までを会話から任せられます。個別の操作ごとにツールを分けるのではなく、cio_read_api / cio_write_api / cio_delete_api という動詞スコープのツールで権限を区切り、書き込み・削除の実行前にdry-runプレビューを挟む設計が特徴です。削除まで扱えるだけに、Tool permissionsでの承認設定を慎重に行う価値があります。ほかのConnectorsの種類や追加方法を先に知りたい場合はClaude Connectorsとはが参考になります。Connectorのアーキテクチャそのものをもう少し掘り下げたい場合はClaudeのインタラクティブコネクタとはを参照してください。