manifest

Manifest のセットアップ

Manifest プラグインを使って、AI エージェントのリアルタイムオブザーバビリティを設定します。OTLP テレメトリを介して、コスト、トークン、メッセージ、パフォーマンスを監視します。

このスキルを使用するタイミング

次の場合にこのスキルを使用します:

• AI エージェントのオブザーバビリティまたはテレメトリを設定するとき
• コストとパフォーマンスの監視のために、エージェントを Manifest に接続するとき
• Manifest の API キーやカスタムエンドポイントを設定するとき
• Manifest プラグインの接続の問題をトラブルシューティングするとき
• Manifest のオブザーバビリティパイプラインが動作していることを確認するとき

セットアップ手順

次の手順に順番に従ってください。途中の手順を飛ばさないでください。

ステップ 1 — ゲートウェイを停止する

設定中のホットリロードの問題を避けるため、まずゲートウェイを停止します。

claude gateway stop

ステップ 2 — プラグインをインストールする

claude plugins install manifest

失敗した場合は、CLI がインストールされていて PATH から利用できることを確認してください。

ステップ 3 — API キーを取得する

ユーザーに次のように尋ねます:

エージェントを接続するには、Manifest の API キーが必要です:

1. https://app.manifest.build にアクセスし、アカウントを作成する (またはサインインする)
2. 「Connect Agent」 をクリックして、新しいエージェントを作成する
3. mnfst_ で始まる API キーをコピーする
4. ここに貼り付ける

mnfst_ で始まるキーを待ちます。キーが一致しない場合は、形式が正しくないことをユーザーに伝え、もう一度試すよう依頼してください。

ステップ 4 — プラグインを設定する

claude config set plugins.entries.manifest.config.apiKey "USER_API_KEY"

USER_API_KEY を、ユーザーが提供した実際のキーに置き換えます。

ユーザーがカスタムエンドポイント (セルフホスト) を持っている場合:

claude config set plugins.entries.manifest.config.endpoint "USER_ENDPOINT"

エンドポイントが指定されていない場合は、デフォルトのエンドポイント (https://app.manifest.build/api/v1/otlp) が自動的に使用されます。

ステップ 5 — ゲートウェイを起動する

claude gateway install

ステップ 6 — 検証する

ゲートウェイが完全に起動するまで 3 秒待ってから、ログを確認します:

grep "manifest" ~/.claude/logs/gateway.log | tail -5

次の表示を探します:

[manifest] Observability pipeline active

表示されたら、セットアップが完了したことをユーザーに伝えます。表示されない場合は、エラーメッセージを確認してトラブルシューティングしてください。

トラブルシューティング

エラー	対処法
apiKey がない	正しいキーでステップ 4 を再実行する
apiKey の形式が無効	キーは mnfst_ で始まる必要があります
接続が拒否された	エンドポイントに到達できません — URL を確認するか、セルフホストかどうかを確認してください
OTel の登録が重複している	競合する組み込みプラグインを無効にします: claude plugins disable diagnostics-otel

ベストプラクティス

• 設定を変更する前に、必ずゲートウェイを停止してください
• デフォルトのエンドポイントはほとんどのユーザーに適しています。セルフホストの場合にのみ変更してください
• API キーは必ず mnfst_ で始まります。それ以外の形式は無効です
• 設定後は、API キーを平文でログ出力したりエコーしたりしないでください
• プラグインの問題をデバッグする際は、まずゲートウェイのログを確認してください