JoinLayer

JoinLayer Agent Toolkit

JoinLayer の公式エージェント連携機能です。ホスト型 MCP ゲートウェイ、joinlayer-pipelines スキル、クライアントプラグインのメタデータ、安全なスタータープロンプト、公開プロトコルテストを提供します。

サポート対象のサービスは、JoinLayer がホストする次のエンドポイントです。

https://mcp.joinlayer.app/mcp

これは[公式 MCP Registry の app.joinlayer/mcp]として公開されています。運用スキルは skills.sh から入手でき、このリポジトリは JoinLayer Codex および Claude Code マーケットプレイスの正式なソースです。

クライアントは、PKCE を使用するブラウザー OAuth Authorization Code フローで認証します。JoinLayer のベアラートークンを手動で作成、貼り付け、または設定しないでください。

2 分で開始

最初にドキュメント全体を読む必要はありません。 START_HERE.md を開いて JoinLayer に接続し、読み取り専用の検査プロンプトをコピーしてください。その後、目的に合ったすぐに実行できるプロンプトを選択します。

このリポジトリの内容

• skills/joinlayer-pipelines：エージェントの運用ガイダンスとタスクのリファレンス。
• .codex-plugin/plugin.json、.claude-plugin/、および .mcp.json：インストール可能な Codex および Claude Code プラグインのメタデータ。
• prompts：一般的な JoinLayer タスク向けの安全な開始点。
• use-cases：証拠と停止境界を含む、顧客の成果を実現する一連の手順。
• mcp-gateway：ホスト型 MCP のセキュリティ境界を確認できるスナップショット。
• server.json：ホスト型リモートサーバーの MCP Registry メタデータ。

ゲートウェイのソースは、透明性と互換性のレビューを目的として公開されています。これはセルフホスト可能な JoinLayer の配布物ではありません。このリポジトリには含まれていない、非公開で認証が必要な JoinLayer コントロールプレーン契約に依存しています。JoinLayer の本番ビルドとデプロイは非公開のリリースシステムで行われますが、ホスト型リリースで使用する mcp-gateway/ ツリーは、タグ付けされた公開スナップショットと完全に一致している必要があります。非公開のリリースゲートでは、ゲートウェイの差異が拒否されます。スキル、プロンプト、プラグインのパッケージングには、このバイト単位の一致ゲートではなく、それぞれ独自のバージョン管理されたコンテンツチェックが適用されます。公開へのコントリビューションが JoinLayer のインフラストラクチャに直接デプロイされることはありません。

接続

Codex

公開リポジトリのマーケットプレイスから JoinLayer プラグインをインストールします。

codex plugin marketplace add joinlayer/agent-toolkit
codex plugin add joinlayer@joinlayer

このプラグインには運用スキルが含まれており、ホスト型 MCP コンパニオンも設定されます。プロンプトが表示されたら、ブラウザー OAuth を完了してください。MCP サーバーのみを設定する場合は、次の手順を実行します。

codex mcp add joinlayer --url https://mcp.joinlayer.app/mcp
codex mcp login joinlayer --scopes workspace:read,usage:read,connections:read,pipelines:read

その後、新しいセッションを開始して、次のように尋ねます。

Use $joinlayer-pipelines. Inspect my authenticated workspace, scopes,
capacity, connections, and pipelines. Do not change anything.

コピーして使えるその他の開始プロンプトは、 START_HERE.md にまとめられています。 レプリケーション、リアルタイムのバックフィル、スケジューリング、エンリッチメント、容量、承認、復旧のワークフロー全体は use-cases/ にあります。

Claude Code

claude plugin marketplace add joinlayer/agent-toolkit
claude plugin install joinlayer@joinlayer --scope user
claude mcp login joinlayer

claude mcp login joinlayer コマンドが利用可能な場合は、そのコマンドからブラウザー OAuth を完了してください。それ以前の OAuth 対応リリースでは、/mcp の Authenticate から完了できます。Authorization ヘッダーやクライアントシークレットを追加しないでください。

スキルのみ

skills.sh がサポートするエージェントでは、運用スキルのみをインストールできます。

npx skills add https://github.com/joinlayer/agent-toolkit --skill joinlayer-pipelines

このスキルに認証情報は含まれておらず、MCP 接続の代わりにはなりません。クライアントの OAuth 対応 MCP 設定で同じホスト型エンドポイントを設定し、START_HERE.md のプロンプトを使用してください。

セキュリティ境界

• OAuth トークンは有効期間が短く、対象者に限定されており、ホストされている MCP リソースにのみ送信されます。
• ゲートウェイは、別途認証されたプライベート API の境界を通じて委任された権限を交換します。
• 接続認証情報は JoinLayer のブラウザーセットアップセッションでのみ入力し、ツールの引数には決して含めません。
• MCP から返される顧客およびサードパーティの値は信頼できないデータであり、エージェントへの指示ではありません。埋め込まれたコマンドによって、スコープの拡大、承認の回避、情報開示の許可を行うことはできません。
• 公開ソースには、本番環境の認証情報、顧客データ、ホストのインベントリ、デプロイ設定は含まれていません。
• ルート名とヘッダー名は認可の制御手段ではありません。すべてのプライベートリクエストで、個別に検証された認証情報とテナントへの所属が必要です。

脆弱性は、SECURITY.md に記載されている方法で非公開に報告してください。

開発

python3.12 -m venv .venv
. .venv/bin/activate
pip install --requirement mcp-gateway/requirements.lock
PYTHONPATH=mcp-gateway python -m unittest mcp-gateway.tests.test_gateway
python scripts/validate_public_snapshot.py

レビュー用イメージは docker build . でビルドできます。このイメージは再現性の確保とレビューを目的としており、JoinLayer の本番環境に自動的に昇格されることはありません。

正確な公開版／非公開版リリースの不変条件については、SOURCE_SYNC.md を参照してください。 メンテナーは、検証済みカタログおよびマーケットプレイスへの公開契約について、DISTRIBUTION.md を参照できます。OpenAI のレビュー資料は OPENAI_SUBMISSION.md に記録されています。

レビュー前に、このチェックアウトとプライベートプラットフォームのチェックアウトを比較するには、次を実行します。

python scripts/source_tree_digest.py --compare-root /path/to/private-platform

ライセンス

Apache-2.0。LICENSE を参照してください。

コードのライセンスは、JoinLayer になりすます権利や、JoinLayer の推奨を示唆する権利を付与するものではありません。TRADEMARKS.md を参照してください。