メインコンテンツへスキップ
ターミナルやスクリプトから Phaseo を変更するには CLI を使い、AI クライアントに Phaseo の最新データを渡すには Phaseo MCP サーバーに接続します。どちらも Phaseo OAuth でログインします。

Phaseo CLI

インストールしてログインする

対話型のターミナルでは、既定でブラウザーによる OAuth を使います。SSH、CI、ヘッドレス環境では、デバイス認可を使います。

よく使う操作

別のツールやスクリプトで構造化された出力が必要な場合は --json を使います。シークレットの値は、明示的に作成または表示するコマンドでのみ表示されます。

Phaseo CLI ガイド

認証の方法、キーの管理、ワークスペース、ガードレール、コマンドの一連の流れを確認できます。

Phaseo MCP

サーバーの URL は https://mcp.phaseo.app/mcp です。これに接続した AI クライアントは、モデル、価格、プロバイダー、使用量、ワークスペースの最新データを使って質問に答えられます。

クライアントを接続する

ワンクリックでインストール:Cursor に追加 · VS Code に追加。クライアントからサインインを求められると、ブラウザで Phaseo OAuth が開きます。ワークスペースを選び、要求された読み取りスコープを承認してください。
続けて /mcp を実行し、phaseo を選んで Authenticate を選択します。すべてのプロジェクトで使うには --scope user を付けます。
他の MCP クライアントでは、同じ URL をリモートの Streamable HTTP サーバーとして追加します。クライアントは、OAuth ディスカバリー、S256 PKCE を使う認可コード、MCP の resource パラメーターに対応している必要があります。

Phaseo CLI のログインを使う

Phaseo CLI をすでに使っている場合、ローカルのエージェントは CLI を通じて MCP に接続できます。もう一度ログインする必要はありません。
phaseo mcp は CLI のログインを使って MCP を stdio で実行します。このログインを、MCP でのみ使える 15 分間有効なトークンに交換します。このトークンがログインより多くのアクセス権を持つことはなく、有料のモデル呼び出しも許可しません。--manage を付けない限り読み取り専用です。phaseo setup codex を実行すると、Codex の Phaseo プロファイルに自動で追加されます。この方法で接続したエージェントがログ、アクティビティ、分析を読み取ると、結果には全データを取得するための対応する CLI コマンドも表示されます。

MCP が読み取れるデータ

読み取り専用のツールは、モデル、プロバイダー、ベンチマークのランキング、価格とコストの見積もりに加えて、クレジット、アクティビティ、分析、リクエストのログ、生成のメタデータを扱います。プロンプト、レスポンス、シークレットの値は決して返しません。

アカウントを管理する(任意)

エージェントに Phaseo のワークスペースを変更させるには、代わりに管理用の URL で接続します。 https://mcp.phaseo.app/mcp?access=manage
ログインすると、同意画面に接続が要求する各権限(API キーの管理や予算の削除など)が一覧表示され、それぞれに 読み取り、書き込み、削除 のいずれかが表示されます。不要な権限はチェックを外してください。エージェントは許可した権限のツールだけを受け取り、Phaseo は変更のたびにワークスペースのロールも確認します。そのため、オーナーや管理者でないメンバーは、この方法で管理者専用の設定を変更することはできません。 すでに読み取り専用の URL で接続している場合は、クライアントを管理用の URL に切り替えて、もう一度ログインします。読み取り専用のアクセスに戻すには、通常の URL で再接続するか、設定 → 接続アプリ でアプリを取り消します。 管理用の接続は以下のすべてを読み取れますが、変更できるのは API キーとワークスペースの設定だけです。予算、支出ルール、プロバイダーキー、ガードレール、プリセット、Webhook、可観測性の送信先は、支出やリクエスト内容の送信先を左右するため、ダッシュボードまたは管理キーで変更します。 何かを変更または削除するツールにはその旨が示されるため、対応する MCP クライアントは呼び出しのたびに確認を求めます。新しい API キーはツールの結果に一度だけ表示され、再表示はできません。保存済みのプロバイダーキーや送信先の認証情報が返されることはありません。 MCP には、請求、支払い、ワークスペース、メンバー、管理キー、OAuth アプリのツールはありません。これらにはダッシュボード、CLI、または Management API を使ってください。

Docs MCP

Docs MCP は、Phaseo のドキュメントを検索して読むための別のエンドポイントです。アカウントやワークスペースにはアクセスしません。

Docs MCP ガイド

ドキュメントサーバーを Codex、Claude Code、Cursor、OpenCode、VS Code に接続します。

Phaseo プラグイン

Phaseo プラグインには、Phaseo MCP、Docs MCP、そして連携、移行、モデル選択、使用量の監視、SDK、CLI のための Phaseo エージェントスキルがまとめられています。各要素を自分で接続する代わりに、一度インストールするだけで済みます。

Claude Code

/mcp を実行して plugin:phaseo:phaseo にログインし、Phaseo アカウントを接続します。スキルはリクエストが一致したときに読み込まれます。/phaseo:phaseo-gateway のように直接実行することもできます。

Codex

最後のコマンドで、Phaseo MCP 用の Phaseo OAuth が開きます。スキルはリクエストが一致したときに読み込まれます。
最終更新日 2026年11月16日