Zentrik

Zentrik Agent Plugin

チームが Zentrik に蓄積しているプロダクトの意思決定、顧客の根拠、プロダクトのコンテキストに AI エージェントを接続します。

リポジトリのルートは Agent Plugins v1 形式に準拠しており、本番環境用の Zentrik Streamable HTTP MCP サーバーと、再利用可能な 4 つのワークフローをまとめています。

• brief-product-work：ワークスペースに既存の根拠に基づいて、計画、スコープ設定、開発、レビューを行います。
• set-up-product-workspace：ワークスペースを調査し、承認済みで範囲が限定されたセットアップの差分のみを適用します。
• import-product-evidence：提供された通話記録、チケット、レビュー、フィードバック、調査内容を、書き込み前の承認ステップを経て取り込みます。
• manage-product-study：根拠に基づくドラフトの調査結果を通じて、非公開の Study を計画、調整、レビューします。

このプラグインには認証情報もローカル実行可能コードも含まれていません。MCP サーバーは Zentrik OAuth で認証し、各接続を選択した 1 つのワークスペースに紐づけ、接続ユーザーのロールと付与されたスコープを適用します。

適切な接続先を選ぶ

• ポータブルな Agent Plugins クライアントはリポジトリのルートを読み込み、広範な https://zentrik.ai/mcp エンドポイントに接続します。
• Codex は com.openai/zentrik にある OpenAI アダプターを読み込みます。このアダプターは、ChatGPT と Codex で利用可能な登録済みの Zentrik アプリに対応します。どちらのパッケージにも上記 4 つのワークフローが含まれていますが、アプリではより限定的な ChatGPT ツールプロファイルが使われます。
• MCP 専用クライアントは https://zentrik.ai/mcp に直接接続し、Zentrik OAuth を完了できます。
• サーバー間の自動化には、スコープを指定した API キーを使用し、バージョン管理された /external/v1 の REST API を利用してください。REST API は別途ドキュメント化されており、このプラグインには含まれていません。

互換性の契約と、接続先によって利用できるツールが異なる理由については、SURFACES.md を参照してください。

GitHub Copilot と VS Code

サーバーは Official MCP Registry に ai.zentrik/mcp として公開されています。手動で追加するには、.vscode/mcp.json（またはユーザーの MCP 設定）に次の内容を記述します。

{
  "servers": {
    "zentrik": {
      "type": "http",
      "url": "https://zentrik.ai/mcp"
    }
  }
}

サーバーを起動し、開いたブラウザーウィンドウで Zentrik にサインインして、この接続で使用できるワークスペースを選択します。その後、エージェントモードで Copilot に次のようなことを尋ねてください。

• 「顧客は一括エクスポートについてどのように話していますか？根拠を引用してください。」
• 「このブランチを変更する前に、その背景にある取り組みについて説明してください。」
• 「今四半期、顧客の根拠が最も多い未着手のアイデアはどれですか？」

根拠のインポートやレコードの更新などの書き込み操作は、Zentrik でのロールと、付与したスコープの範囲に制限されます。

Codex CLI

このリポジトリには、ローカル、Git、チームでの配布に使用する Codex マーケットプレイスカタログが含まれています。

codex plugin marketplace add Zentrik-AI/agent-plugins
codex plugin add zentrik@zentrik-agent-plugins

リポジトリのルートは、引き続きポータブルな配布物として使用されます。マーケットプレイスのエントリは Codex を com.openai/zentrik のクライアントアダプターに誘導します。これにより、OpenAI 固有のメタデータをポータブルマニフェストに含めずに済みます。

OpenAI ディレクトリへの公開

既存のディレクトリ掲載用にアダプターをパッケージ化するには、python3 scripts/package-openai-plugin.py --output zentrik-openai.zip を実行します。パッケージャーは、登録済みアプリのマッピングから技術名を取得します。ZIP には、4 つのスキル、アセット、ライセンスファイル、そしてポータブルマニフェスト形式の既存の ChatGPT MCP エンドポイントが含まれます。更新時もこのエンドポイントを必ず含めてください。既存の掲載情報が OAuth 設定を管理しているため、ZIP で上書きしてはいけません。 CLI マーケットプレイスでは、zentrik という名前と登録済みアプリのマッピングが維持されます。既存の掲載情報に、新しいメタデータおよびスキルのバージョンとして ZIP をアップロードしてください。サーバーのみの変更には、継続的な MCP レビューを利用します。

要件

Zentrik アカウントと、少なくとも 1 つの Zentrik ワークスペースへのメンバーシップが必要です。API キーは不要です。

ドキュメントとサポート

• Codex のセットアップ：https://zentrik.ai/docs/integrations/mcp-codex
• ChatGPT のセットアップ：https://zentrik.ai/docs/integrations/mcp-chatgpt
• MCP のセットアップ：https://zentrik.ai/docs/integrations/mcp
• MCP ワークフロー：https://zentrik.ai/docs/integrations/mcp-workflows
• サポート：[email protected]

ライセンス

Apache-2.0。配布リポジトリの LICENSE ファイルを参照してください。