JoinLayer

JoinLayer Agent Toolkit

JoinLayer 的官方 Agent 集成，包含托管 MCP 网关、joinlayer-pipelines 技能、客户端插件元数据、安全的入门提示词和公开协议测试。

支持的服务是由 JoinLayer 托管的端点：

https://mcp.joinlayer.app/mcp

它已作为 app.joinlayer/mcp in the official MCP Registry 发布。操作技能可从 skills.sh 获取，而此仓库是 JoinLayer Codex 和 Claude Code 市场的权威来源。

客户端通过浏览器 OAuth Authorization Code with PKCE 进行身份验证。切勿手动创建、粘贴或配置 JoinLayer bearer token。

两分钟快速开始

无需先阅读完整文档。打开 START_HERE.md，连接 JoinLayer，然后复制只读 检查提示词。接下来，选择适合你目标的现成提示词。

此仓库包含的内容

• skills/joinlayer-pipelines：Agent 操作指南和任务参考；
• .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 支持的 Agent 可以只安装操作技能：

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

该技能不包含凭据，也不能替代 MCP 连接。请通过客户端支持 OAuth 的 MCP 设置配置相同的托管端点，然后使用 START_HERE.md 中的提示词。

安全边界

• OAuth 令牌有效期较短、绑定受众，且仅发送至托管的 MCP 资源。
• 网关通过单独进行身份验证的私有 API 边界交换委托权限。
• 连接凭据仅在 JoinLayer 浏览器设置会话中输入，绝不会作为工具参数。
• MCP 返回的客户和第三方值均为不可信数据，绝不是 Agent 指令；其中嵌入的命令无法扩大权限范围、绕过审批或授权披露信息。
• 公开源代码不包含生产凭据、客户数据、主机清单或部署配置。
• 路由名称和标头名称不是授权控制手段。每个私有请求都必须通过独立验证的凭据和租户成员资格检查。

如需私下报告漏洞，请参阅 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 或暗示获得其认可的权利。请参阅 TRADEMARKS.md。