Agentry.sh Observability

Agentry.sh Observability MCP サーバー

Agentry.sh Observability は、コーディングエージェントにエラー、プロダクト分析、デプロイのアトリビューションを扱うための単一の HTTP API を提供します。この MCP サーバーにより、Agentry の正式なコントラクトを MCP クライアントで簡単に確認できます。

このサーバーについて

これは、小規模なディスカバリーおよび引き継ぎ用サーバーです。エージェントを、最新の簡潔なリファレンス、機能一覧、正確な OpenAPI スキーマ、自動化ガイドとフロー、変更不可のプレイブックカタログ、インストールガイドへ誘導するリソースを公開します。

リソースは参照先であり、キャッシュされたコピーではありません。最新の HTTP ドキュメントと OpenAPI スキーマが引き続き正式な情報源であり、このパッケージを再公開しなくても更新される場合があります。

このサーバーではないもの

Agentry API のプロキシ、SDK、認証情報ブローカー、テレメトリ転送機能、自動化スケジューラーではありません。認証情報を保持したり、本番データを照会したり、スケジュールを登録したり、コーディングエージェントを実行したり、プルリクエストを作成したり、マージ、デプロイ、通知の配信を行ったりすることはありません。エージェントは選択した正式なコントラクトを取得し、Agentry HTTP API を直接呼び出します。

静的ドキュメントは MCP リソースとしてモデル化されています。また、クライアントが MCP リソースを自動的に挿入しない場合でも、エージェントが本番データに関する問題を識別できるよう、モデルが制御するルーティングツール discover_agentry も公開しています。このツールが返すのは参照先のみで、API アクションではありません。

ツール

discover_agentry は、install、debug、analytics、deploy、automation のいずれかのインテントを受け付けます。その問題に対応する最小限の正式なリソースと最新の URL を、テキストと構造化コンテンツの両方で返します。MCP アノテーションでは、読み取り専用、非破壊的、冪等として示されています。認証情報の読み取り、本番データの照会、変更操作は一切行いません。

この MCP の引き継ぎによって新しいデバイス認証のサインアップが開始される場合は、POST /v1/auth/device に "distribution_surface":"mcp" を渡してください。このフィールドはアトリビューション専用であり、認証情報の権限が変わることはありません。

リソース

まず agentry://handoff を確認してください。簡潔なインテントルーターと権限の境界が記載されています。

リソース	正式な契約
agentry://handoff	インテントルーター、MCP の境界、認証情報の対応表
agentry://reference	日常利用向けの簡潔なリファレンス：https://agentry.sh/agentry.md
agentry://capabilities	マシン機能の対応表：https://api.agentry.sh/v1/capabilities
agentry://openapi/index	小規模な OpenAPI 検索インデックス：https://api.agentry.sh/v1/openapi.json?index=true
agentry://openapi	完全かつ正確な OpenAPI 3.1 スキーマ：https://api.agentry.sh/v1/openapi.json
agentry://automation/guide	自動化 v2 の人間向けガイド：https://api.agentry.sh/v1/docs/automation
agentry://automation/flow	依存関係順に並んだ正確な自動化スキーマ：https://api.agentry.sh/v1/openapi.json?flow=automation
agentry://automation/playbooks	不変のバージョン管理されたプレイブックカタログ：https://api.agentry.sh/v1/automation-playbooks
agentry://install	正式なインストール案内：https://agentry.sh/install.md

インストール用リソースには、https://api.agentry.sh/v1/openapi.json?flow=onboarding への案内もあります。このフローはサーバーが管理する単一の状態マシンです。現在の状態を読み取り、唯一の next_action.instruction、順序付きチェックリスト、正確な操作のみを実行し、installation_complete: true かつ next_action: null になるまで繰り返します。next_action.id: "review_exact_plan" の時点で、人間が単一の /review チェックポイントを使用し、ソースに基づく正確なビジネス上の質問、価値の流れ、エラー、デプロイ先、プランのハッシュを承認するか、プランを差し替えます。ツールの出力は承認ではありません。

