AIチュートリアル

MCPと公開APIでAIクライアントをTetrees Agentに接続する

ホスト型Tetrees Agent MCPの設定方法、公開コントラクトの確認、API CLIの使用方法、見積もり済みAIパックの実行、ローカル拡張機能のバインド方法、認証情報や非公開機能を公開せずにサポート対象の販売者ワークフローに従う方法を学びます。

2026年8月31日約14分で読了

Tetrees Agent EXとは？

Tetrees Agent EXは、ホスト型Tetrees Agent MCPサーバーおよびAPIを通じてTetrees AI Packsを扱うための公開統合キットです。購入者、ビルダー、販売者向けに、クライアント、設定例、安全な拡張サンプルを提供します。

このキットが公開するのは、ホスト型サービスの内部実装ではなく、開発者向けの契約です。Tetrees Agentの実装詳細、非公開Packインテリジェンス、Agent AVCPのスコアリングルール、サービスプロンプト、モデレーションシステム、ストレージインフラ、プロダクション認証情報は含まれません。

Tetreesがホストする処理にローカルGPUは必要ありません。モデルを使用する実行は、開始前にTetrees Pointsで見積もられます。Packの取得後は、対応するプロバイダーキーをローカルMCPプロセスに指定することもできます。

構築できるもの

購入者およびオペレーター向けワークフロー

購入者とオペレーターは、公開契約を使用して次の操作を行えます。

AI Packカタログを検索する。
Packの公開Agent AVCPレポートとランタイムプロファイルを確認する。
Tetrees Pointsを消費する前に実行を見積もる。
Pointsで資金提供されるステートレスなプレビューでPackを試す。
無料Packを取得する、またはTetrees EXで有料Packを購入する。
所有する不変の.taipリリースをダウンロードする。

ビルダー向けワークフロー

ビルダーは、バインディングと認証情報をユーザーのマシン上に保持したまま、評価済みのPackをユーザー管理の機能に接続できます。対応パターンには、固定HTTPS API、ネストされたMCPサーバー、シェルを使用しないローカルスキルがあります。

販売者向けワークフロー

販売者は、出品の作成、不変のPackバージョンと画像のアップロード、準備状況の確認、Agent AVCPの実行、非公開の修正フィードバックの確認、評価に合格したリリースの公開を行えます。

前提条件

ホスト型MCP統合を設定する前に、次を準備してください。

Node.js 20以降。
Tetreesアカウントページから取得した、取り消し可能なAPIトークン。
ホスト型MCPサーバーを使用する場合は、MCP対応クライアント。
インスペクター、CLI、サンプル、検証コマンドを実行する場合は、リポジトリのローカルチェックアウト。

認証情報をPack、プロンプト、ソースファイル、共有MCP設定に含めないでください。任意のプロバイダーキーは、ローカルMCPプロセスの環境にのみ存在するようにしてください。

ホスト型MCPサーバーを設定する

次のサーバー定義をMCPクライアントの設定に追加します。プレースホルダーを、取り消し可能なTetreesアカウントトークンに置き換えてください。

{
  "mcpServers": {
    "tetrees-ai": {
      "command": "npx",
      "args": ["-y", "https://ex.tetrees.ai/pkg/tetrees-mcp.tgz?v=2.2.0"],
      "env": {
        "TETREES_API_URL": "https://ex.tetrees.ai/api",
        "TETREES_TOKEN": "<revocable-account-token>"
      }
    }
  }
}

設定を保存したら、MCPクライアントを再起動します。v=2.2.0というサフィックスにより、npxが同じURLの下でキャッシュされた古いtarballを再利用するのを防ぎます。この値は、Tetreesが新しいMCP契約を公開した場合にのみ変更してください。

安全なMCPリクエストを試す

有料実行を開始せずにPackを検索して見積もるよう、MCPクライアントに依頼します。

リポジトリの課題トリアージに使えるTetrees AI Packを検索してください。最適な候補の公開Agent AVCP
レポートとランタイムプロファイルを表示し、8k/2kのPointsで資金提供される
実行を見積もってください。見積もり上限を私が承認するまで実行しないでください。

このリクエストは、意図された安全パターンに従います。Packを見つけ、公開評価とランタイム要件を確認し、見積もりを依頼してから、Pointsを消費する前に明示的な承認を待ちます。

公開MCP契約を確認する

リポジトリのディレクトリで依存関係をインストールし、トークンをエクスポートして、MCPインスペクターを実行します。

npm install
export TETREES_TOKEN="txk_..."
npm run mcp:inspect

インスペクターは公式のホスト型MCPパッケージを起動し、公開ツールとリソースを一覧表示します。また、購入者、ビルダー、販売者向けの各サーフェスが想定どおり利用できるかを確認します。検査ではPointsを消費せず、アカウントの状態も変更しません。

公開API CLIを使用する

このプロジェクトは、秘密ファイルを自動的に読み込みません。CLIがファイルを読み込むことを期待せず、.env.exampleから必要な値をシェル環境にコピーしてください。

export TETREES_TOKEN="txk_..."

読み取り専用コマンドを実行する

まずは、モデル処理を開始せずにサービスとアカウントを確認するコマンドから始めます。

npm run tetrees -- status
npm run tetrees -- catalog "research"
npm run tetrees -- models
npm run tetrees -- skills
npm run tetrees -- owned
npm run tetrees -- runtime <pack-id>
npm run tetrees -- report <pack-id>

catalogでPackを探し、runtimeでランタイムプロファイルを確認し、reportで公開Agent AVCPレポートを確認します。modelsとskillsのコマンドでは対応する公開選択肢を確認でき、ownedではアカウントに関連付けられたPackを一覧表示します。

