インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Twilio Segment をワンクリックで追加して、AI クライアント(Claude、ChatGPT、Copilot、Cursor)を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
AI に Twilio Segment のワークスペースを操作させます。ソース、デスティネーション、ウェアハウスの一覧、イベント量、配信、ウェアハウス同期の確認、トラッキングプラン、Functions、使用量、監査証跡の読み取りができます。米国と EU のワークスペースに対応しています。
こう聞いてみよう
Twilio Segment のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Twilio Segment をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Twilio Segment + ChatGPT
AI に Twilio Segment のワークスペースを操作させます。ソース、デスティネーション、ウェアハウスの一覧、イベント量、配信、ウェアハウス同期の確認、トラッキングプラン、Functions、使用量、監査証跡の読み取りができます。米国と EU のワークスペースに対応しています。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
SEGMENT_API_HOST, SEGMENT_API_TOKEN
ステップ 1 — 認証情報を取得
- Workspace Owner として Settings → Workspace settings → Access Management → Tokens(
https://app.segment.com/goto-my-workspace/settings/access-management/tokens)を開き、Create Token をクリックします。 - Config API トークンではなく Public API トークンを選びます。必要な範囲をカバーする最小のロールを付けてください。読み取りだけなら読み取り専用ロール(たとえば Source Read-only と Tracking Plan Read-only)を付けた Workspace Member、書き込みツールを有効にする場合にだけ Workspace Owner にします。
- Segment はトークンを一度しか表示しません。すぐに
SEGMENT_API_TOKENにコピーしてください。トークンは Bearer トークンとして Segment にだけ送られます。 SEGMENT_API_HOSTをワークスペースのリージョンに合わせて設定します。米国のワークスペースはhttps://api.segmentapis.com、EU のワークスペースはhttps://eu1.api.segmentapis.comです。トークンは自分のリージョンでしか使えません。- コネクタをインストールし、
segment_get_workspaceを実行して接続を確認します。トークンは 1 つのワークスペースに属するため、ワークスペースごとにコネクタを 1 つインストールしてください。
読み取れるデータ: ソース、Actions のマッピングを含むデスティネーション、接続状態と最近の同期を含むウェアハウス、時系列のイベント量、Delivery Overview(どのステップでイベントが落ちたかと、その理由)、デスティネーションごとの配信メトリクス、トラッキングプランとそのルール(Protocols)、コードを含む Functions、API 呼び出しと MTU の日次使用量、そして誰が何を変更したかを示す Audit Trail です。トラッキングプランには Protocols、Functions には Functions 機能、マッピングにはワークスペースの Destination Subscriptions が必要です。
シークレット: デスティネーションやウェアハウスの認証情報が入っていることが多い設定項目(API キー、シークレット、トークン、パスワード)は省かれます。ただし segment_get_source はソースの write key を返します。write key があれば誰でもそのソースにデータを送れます。
制限: Segment はトークン、IP アドレス、エンドポイントごとにリクエストを制限し、上限に達すると Retry-After ヘッダー付きの 429 を返します。より厳しいエンドポイントもあります。ウェアハウス同期は 1 分に 2 回、イベント量は 1 分に 60 回、トラッキングプランのルールとウェアハウスの接続状態は 1 分に 200 回までです。一覧は最大 1,000 件ずつのページで返り、AI はすべて揃うまで pagination.next をたどります。
インストール時は無効: segment_update_source と segment_update_destination はソースやデスティネーションの名前を変えたり、有効と無効を切り替えたりします。無効になったものは、再び有効にするまでデータを捨てます。segment_delete_source と segment_delete_destination は元に戻せません。これらのツールは管理者が意図して有効にするもので、有効にした後も AI は変更のたびに先にあなたに確認します。削除は、あなたが ID と名前を確認するまで実行されません。
よくあるエラー: 403 "Not authorized to perform this operation": トークンが間違っているか取り消されている、もう一方のリージョンのワークスペースのものである、Config API トークンである、またはロールがこのリソースをカバーしていません。401: トークンが送られていません。404: このワークスペースにその ID のリソースはありません。422: パラメーターが足りないか無効です。たとえば Delivery Overview の期間が粒度で許される長さを超えている場合です。機能に関するメッセージは、ワークスペースに Protocols、Functions、Destination Subscriptions のいずれかがないことを意味します。429: Retry-After の時間だけ待ってください。
このコネクタはイベントを送信しません。Segment の Tracking API は、別のホストでソースの write key を使います。また、ソース、デスティネーション、ウェアハウスの作成には対応せず、フィルター、変換、Reverse ETL、Engage のオーディエンスと computed traits、アクセス管理、削除と抑止の規制、カタログも扱いません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — ChatGPT にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
ChatGPT では、Web 版の Plugins ページから MCP サーバーをプラグインとして追加します。有料プランで利用でき、開発者モードはもう必要ありません。Business ワークスペースで追加できるのは管理者とオーナーだけです。Enterprise・Edu では、管理者が Create plugins with MCPs 権限を付与できます。
- chatgpt.com/plugins を開き、+ をクリックして Add custom MCP server を選びます。
- 名前を入力します(例: Name:
Twilio Segment)。 - Connection の Server URL に
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Authentication は OAuth のままにします。 - I understand and want to continue を選び、Create as a plugin をクリックします。ChatGPT に求められたら AnythingMCP にサインインし、アクセスを許可します。
- 個人用プラグインから新しいプラグインをインストールし、チャットで @ を入力して選択します。
利用可能なツール
| Tool | What it does |
|---|---|
segment_get_workspace | Get the Segment workspace the token belongs to (id, slug, name) |
segment_list_sources | List the workspace's sources (websites, apps, servers and cloud apps that send data) with id, name, slug, enabled flag, source type… |
segment_get_source | Get one source by id: name, slug, enabled flag, source type, labels, write keys, settings and the id of the tracking plan connected to it |
segment_list_source_destinations | List the destinations connected to one source (id, name, enabled flag, destination type) |
segment_list_source_warehouses | List the warehouses connected to one source (id, name, enabled flag, warehouse type) |
segment_get_source_schema_settings | Get a source's schema settings: whether unplanned track events, properties and traits are allowed or blocked, what happens on tracking plan… |
segment_list_destinations | List the workspace's destinations (tools Segment sends data to) with id, name, enabled flag, destination type, catalog metadata id and the… |
segment_get_destination | Get one destination by id: name, enabled flag, destination type, source id and its settings |
segment_list_destination_subscriptions | List the mappings (subscriptions) of an Actions destination: id, name, action, trigger (which events it fires on) and enabled flag |
segment_get_destination_delivery_metrics | Delivery metrics summary of one destination for one source: totals per metric (delivered, discarded, retried and so on) with breakdowns |
segment_list_warehouses | List the workspace's warehouses (id, name, enabled flag, warehouse type such as Snowflake, BigQuery, Redshift, Postgres) |
segment_get_warehouse | Get one warehouse by id: name, enabled flag, warehouse type and its connection settings without passwords, keys and other secrets |
segment_get_warehouse_connection_state | Check whether Segment can currently connect to a warehouse with its saved settings (e.g |
segment_list_warehouse_syncs | Recent sync reports of a warehouse for every connected source: source id, start and end, status, duration, rows synced and notices |
segment_list_tracking_plans | List the tracking plans (id, name, slug, description, type, created and updated) |
segment_get_tracking_plan | Get one tracking plan by id (name, slug, description, type, created and updated) |
segment_list_tracking_plan_rules | List the rules of a tracking plan: per event or trait the rule type, key, JSON Schema of the allowed properties, version and dates |
segment_list_tracking_plan_sources | List the sources connected to a tracking plan (id, name, slug, enabled flag, source type) |
segment_list_functions | List the workspace's Functions of one type (id, name, description, type, created) |
segment_get_function | Get one Function by id, including its JavaScript code, declared settings (names and types, not values) and type |
segment_get_event_volume | Event volume of the workspace over time: totals and series per bucket, optionally grouped by event name, event type or source and filtered… |
segment_get_delivery_overview | Delivery Overview counts for one step of a source's pipeline: successfully-received and failed-on-ingest (events reaching Segment)… |
segment_get_daily_api_calls_usage | Daily cumulative API call counts of the workspace for one usage month (the volume Segment bills on for API-based plans) |
segment_get_daily_mtu_usage | Daily cumulative monthly tracked users (MTU) of the workspace for one usage month: anonymous, identified, anonymous then identified and… |
segment_list_audit_events | List Audit Trail events (who changed what and when): id, timestamp, type (e.g |
segment_update_source | Rename a source or switch it on or off |
segment_update_destination | Rename a destination or switch it on or off |
segment_delete_source | Delete a source for good, with its settings and connections; data sent with its write key is no longer accepted |
segment_delete_destination | Delete a destination for good, with its settings and mappings |
プロンプトの例
- 「無効になっているデスティネーションはどれですか?それぞれどのソースから読み取っていますか?」
- 「iOS ソースの過去 24 時間の Delivery Overview と、イベントが落ちた箇所を見せてください。」
- 「過去 7 日間のソース別のイベント量の推移と、今月これまでに使った MTU を教えてください。」
- 「監査証跡によると、この 2 週間でソースやデスティネーションを変更したのは誰ですか?」
FAQ
ChatGPT の無料プランでカスタム MCP サーバーは使えますか? OpenAI がカスタム MCP サーバーを案内しているのは有料プランだけで、Free プランは対象に含まれていません。
次のステップ
このガイドは役に立ちましたか?