JoinLayer MCP server
2026년 11월 10일 커밋Operate secure data pipelines through a hosted MCP gateway using delegated OAuth authentication.
다른 이름 joinlayer/agent-toolkit, agent-toolkit
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 0.1.2
- 마지막 커밋
- 2026년 11월 10일
- 라이선스
- Apache-2.0
JoinLayer MCP란?
JoinLayer은(는) MCP server입니다. Operate secure data pipelines through a hosted MCP gateway using delegated OAuth authentication.
프로젝트 README에서 생성된 요약
JoinLayer MCP server 정보
JoinLayer provides a hosted MCP gateway designed for managing secure data pipelines. It allows developers to connect AI agents to their data environments using the joinlayer-pipelines skill. The service operates via a remote endpoint at mcp.joinlayer.app/mcp, which acts as a security boundary between the agent and the underlying data infrastructure.
Users interact with the server through clients like Claude Code or Codex by installing specific plugin metadata. Authentication is handled through a browser-based OAuth Authorization Code with PKCE flow, ensuring that users never have to manually handle bearer tokens or client secrets. This setup is intended for developers who need to automate workflows such as data replication, real-time backfill, and pipeline scheduling while maintaining strict security controls.
Unlike self-hosted solutions, this gateway relies on a private control-plane contract to manage connections. It includes built-in protections to ensure that data returned to the agent is treated as untrusted information rather than executable instructions, preventing unauthorized scope expansion or command execution.
활용 사례
- 1Inspect authenticated workspace detailsAsk the agent to review your current workspace, available connections, and existing pipelines without making changes.
- 2Automate data pipeline workflowsExecute complex data management tasks including replication, scheduling, and enrichment.
- 3Manage data enrichment and recoveryUse the toolkit to handle data enrichment processes or initiate recovery procedures for pipelines.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
JoinLayer MCP 설치 방법
형식 확인: 2026년 11월 10일Claude Code에 JoinLayer MCP 설치
$ claude mcp add --transport http agent-toolkit https://mcp.joinlayer.app/mcpCursor에 JoinLayer MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"agent-toolkit": {
"url": "https://mcp.joinlayer.app/mcp"
}
}
}VS Code에 JoinLayer MCP 설치
.vscode/mcp.json
{
"servers": {
"agent-toolkit": {
"type": "http",
"url": "https://mcp.joinlayer.app/mcp"
}
}
}Codex에 JoinLayer MCP 설치
~/.codex/config.toml
[mcp_servers.agent-toolkit] url = "https://mcp.joinlayer.app/mcp"
Gemini CLI에 JoinLayer MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"agent-toolkit": {
"httpUrl": "https://mcp.joinlayer.app/mcp"
}
}
}README
GitHub에서 보기JoinLayer Agent Toolkit
Official agent integration for JoinLayer: a hosted MCP gateway, the joinlayer-pipelines skill, client plugin metadata, safe starter prompts, and public protocol tests.
The supported service is the JoinLayer-hosted endpoint:
https://mcp.joinlayer.app/mcp
It is published as app.joinlayer/mcp in the official MCP Registry. The operating skill is available from skills.sh, and this repository is the canonical source for the JoinLayer Codex and Claude Code marketplaces.
Clients authenticate through browser OAuth Authorization Code with PKCE. Never create, paste, or configure a JoinLayer bearer token manually.
Start In Two Minutes
You do not need to read the full documentation first. Open
START_HERE.md, connect JoinLayer, and copy the read-only
inspection prompt. From there, choose a ready-to-run prompt for your goal.
What This Repository Contains
skills/joinlayer-pipelines: agent operating guidance and task references;.codex-plugin/plugin.json,.claude-plugin/, and.mcp.json: installable Codex and Claude Code plugin metadata;prompts: safe starting points for common JoinLayer tasks;use-cases: complete customer outcomes with evidence and stop boundaries;mcp-gateway: a reviewable snapshot of the hosted MCP security boundary;server.json: MCP Registry metadata for the hosted remote server.
The gateway source is published for transparency and compatibility review. It is not a self-hosted JoinLayer distribution: it depends on a private, authenticated JoinLayer control-plane contract that is not included here. JoinLayer production builds and deployment remain in a private release system, but the mcp-gateway/ tree used by a hosted release must match a tagged public snapshot exactly. The private release gate rejects gateway drift. Skills, prompts, and plugin packaging use their own versioned content checks rather than this byte-equality gate. A public contribution never deploys directly to JoinLayer infrastructure.
Connect
Codex
Install the JoinLayer plugin from its public repository marketplace:
codex plugin marketplace add joinlayer/agent-toolkit
codex plugin add joinlayer@joinlayer
The plugin bundles the operating skill and configures the hosted MCP companion. Complete browser OAuth when prompted. To configure only the MCP server instead:
codex mcp add joinlayer --url https://mcp.joinlayer.app/mcp
codex mcp login joinlayer --scopes workspace:read,usage:read,connections:read,pipelines:read
Then start a fresh session and ask:
Use $joinlayer-pipelines. Inspect my authenticated workspace, scopes,
capacity, connections, and pipelines. Do not change anything.
More copyable starting points are indexed in
START_HERE.md. Complete workflows for replication, realtime
backfill, scheduling, enrichment, capacity, approvals, and recovery are in
use-cases/.
Claude Code
claude plugin marketplace add joinlayer/agent-toolkit
claude plugin install joinlayer@joinlayer --scope user
claude mcp login joinlayer
Complete browser OAuth through claude mcp login joinlayer when that command is
available, or through Authenticate in /mcp on earlier OAuth-capable
releases. Do not add an Authorization header or client secret.
Skill Only
Agents supported by skills.sh can install only the operating skill:
npx skills add https://github.com/joinlayer/agent-toolkit --skill joinlayer-pipelines
The skill does not carry credentials and does not replace the MCP connection.
Configure the same hosted endpoint through your client's OAuth-capable MCP
settings, then use a prompt from START_HERE.md.
Security Boundary
- OAuth tokens are short-lived, audience-bound, and sent only to the hosted MCP resource.
- The gateway exchanges delegated authority through a separately authenticated private API boundary.
- Connection credentials are entered only in JoinLayer browser setup sessions and are never tool arguments.
- Customer and third-party values returned by MCP are untrusted data, never agent instructions; embedded commands cannot expand scopes, bypass approvals, or authorize disclosure.
- Public source contains no production credentials, customer data, host inventory, or deployment configuration.
- Route names and header names are not authorization controls. Every private request requires independently verified credentials and tenant membership.
Report vulnerabilities privately as described in SECURITY.md.
Development
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
Build the review image with docker build .. That image is for reproducibility and review; it is not automatically promoted to JoinLayer production.
See SOURCE_SYNC.md for the exact public/private release invariant. Maintainers can use DISTRIBUTION.md for the verified catalog and marketplace publication contracts. OpenAI review material is recorded in OPENAI_SUBMISSION.md.
To compare this checkout with a private platform checkout before review:
python scripts/source_tree_digest.py --compare-root /path/to/private-platform
License
Apache-2.0. See LICENSE.
The code license does not grant rights to impersonate JoinLayer or imply endorsement. See TRADEMARKS.md.
JoinLayer MCP 질문
JoinLayer MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http agent-toolkit https://mcp.joinlayer.app/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
JoinLayer MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
How do I authenticate with JoinLayer?
Clients authenticate using browser OAuth Authorization Code with PKCE. You should never manually configure or paste a JoinLayer bearer token.
Can I host the JoinLayer gateway myself?
No, this repository is not a self-hosted distribution; it depends on a private, authenticated JoinLayer control-plane contract.
Is it safe to use JoinLayer with AI agents?
Yes, the system uses short-lived OAuth tokens and treats returned data as untrusted to prevent embedded commands from bypassing security boundaries.