実行前に見積もる

見積もりによってモデルリクエストが開始されることはありません。選択したPackとモデルの識別子を指定します。

npm run tetrees -- quote <pack-id> <model-id>

実行を承認する前に、正確なモデル、トークン上限、ホスト型スキル、成長チェックポイント、見積もられたPointsのコミットメントを確認してください。

Pointsを消費する実行を確定する

実行を開始するには、正確な確認フラグを含めます。

npm run tetrees -- run <pack-id> <model-id> "Your task" --confirm-spend

ポイントで資金提供されるプレビューはステートレスで、未使用の予約済みポイントは返還されます。CLIは秘密情報のようなレスポンスフィールドを秘匿し、Tetreesのエラーコード、HTTPステータス値、Retry-After情報を報告します。ミューテーションを自動的に再試行することはありません。

購入者フローに従う

慎重な購入者ワークフローは、次の順序で進みます。

タスクに合ったPackを検索します。
公開されているAgent AVCPレポートとランタイムプロファイルを確認します。
正確なモデル、トークン上限、ホスト型スキル、成長チェックポイントを見積もります。
ポイントで資金提供されるステートレスプレビューを承認して実行します。
無料のPackを取得するか、Tetrees EXを通じて有料Packを購入します。
ダウンロード、BYOK、成長データの保存、クライアント拡張などの所有権特典を利用します。

リポジトリには、読み取り専用の検出および見積もり例がドキュメント化されています。

node examples/buyer/discover-and-quote.mjs "incident response"

incident responseを別の検索フレーズに置き換えると、異なる用途向けのPackを探せます。

ビルダーとしてローカル機能を追加する

公開済みのPackでは、Agent AVCPを通過したクライアント拡張を宣言できます。拡張の実際のバインディングと認証情報はローカルに残るため、Tetreesのホスティングがそれらの権限を引き継ぐことはありません。

バインディングパターンを選択する

https_api：宣言されたメソッドと環境変数で管理されるヘッダーを使用して、固定HTTPSベースURLに接続します。
mcp：シェルを使わずにネストされたMCPサーバーを起動し、宣言されたツール名にマッピングします。
local_skill：シェルを使わない子プロセスを起動し、1つのJSONリクエストを受け取り、1つのJSON結果を返します。

設定の出発点としてexamples/extensions/client-extensions.example.jsonを使用してください。リポジトリには、ローカルスキルの例としてexamples/extensions/local-skill/issue-summary.mjs、ビルダー向けの完全な契約としてdocs/BUILDER_GUIDE.mdも用意されています。

書き込みメソッドには、呼び出しごとに正確な承認フレーズAPPROVE extensionId.methodIdが必要です。一般的な会話上の承認を、書き込み実行の許可として扱わないでください。

販売者としてPackを公開する

販売者の手順は契約に基づきます。まず、Packを変更せずに準備状況とレポートを確認します。

node examples/seller/check-readiness.mjs <pack-id>

新しいリリースの準備ができたら、明示的な確認を添えて、より高い不変バージョンを1つアップロードします。

node examples/seller/upload-pack.mjs <pack-id> 1.1.0 ./release.taip --confirm-upload

アップロード後、ホスト型MCPツールまたはTetrees APIリファレンスを使用して公開ワークフローを完了します。

アップロードしたバージョンを提出します。
Agent AVCPの見積もりをリクエストします。
Agent AVCPを実行する前に、正確なポイント量を確認します。
非公開レポートと修正フィードバックを確認します。
評価に合格したダイジェストのみを公開します。

リスティングの準備時には、docs/SELLER_GUIDE.mdとexamples/seller/pack-listing.example.jsonを参照してください。

高度な安全性と信頼性に関するヒント

秘密情報を共有設定から分離する

Tetreesトークンと任意のプロバイダーキーは、ローカルプロセスの環境変数に保存してください。プロバイダーの認証情報を、共有される可能性のあるPack、プロンプト、ソースファイル、設定に決して埋め込まないでください。必要に応じてアクセスを取り消せるよう、失効可能なトークンを使用してください。

ミューテーションを自動的に再試行しない

失敗した書き込み操作については、対応を決める前に、報告されたTetreesのエラーコード、HTTPステータス、Retry-After値を確認してください。自動再試行によって、アップロード、購入、実行、その他の状態変更操作が繰り返される可能性があります。

ホスト型MCP契約を意図的に固定する

古いnpxキャッシュエントリを避けるため、MCPパッケージURLにドキュメント化されたクエリサフィックスを保持してください。正式に公開された契約バージョンに対応する場合にのみ更新してください。

公開境界を確認する

貢献する前に、SECURITY.mdとdocs/PUBLIC_BOUNDARY.mdを読んでください。貢献内容は、ドキュメント化された公開認証済み契約とのみやり取りし、Agentの内部、非公開のPackデータ、スコアリング用フィクスチャ、署名キー、データベース、管理API、デプロイインフラへのアクセスを前提としてはなりません。

リポジトリを検証する

変更を配布したりパッケージを準備したりする前に、提供されているチェックを実行してください。

npm test
npm run check:public-boundary
npm pack --dry-run

役立つ公開リファレンス

結論

Tetrees Agent EXは、Tetrees AI Packの検出、評価、実行、拡張、公開のための透明性の高い公開契約を提供します。まず読み取り専用の確認から始め、モデルで資金提供される処理の前に正確な見積もりを求め、支出と書き込みには明示的な確認を必須とし、ユーザー所有の認証情報と拡張権限はすべてローカルで管理してください。