Layerdock MCP server
2026년 10월 19일 커밋코딩 에이전트가 웹사이트 피드백을 읽고, 스크린샷을 확인하며, 콘솔 트레이스에 접근하여 에디터에서 직접 버그를 수정할 수 있도록 지원합니다.
다른 이름 LayerDock/layerdock-mcp
- 스타
- 0
- Tools
- 5
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 19일
- 라이선스
- MIT
Layerdock MCP란?
코딩 에이전트가 웹사이트 피드백을 읽고, 스크린샷을 확인하며, 콘솔 트레이스에 접근하여 에디터에서 직접 버그를 수정할 수 있도록 지원합니다. 5개 도구를 제공합니다. 예: list_docks, list_feedback, get_feedback.
프로젝트 README에서 생성된 요약
Layerdock MCP server 정보
layerdock-mcp는 AI 에이전트를 사용하는 개발자가 코딩 에디터에서 직접 웹사이트 버그를 수정할 수 있도록 지원합니다. LayerDock에 연결함으로써 코딩 에이전트는 웹사이트 피드백에 접근하고, 캡처된 스크린샷을 확인하며, 콘솔 또는 네트워크 트레이스를 조사하여 보고된 문제를 파악할 수 있습니다. 이 통합 기능은 개인 액세스 토큰을 사용한 로컬 설정을 통해 Claude Code, Cursor, Codex CLI, Windsurf와 같은 클라이언트와 함께 작동합니다.
이 MCP server는 디버깅 워크플로우를 관리하기 위한 특정 도구를 제공합니다. 개발자는 list_docks를 사용하여 사이트 목록을 확인하고, list_feedback로 열려 있는 이슈를 찾으며, get_feedback를 통해 상세한 수정 브리프를 받을 수 있습니다. 이 브리프에는 CSS selector, 계산된 스타일, 그리고 소스 코드와 정확히 일치하도록 설계된 검색 문자열이 포함됩니다. 또한 get_feedback 도구는 반환되는 데이터 양을 조절할 수 있도록 auto, minimal, full과 같은 다양한 상세 수준을 지원합니다.
단순히 데이터를 읽는 것을 넘어, 이 server는 에이전트가 피드백 루프와 상호작용할 수 있도록 합니다. update_feedback_status를 사용하여 워크플로우에 따라 핀의 상태를 변경하거나, reply_to_feedback를 통해 스레드에 댓글을 게시할 수 있습니다. 에이전트가 보낸 모든 답글에는 자동으로 라벨이 지정되어 사람의 응답과 구분되므로 팀 내에서 명확한 커뮤니케이션이 가능합니다.
활용 사례
- 1대기 중인 웹사이트 버그 식별AI 에이전트에게 연결된 모든 사이트에서 열려 있는 모든 피드백 항목을 찾아 작업 우선순위를 정하도록 요청하세요.
- 2레이아웃 또는 동작 문제 디버깅에이전트에게 스크린샷과 콘솔 에러가 포함된 상세 브리프를 제공하여 특정 UI 버그를 진단하세요.
- 3팀원에게 수정 사항 전달버그가 해결되면 에이전트가 피드백 스레드에 답글을 게시하도록 하세요.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Layerdock MCP 도구 5
README에서 감지됨list_dockslist_feedbackget_feedbackupdate_feedback_statusreply_to_feedback
| list_docks | — | |
| list_feedback | — | |
| get_feedback | — | |
| update_feedback_status | — | |
| reply_to_feedback | — |
구성
LAYERDOCK_TOKEN
| 이름 | 설명 | 유형 |
|---|---|---|
| LAYERDOCK_TOKEN | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능layerdock/layerdock-mcp is public and reachablegithub.com/layerdock/layerdock-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-19github.com/layerdock/layerdock-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음5 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기@layerdock/mcp
Read your LayerDock website feedback — with the CSS selector, the screenshot, and the console/network trace captured at report time — directly in your coding agent. Fix the bug, reply on the thread, mark it resolved, without leaving the editor.
Setup
-
Create a token at https://www.layerdock.io/dashboard/integrations/mcp
-
Warm the cache first, once, in a terminal:
npx -y @layerdock/mcp --versionnpxdownloads the package on first use, and a cold download can take longer than an editor's MCP connect timeout (30s in Claude Code) — so the very first connection fails withCONNECT_TIMEOUTon a server that is working perfectly. Running it once puts it in the npx cache; every launch after that is instant. Skip this and you may simply need to restart your editor once. -
Add the config for your client below.
The three clients below are the short version. The full walkthrough — config for Claude Code, Cursor, Codex CLI, Antigravity, Windsurf, VS Code and Zed, how to verify the connection, and what to check when the server does not appear — is at https://www.layerdock.io/docs/connect-your-coding-agent
Claude Code
.mcp.json in your project root:
{
"mcpServers": {
"layerdock": {
"command": "npx",
"args": ["-y", "@layerdock/mcp"],
"env": { "LAYERDOCK_TOKEN": "ldk_..." }
}
}
}
Cursor
~/.cursor/mcp.json — same JSON as above.
Codex CLI
~/.codex/config.toml:
[mcp_servers.layerdock]
command = "npx"
args = ["-y", "@layerdock/mcp"]
env = { LAYERDOCK_TOKEN = "ldk_..." }
Tools
| Tool | What it does |
|---|---|
list_docks |
Your sites, with any codebase hints their owner declared (framework, source root, CMS) |
list_feedback |
Pins, filterable by status. dockId is optional — omit it to see open work across every dock you can reach, which is the whole answer to "what needs my attention?" in one call |
get_feedback |
One pin as a fix brief, plus the screenshot as an image. Takes detail: auto (default), minimal, full |
update_feedback_status |
Move a pin through the workflow |
reply_to_feedback |
Post a reply on the thread, attributed to you and labelled as coming via a coding agent |
What get_feedback actually returns
A fix brief, ordered by how actionable each part is:
- What the reporter wants changed, plus the reply thread
- The component, when the reviewed site is a dev/unminified build — sometimes the source file and line
- A repetition warning when the pinned element is one of N identical siblings, so an agent doesn't hardcode a one-item fix into the shared component that renders all of them
- A search string that actually matches source — one contiguous run of
literal text from a single text node, whitespace collapsed, never cut
mid-word. This is deliberately not the element's
innerText: that spans child nodes, so it carries newlines and fragments that appear in no source file and a literal grep for it never matches - Where it is — page URL, section, CSS selector, and the full visible text marked explicitly as context rather than as something to grep for
- Structure and computed styles at pin time
- Console errors and failed/slow requests from the moment of capture, each stamped with how long before the report it happened
- The screenshot, as an image block the agent can actually look at — downscaled server-side, and when a pin has no capture the brief says so instead of instructing the agent to consult an image that was never attached
It also states what it cannot tell you — the brief never claims to know your
repository layout, and it instructs the agent to locate and confirm the file
before editing rather than guessing. That includes the case where the fix is not
in the repository at all: if the visible text appears nowhere in the codebase,
the content is probably CMS- or API-driven and the fix belongs in the content
source. Set a dock's cms field and the brief names the system directly.
Payload size
get_feedback defaults to detail: "auto". A pin that reads as a pure copy
change ("fix this wording") does not need ~20 computed CSS properties, device
memory, hardware concurrency and network downlink — so those are dropped, and
the brief says it dropped them. A layout or behaviour bug keeps everything. Pass
detail: "full" to override, or "minimal" to always trim.
Permissions
The token acts as you, and says so. A reply posted through reply_to_feedback
is attributed to the person the token belongs to and labelled as arriving via
a coding agent — the reviewer reading the thread is deciding whether to re-check
the page themselves, and a person promising "fixed this" is not the same claim as
an agent asserting it. Both facts are stamped server-side from the authenticated
token, so neither can be chosen by the client. Do not sign the message text
yourself.
Anything you cannot do in the dashboard, the agent cannot
do either — role gating is enforced server-side, not here. A member who is not
assigned to a pin cannot change its status, and nobody can read a dock they have
no relationship to.
Configuration
| Env var | Purpose |
|---|---|
LAYERDOCK_TOKEN |
Required. Your personal access token (ldk_...). |
LAYERDOCK_API_URL |
Optional. Defaults to https://www.layerdock.io. Point it at a local dev server when working on LayerDock itself. |
Security
Tokens are stored as a SHA-256 hash — the plaintext is shown once, at creation, and is never recoverable afterwards. Revoke a token from the same settings page; revocation takes effect immediately.
An authentication failure names its actual cause — malformed, unknown, deleted,
or expired — and echoes the first 12 characters of the token the server received
(received "ldk_AbCd-EfG…"). That prefix is the same non-secret value the
dashboard already displays next to each token, and it is what tells a stale
client process still holding a replaced token apart from a genuinely bad one.
Note that on a dev build, sourceFile in a brief may be an absolute path from
the machine that built the reviewed site. That stays within the dock's own
trust boundary, but it is worth knowing before sharing a brief outside your team.
License
MIT
Layerdock MCP 질문
Layerdock MCP는 어떤 도구를 제공하나요?
5개 도구를 제공합니다. 예: list_docks, list_feedback, get_feedback, update_feedback_status, reply_to_feedback.
피드백 브리프에는 어떤 정보가 포함되나요?
브리프에는 보고자의 요청, 컴포넌트 또는 소스 파일, 일치하는 검색 문자열, 페이지 URL, CSS selector, 계산된 스타일(computed styles), 콘솔 에러 및 스크린샷이 포함됩니다.
에이전트가 대시보드에서 제가 권한이 없는 작업을 수행할 수 있나요?
아니요, 에이전트는 대시보드 계정과 동일한 역할 기반 권한 제어(role gating)를 따릅니다. 사용자가 수행할 수 없는 작업은 에이전트도 수행할 수 없습니다.