証明を開始する前に、選択した永続的なブラウザー用の公開認証情報と CI 認証情報を設定し、承認済みプランで server_ingest を使用する場合に限り、サーバー認証情報も設定してください。プロジェクトの作成時に public_api_key が返されます。認証情報の復旧、検証、ローテーションには、プロジェクトの /public-key 操作を使用してください。証明の開始時には、実行時用と CI 用の、互いに異なるレスポンス専用の X-Agentry-Onboarding-Proof マーカーが返されます。マーカーは証明の期間を指定するだけで、権限を付与しません。そのため、各リクエストには引き続きスコープが限定された永続的な認証情報が必要です。ブラウザーで証明を行う場合は、実行時マーカーを証明用タブの sessionStorage.agentry_onboarding_proof にのみ設定してください。公開環境変数やバンドルに埋め込んではいけません。承認済みの実際の価値の流れ、安全なエラーを 1 つ、レビュー済みの CI／プロバイダーによるデプロイを実行し、その後 verify を呼び出して、構造化された残りの分析、安全なエラー、デプロイの各グループに従ってください。完了には、現在の status: "verified"、installation_complete: true、next_action: null が必要です。合成した証明や呼び出し元が作成した証明は認められません。

use_agentry だけがプロンプトです。クライアントに、ハンドオフを読み取り、ユーザーのインテントに合った最小限の正式なリソースを選び、正確な OpenAPI を確認し、適切なスコープの認証情報を使って HTTP を呼び出すよう指示します。

認証情報の境界

MCP サーバーはこれらの認証情報を読み取りません。これらはエージェントが Agentry HTTP API を呼び出す場合にのみ適用されます。

• public_api_key（agentry_pk_）は公開可能で、ブラウザー／クライアントのエラーと分析データの取り込みのみを書き込みます。
• agentry_server_ は信頼されたアプリケーションサーバーのテレメトリを書き込みます。
• agentry_ci_ は、信頼された CI／プロバイダーの自動化から、デプロイの帰属情報、ソースマップ、プロバイダーが観測した自動化の証明を書き込みます。
• agentry_runner_ は取り消し可能で、無人自動化 1 件に紐付けられます。
• agentry_sk_ は読み取り、ポリシー、認証情報のライフサイクル、承認に使用する人間／オーナー用のキーです。スケジューラーに置くものではありません。

認証情報の種類によって、サーバー上での権限が決まります。テレメトリはあくまで証拠であり、信頼された送信元が送信したというだけで指示に変わることはありません。

日々の製品に関する質問では、まずサーバーが管理する保存済みシグナルマップを確認し、GET /v1/projects/:project_id/onboarding が現在の検証済み状態を返すことを必須としたうえで、ライブイベント名、必須プロパティキー、実際の行を確認してください。オンボーディングによって、リポジトリ内に Agentry の状態バンドル、証明バンドル、レシートは作成されません。インストール時には、ルートの AGENTS.md ポインター（および対応するリポジトリ内ハーネスアダプター）が保持されるため、今後のコールドスタート時にエージェントがリポジトリ全体を再スキャンせずとも、サーバー管理のプランと検証済みレシートを見つけられます。

自動化の引き継ぎ

自己修復ソフトウェアやスケジュールされたファネルレビューでは、自動化リソースを 3 つすべて読み取ってください。ガイド、正確なフロー、プレイブックカタログです。カタログは不変で、バージョン管理されています。プレイブックのレンダリングによって副作用が生じることはありません。決定論的なポリシー、状態、証明、レポート、キルスイッチは Agentry が管理します。外部スケジューラー／コーディングエージェントは、限定されたランナーと、人間の承認を受けたプロバイダー境界のもとで、推論とプロバイダー操作を担います。

MCP サーバーを実行する

npx -y @agentrysh/mcp

汎用 MCP クライアント設定：

{
  "mcpServers": {
    "agentry": {
      "command": "npx",
      "args": ["-y", "@agentrysh/mcp"]
    }
  }
}

接続したら、モデルルーティングによる検出には discover_agentry を呼び出すか、リソースを一覧表示して agentry://handoff を読み取ってください。各エージェントハーネスで現在使用できるネイティブアダプターパスについては、https://api.agentry.sh/adapters を参照してください。

公開リンク

• ウェブサイト：https://agentry.sh/?distribution_surface=npm_readme
• NPM パッケージ：https://www.npmjs.com/package/@agentrysh/mcp
• リポジトリ：https://github.com/fr33dr4g0n/agentry-public
• 正式なスキル：https://agentry.sh/skill/agentry/SKILL.md
• アダプターマニフェスト：https://api.agentry.sh/adapters
• MCP レジストリ名：io.github.fr33dr4g0n/agentry-observability