Prism — Crossdeck

---

Prism の違い

ほとんどの MCP サーバーは、1つのシステムにつなぐコネクターです。Prism はアプリ全体を対象としたインテリジェンスレイヤーです。Crossdeck はすでに、ユーザーに関する各レイヤー（ID · 収益 · エンタイトルメント · エラー · アナリティクス · データベースの読み取りコスト）を、ID ごとに1つの信頼できる情報源へと結び付けているからです。

重要なのは「AI にデータを読ませる」ことではありません。レイヤーを横断できることです。1つの質問で、他のどのツールも結び付けられないレイヤーをまたいで回答できます。

「このエラー a1b2c3 の影響を受けたのは誰で、そのうち何人が課金していますか？」 → クラッシュの影響を受けた、名前が特定された有料ユーザーと、それぞれ危険にさらされている月間収益を、損失の大きい順に表示します。

これこそが、他にはない強みを表す一文です。Prism は Claude、ChatGPT、Cursor、その他あらゆる MCP クライアントで、その一文に声を与えます。

---

権限とデータアクセス

稼働中の Crossdeck ワークスペースへ、安全な読み取り専用アクセスを提供します。 Prism は読み取りますが、書き込みは行いません。

Prism が確認できる情報（Crossdeck がすでにアプリについて把握しているレイヤー）：

💷 収益	MRR、有料顧客数、決済レールごとの内訳
🐛 エラー	問題、影響範囲、影響を受けたユーザー
📈 アナリティクス	ホストごとのページビュー、ユニーク訪問者、人気ページ／リファラー
🗄️ 読み取りコスト	操作ごとの、ユーザー起因とオーバーヘッドのデータベース読み取り
🧭 カスタマージャーニー	1人の顧客を対象とするレイヤー横断ビュー（支払い × エンタイトルメント × コスト）

行レベルの顧客 IDが返されるのは、接続にそのスコープが明示的に許可されている場合のみです。許可されていない場合、Prism は集計値から回答し、そのことを明示します。この境界は Crossdeck によって適用され、モデル任せにはなりません。

Prism は、プロジェクト内の何かを作成、変更、削除、設定することはできません。書き込み経路はなく、すべてのツールは読み取り専用です（readOnlyHint: true）。何かを変更するよう依頼しても、変更できないことを伝えます。

データは OAuth で保護されたエンドポイントを介して、質問のたびにリアルタイムで取得されます。コネクターには何も保存されません。

---

60 秒で接続

リモート（推奨） — ワンクリック OAuth、キーの貼り付け不要

Prism は、ホスト型の OAuth 保護 MCP エンドポイントです。

https://api.cross-deck.com/mcp

クライアントにコネクターとして追加し、Crossdeck アカウントでサインインして、プロジェクトを選択し、承認してください。これだけで完了です。クライアントには、スコープが限定された短期間有効のワークスペース認証情報が自動的に渡されます。

• Claude（ウェブ／デスクトップ）： Settings → Connectors → Add custom connector → 上記の URL を貼り付けます。
• ChatGPT： Settings → Connectors → Add → URL を貼り付けます。
• Cursor： Settings → MCP → Add → URL を貼り付けます。

または、ダッシュボードの app.cross-deck.com → Developers → Prism → Connect AI を開くと、「Add to Claude / ChatGPT / Cursor」をワンクリックで実行できます。

ローカル（Claude Desktop / Cursor / Claude Code）— stdio とシークレットキー

インストール手順は不要です。起動のたびに npx がパッケージとその依存関係を取得するため、自動で修復され、常に最新の状態が保たれます（ローカルに古くなるものはありません）。

{
  "mcpServers": {
    "crossdeck": {
      "command": "npx",
      "args": ["-y", "@cross-deck/ai"],
      "env": { "CROSSDECK_SECRET_KEY": "cd_sk_live_…" }
    }
  }
}

ダッシュボード → API キーから取得したシークレットキー（cd_sk_）を使用してください。パブリッシャブルキー（cd_pub_）は使用しないでください。CROSSDECK_API_BASE を設定すると、エンドポイントを変更できます（例：サンドボックス）。

コネクターに「failed」／「Server disconnected」と表示される場合、既知の原因が2つあります。どちらも対処できます。

1. spawn npx ENOENT／コマンドが見つからない。 デスクトップクライアントは、Node の bin が含まれていないことが多い最小限の PATH で起動します（nvm でよく発生します）。対処方法：command に npx の絶対パスを指定します。which npx を実行し、完全なパス（例：/Users/you/.nvm/versions/node/vX/bin/npx）を貼り付けてください。
2. ERR_MODULE_NOT_FOUND … @modelcontextprotocol/sdk。 これは、args が手作業で作成したローカルチェックアウト（…/dist/server.js）を指している場合にのみ発生します。そのフォルダーの node_modules が削除されることがあります（例：/tmp 以下のもの）。対処方法：ローカルビルドを指定しないでください。 上記の npx -y @cross-deck/ai に公開済みパッケージを解決させることで、依存関係が常に存在する状態になります。

最も簡単なのは、このセクションの冒頭にあるリモートコネクターを使うことです。ローカルで Node を一切実行しないため、どちらの問題も発生しません。

---

まずはお試しください

