分析エンジンが、そのまま MCP サーバーに
Phaide が Model Context Protocol（MCP）に対応しました。製品内のチャット分析を支えているエンジン — コード実行と自動データ探索の組み合わせ — を、外部のチャットボットやエージェントから呼び出せる MCP サーバーとして公開します。
MCP Inspector、Python の fastmcp クライアント、あるいは自社のエージェント基盤といった MCP 対応ホストを接続すれば、組織のデータに自然言語で問いを投げ、構造化された回答を受け取れます。通信はすべて 1 つの Streamable HTTP エンドポイント https://api.beta.phaide.ai/v1/mcp/ を経由し、認証には Phaide ですでに管理している開発者 API キーをそのまま使います。新たな認証基盤を用意する必要はありません。
サーバーが提供するツールは 5 つです。run_phaide_agent は分析を起動して即座に run_id を返します。get_phaide_agent_result はその実行が終わるまでポーリングし、回答（Markdown）と、生成されたグラフ・表への参照を返します。render_phaide_plot と render_phaide_table はその参照を Plotly のグラフや表として描画します。そして get_phaide_context は、スキーマ・蓄積されたメモリ・アップロード済みファイルを 1 回の呼び出しでまとめて返すため、エージェントは問いを立てる前に文脈を把握できます。MCP の Resources に対応したクライアントは、同じ Context Layer を phaide:// URI から読み取ることもできます。
内部では、各実行は製品内チャットを支えているものと同じ分析エージェントを動かし、同じコード実行と探索の能力を使います。つまり、エージェントが投げられる問いは、チームがすでに Phaide に尋ねている問いそのものです。売上による商品のランキング、指標のセグメント別の内訳、値の時系列推移、あるいは接続済みデータをまたいだ追加質問の連鎖まで、そのまま扱えます。
一度の統合で、ガバナンスと可視化を両立
Phaide は標準プロトコルを実装しているため、統合は一度きりで、あらゆる MCP ホストに届きます。チームがすでに使っているエージェントが、専用コネクタもデータベースの再公開もなしに、社内データへ問い合わせられるようになります。
アクセスは常に統制下にあります。各キーは所属する組織に自動的にスコープされるため、エージェントが見られるのはそのキーに許可されたデータだけです。他組織の実行結果や Artifact を参照しようとしても「見つからない」扱いになり、情報は漏れません。キーには有効期限を設定でき（1 時間から 1 年、セルフホスト向けには無期限も選べます）、どのキーも即座に失効できます。失効すれば、そのキーを使うすべてのアプリケーションが一斉にアクセスを失います。
返ってくるのは生のデータ行ではありません。各実行は文章による回答に加えて Artifact を返し、MCP Apps に対応したホストでは、その Artifact が会話の中でインタラクティブな Plotly グラフや整形済みの表として描画されます。非対応のホストでも、同じツールがグラフ・表の元データ（JSON）を返すので、自前で描画できます。
設計は、呼び出しをブロックするよりも信頼性を優先しています。分析は非同期で実行され、run_phaide_agent は一瞬で run_id を返し、結果はポーリングで取得します。そのため、時間のかかるクエリでも接続を開いたまま保持したりタイムアウトしたりしません。結果のペイロードも軽量に保たれます。実行はグラフ・表の実データをインライン展開せず参照のみを返し、描画したいときに初めて Artifact 本体を取得します。トランスポートはステートレスで、複数マシン構成でも接続が安定し、セッションが特定のプロセスに固定されることに依存しません。
API キー発行から最初の回答まで、数分で
接続に必要な手順は、Phaide の中でわずか数ステップです。
- アカウントメニュー（ サイドバー左下のイニシャル）を開き、デベロッパーを選びます。開発者設定が開き、APIキー / MCP / REST API の 3 つのタブが並びます。
- APIキータブで APIキーを作成 をクリックします。ラベルを付け、有効期限（1時間 / 1日 / 7日 / 30日 / 1年 / 無期限）を選んで確定します。キーはセキュリティのため一度しか表示されないので、その場でコピーしてください。
- MCP タブに切り替えます。エンドポイント、トランスポート（Streamable HTTP、ステートレス）、認証ヘッダ、提供ツール、そして Python・MCP Inspector・設定ファイル向けのコピー可能なスニペットが掲載されています。
- MCP クライアントを
https://api.beta.phaide.ai/v1/mcp/に向け、キーをAuthorization: Bearer ph-v1-…として送信します。先にキーの有効性を確認したい場合は REST の identity エンドポイントを呼びます。200 が返ればそのキーはその環境で有効です。 - エージェントから
run_phaide_agentに依頼文を渡し、get_phaide_agent_resultが終了状態を返すまでポーリングし、各artifact_idをrender_phaide_plotまたはrender_phaide_tableに渡して図・表を表示します。
これが一連の流れです。問いを入れれば、グラフと表を伴う回答が返り、すべてがキーの背後にある組織にスコープされています。
あなたのデータを、エージェントが働く場所へ
分析が 1 つの画面の中に閉じ込められている必要はありません。MCP API を使えば、これまで Phaide に打ち込んでいた問いを、チームが毎日使っている AI エージェントがそのまま答えられるようになります。しかも、統制され、組織にスコープされ、可視化された形で。キーを発行し、エンドポイントを貼り付け、エージェントに問いを投げさせてみてください。
FAQ
開発者 API キー以外に必要なものはありますか？
ありません。MCP エンドポイントは REST API と同じ ph-v1-… 開発者 API キーで認証します。APIキータブでキーを作成し、Bearer トークンとして送信してください。
キーはどこで発行・管理しますか？ Phaide でアカウントメニュー（サイドバー左下のイニシャル）→ デベロッパー → APIキー を開きます。ここでキーを作成し、各キーのラベル・マスク表示された値・ステータス・最終使用日時を確認でき、失効も行えます。
対応している MCP クライアントは？
Streamable HTTP に対応し、Authorization ヘッダを送れるクライアントであれば利用できます。例えば MCP Inspector、Python の fastmcp クライアント、mcp-remote のような設定ファイル型ランチャーなどです。Phaide の MCP タブにはそのまま使えるスニペットがあります。
グラフが描画されないのはなぜですか？
描画は MCP Apps に対応したホストでのみ行われます。非対応のクライアントでは、render_phaide_plot と render_phaide_table がグラフ・表のデータを JSON で返し、ホストが描画に未対応である旨の注記が付きます。そのデータから自前で描画できます。
自分のデータは他組織から隔離されていますか？ はい。各キ ーは所属組織にスコープされ、他組織に属する実行や Artifact は「見つからない」扱いになります。結果を返す前にマスキングは解除されます。
キーが期限切れ・失効するとどうなりますか？ そのキーは即座に認証を通らなくなり、使用中のアプリケーションは一斉にアクセスを失います。失効は取り消せないため、復旧するには新しいキーを発行してください。
MCP ではなく素の REST でも同じことはできますか？
はい。REST API タブには /v1 のエンドポイント（インジェスト・エージェント実行・Artifact・コンテキスト）が掲載されています。これらは同じエンジンと同じ API キーを共有し、MCP を使わないクライアント向けに提供されています。