質問	ツール	得られる情報
「Stripe／Apple／Google 別の内訳を含む、MRR と有料顧客数は？」	get_revenue	MRR、有料顧客数、3つの決済経路別の内訳、オプションの日次推移
「このエラー a1b2c3 の影響を受けたのは誰で、そのうち支払いをしている人はいる？」	get_error_affected_users	クラッシュに関係する有料ユーザーの名前と、それぞれのリスクにさらされている月間収益
「顧客 agent_8842 に関する情報をすべて表示して。」	open_moat_dashboard	支払い額 × 権限 × 読み取りコストを、ID で結合したレンダリング済みダッシュボード
「過去30日間のユーザー増加をグラフにして。」	draw_user_growth	訪問者数とページビューを示すレンダリング済みのインタラクティブな折れ線グラフ
「データベースの読み取りを増やしている要因は？ユーザーごとの分とオーバーヘッドの内訳は？」	get_read_cost	ユーザーごとの読み取りとオーバーヘッドの内訳、および操作別の読み取り数

データツールは整った JSON を返します。draw_user_growth と open_moat_dashboard は、MCP Apps に対応するホストではインタラクティブなグラフ／ダッシュボードをインラインでレンダリングし、それ以外のホストではテキストの概要を表示します。

---

ツール

13 個のツールすべてが 読み取り専用（readOnlyHint）です。それぞれに、人が読める title、範囲指定・ページ分割された出力、対処可能なエラーが用意されています。すべての読み取りは、維持管理されている台帳へのポイント読み取りです。そのため、質問してもデータベースの利用料金は発生しません。

すべての数値は自己記述型です。値には meta.semantics の説明と coverage の状態が付属するため、メトリクスの内容が正確に示され、観測できていない領域（not_instrumented）を実際のゼロと誤認することはありません。

ポートフォリオ

• list_projects — このコネクターが読み取れるすべてのアプリを一覧表示します（ポートフォリオ）。
• get_portfolio — カバレッジマップです。アプリごとに、計測対象の領域と観測できていない領域を示します。後続の読み取り結果が空の場合に、事実ではなく既知の観測できていない領域だと判断できるよう、最初に読み込んでください。
• use_project — 後続のツールで使用する現在のアプリを設定します（「に切り替え」）。

収益とコスト

• get_revenue — MRR、有料顧客数、決済経路別（Stripe／Apple／Google）の内訳、任意の日次推移を取得します。
• get_customers — 顧客数の集計です。有料顧客数（および計測されている場合は合計数／アクティブ数）を取得します。「このアプリの顧客数はいくつか」という質問への基準となる回答です。
• get_read_cost — データベースの読み取りコストを、操作別にユーザーごとの読み取りと帰属先不明のオーバーヘッドに分けて取得します。

強み — エラー × ID × 収益

• get_error_impact — 1 つのエラーについて、影響を受けた一意のユーザー数と、そのうちの有料顧客数を取得します。
• get_error_affected_users — エラーの影響を受けた名前付き有料ユーザーを、各ユーザーの月間収益および最終発生時刻とともに、リスクにさらされている収益の高い順で返します。お客様自身の識別子のみを返します。お客様が提供していないメールアドレスや名前は返しません。
• get_customer — Crossdeck が ID に基づいて結合するすべてのレイヤーを横断して、1 人の顧客について取得します。支払い額 × アクティブな利用権 × 読み取りコストを確認できます。

アナリティクス

• get_host_analytics — お客様が所有するホスト／サブドメインのページビューとユニーク訪問者数を取得します（任意で日次系列も取得できます）。
• get_host_top_pages — お客様が所有するホストの上位ページまたはリファラーを取得します。

レンダリングされた UI（MCP Apps）

• draw_user_growth — 訪問者数とページビューの時間推移を示すインタラクティブな折れ線グラフを描画します。
• open_moat_dashboard — 顧客のレイヤー横断ダッシュボード（支払い × 利用権 × 読み取りコスト）をカード形式で表示します。

---

セキュリティ

Prism は、Crossdeck の銀行水準のアウトバウンド読み取り基盤上に構築されています。全体像については SECURITY.md をご覧ください。概要は次のとおりです。

• OAuth 2.1 + PKCE（S256）、動的クライアント登録、更新トークンのローテーションと再利用検出を備えた有効期間の短い（1 時間）ワークスペース認証情報を使用します。長期間有効なシークレットがダッシュボードの外に出ることはありません。
• 読み取り専用です。 すべてのツールが readOnlyHint: true であり、書き込みや設定変更は行いません。
• スコープ指定とフェイルクローズ。 トークンから所有者 1 人とその所有プロジェクトを特定します。トークンがない場合や無効な場合は、対処可能な 401 を返し、データを黙って返すことはありません。
• お客様自身のデータのみです。 Prism はトークンでスコープされた、お客様自身のプロジェクトデータを読み取ります。会話履歴やローカルファイルを読み取ることはなく、お客様自身の識別子のみを返します。お客様が提供していない個人を特定できる情報（PII）は返しません。

---

既知の制限事項

• v1 では読み取り専用です。書き込み／設定変更は、後日、別途制御された段階で提供されます。
• ホストごとのアナリティクスを利用するには、そのホストがお客様のプロジェクトの検証済みオリジンである必要があります。
• グラフのレンダリングには MCP Apps 対応ホストが必要です。それ以外ではテキストの要約が表示されます。
• レポートに反映されるのは Crossdeck の接続後のデータです（過去データのバックフィルは別途行われます）。

---

リンク

• npm： https://www.npmjs.com/package/@cross-deck/ai
• API リファレンス： https://cross-deck.com/docs/reporting-api/
• セキュリティ基盤： https://cross-deck.com/docs/outbound-api-security/
• プライバシー： https://cross-deck.com/legal/privacy/
• サポート： [email protected]

ライセンス

MIT © Crossdeck