cnvs-whiteboard-skills

Agent Skills + cnvs.app용 MCP 서버 디스커버리 — 무료, 가입 불필요, 실시간 공동 작업 화이트보드입니다. 모든 AI 에이전트는 호스팅된 MCP 서버 또는 REST 폴백을 통해 공유 캔버스에서 실시간 인간 편집을 읽고, 쓰고, 그리고, 다이어그램을 작성하고, 구독할 수 있습니다.

Claude Code, Claude Desktop, Cursor, OpenCode / OpenAI Codex, Aider(MCP 플러그인 포함), 기타 MCP를 지원하는 모든 클라이언트, 그리고 Hermes 계열 에이전트와 함께 작동합니다.

MCP 서버

엔드포인트: https://cnvs.app/mcp (Streamable HTTP, 프로토콜 2025-06-18, 인증 없음 — 보드 ID가 액세스 키입니다.)

공식 MCP Registry에 app.cnvs/whiteboard로 등록되어 있습니다.

기능

• 도구(25개): 보드 생성 및 검사, 시각적 미리보기, 텍스트·링크·이미지·스트로크 편집, 이동 및 삭제, 실시간 업데이트 대기, 그리고 완전한 칸반 컬럼·레인·태스크·쿼리·내보내기 워크플로. 정확한 프로덕션 목록은 /.well-known/mcp.json에 게시되어 있습니다. 상태 변경 작업은 MCP를 사용할 수 없는 런타임을 위해 https://cnvs.app/api/boards/<id>/… 아래에 REST 미러도 제공합니다.

• 리소스(3개): cnvs://board/{id}/state.json(전체 스냅샷), cnvs://board/{id}/preview.svg(시각적 렌더링), cnvs://board/{id}/tasks.json(칸반 상태). 세 가지 모두 구독할 수 있습니다.

• 구독: resources/subscribe를 지원하며, notifications/resources/updated가 SSE를 통해 푸시되고, 활동이 안정된 후 약 3초 동안 디바운스됩니다.

• 실시간 기계 판독 가능 매니페스트: /quotas.json, /openapi.json, /llms.txt, /.well-known/mcp.json, /.well-known/mcp/server.json.

Related MCP server: Excalidraw MCP Server

설치

Codex / ChatGPT 및 Cursor 패키지

이 저장소는 두 마켓플레이스 통합을 위한 공개 소스 패키지입니다:

• .codex-plugin/plugin.json과 .mcp.json은 Codex / ChatGPT 플러그인을 설명합니다.

• .cursor-plugin/plugin.json과 mcp.json은 Cursor 플러그인을 설명합니다.

• SUBMISSION.md와 CURSOR-MARKETPLACE.md에는 준비된 리스팅 문구, 공개 사항, 리뷰어 흐름, 제출 체크리스트가 포함되어 있습니다.

두 패키지 모두 호스팅된 프로덕션 엔드포인트에만 연결됩니다. 구성할 로컬 서버 프로세스나 비밀값이 없습니다.

Claude Desktop / Cursor / 모든 MCP 클라이언트

한 줄 구성 — 클라이언트의 mcpServers 객체에 다음을 추가하세요:

{
  "mcpServers": {
    "cnvs": {
      "type": "http",
      "url": "https://cnvs.app/mcp"
    }
  }
}

Claude Code CLI

claude mcp add --transport http cnvs https://cnvs.app/mcp

REST 전용(MCP 클라이언트 없음)

# Create a board
curl -X POST https://cnvs.app/api/boards

# Add text
curl -X POST https://cnvs.app/api/boards/<id>/texts \
  -H 'Content-Type: application/json' \
  -d '{"x":100,"y":200,"content":"# Hello","author":"ai:myagent"}'

# Long-poll for live changes
curl "https://cnvs.app/api/boards/<id>/wait?timeout_ms=25000"

전체 REST 참조: /llms.txt, /openapi.json.

액세스 모델

계정이나 OAuth 흐름이 없습니다. 보드 URL 또는 보드 ID는 베어러 스타일의 액세스 자격 증명입니다. 잠금 해제된 보드 URL을 아는 사람은 누구나 열 수 있습니다. 보드는 선택적으로 쓰기 또는 읽기와 쓰기 모두에 대해 8자리 소문자 영숫자 액세스 키를 요구할 수 있습니다. 레거시 6자리 키도 계속 허용됩니다. 키는 MCP 도구의 access_key 인수 또는 X-Board-Key HTTP 헤더를 통해서만 전달하세요.

개인 보드 URL이나 액세스 키를 공개 이슈, 로그, 저장소에 붙여넣지 마세요.

유용한 프롬프트

• 브레인스토밍 세션을 위한 새 화이트보드를 만들고 URL을 반환해 줘.

• 이 cnvs.app 보드를 열고 미리보기를 확인한 후 레이아웃을 요약해 줘.

• 이 목록을 우선순위와 담당자가 있는 공유 칸반 보드로 바꿔 줘.

포함된 Skills

이 저장소에는 두 개의 관련 Agent Skills가 있으며, agentskills.io 오픈 표준으로 게시되어 호환되는 모든 런타임에서 작동합니다. 에이전트가 MCP 서버를 잘 사용하도록 가르치려면 ~/.claude/skills/에 설치하세요(JSON보다 먼저 미리보기, 쓰기는 MCP 대신 REST, 작성자 태그 규칙, 구독 후 반응 루프).

cnvs-whiteboard/ — 기본

AI 에이전트가 cnvs.app 보드에서 실시간으로 협업하는 방법을 가르칩니다:

• 공유 캔버스 상태 읽기

• 그리기 / 다이어그램 / 순서도 / 주석 달기 — 텍스트, 링크, 스티커 메모, 스트로크, 이미지, Mermaid 다이어그램(순서도, 시퀀스 / 클래스 / ER 다이어그램, 마인드맵, 간트 차트, 컨셉 맵) 추가, 업데이트, 이동, 삭제

• 보드에 그림이 포함된 경우 SVG 미리보기 렌더링

• MCP를 통한 실시간 인간 편집 구독, REST를 통한 반응

cnvs.app 보드 참조(URL https://cnvs.app/#<id>, cnvs://board/<id>/..., 또는 보드 ID만 있는 경우) 또는 '공유 화이트보드나 캔버스에서 협업 / 그리기 / 다이어그램 / 주석 달기 / 지켜보기'와 같은 문구에서 활성화됩니다.

mcp-listen/ — 보조 (v0.3.0)

capabilities.resources.subscribe: true가 있는 Streamable-HTTP MCP 서버를 위한 모델 푸시 펌프입니다. 세션을 열고 호출자가 전달한 리소스 URI를 구독한 다음 notifications/resources/updated 이벤트마다 JSON 한 줄을 stdout으로 내보냅니다. Claude Code의 Monitor 도구로 감싸서 모든 서버 푸시가 채팅 내 알림이 되도록 설계되었습니다(폴링 없음, 로그 테일링 없음).

v0.3부터 보조 전용 활성화. 호출자(사용자 또는 다른 스킬)가 MCP 서버 URL과 리소스 URI를 모두 제공한 경우에만 트리거됩니다. '이 파일을 지켜봐' 또는 '계속 업데이트해' 같은 일반적인 문구로는 자동 활성화되지 않습니다. cnvs-whiteboard가 표준 호출자이며 푸시 채널을 여기에 위임합니다.

v0.3부터 출력 분리. 기본적으로 실행 가능한 resource_updated 이벤트만 stdout에 도달합니다. 연결 / 구독 / 하트비트 / 일시적 오류 이벤트는 stderr로 가므로 래핑하는 Monitor가 리스너 자체의 부기로 인해 발화하지 않습니다. 디버깅이나 단일 채널 로깅을 위해 --verbose(또는 -v)를 전달하면 모든 것을 stdout으로 병합합니다(레거시 v0.2 동작).

레지스트리 상태. 의도적으로 아직 중앙 집중식 스킬 레지스트리에 등록되지 않았습니다. 현재 레지스트리 파이프라인(예: 2026-05-03 기준 majiayu000/claude-skill-registry-core)은 SKILL.md + 생성된 메타데이터만 보관하며 번들된 scripts/** 또는 package.json을 미러링하지 않으므로 mcp-listen 항목을 게시하면 깨진 스킬이 게시됩니다. 핵심 레지스트리가 번들 파일 미러링 및 보안 검사를 포함한 디렉터리 형식 스킬 보관을 지원하면 (재)제출할 예정입니다. 방금 추가된 디렉터리 보관 프리미티브와 번들 스크립트 검사에 대한 미해결 질문은 PR majiayu000/claude-skill-registry-core#40을 참조하세요. 그때까지는 cnvs.app(아래)에서 curl로 설치하거나 이 저장소를 git clone하세요.

Skills 설치

# cnvs-whiteboard (SKILL.md only — no deps)
mkdir -p ~/.claude/skills/cnvs-whiteboard && cd ~/.claude/skills/cnvs-whiteboard
curl -O https://cnvs.app/cnvs-whiteboard/SKILL.md

# mcp-listen (SKILL.md + scripts/ + npm install)
mkdir -p ~/.claude/skills/mcp-listen && cd ~/.claude/skills/mcp-listen
curl -O https://cnvs.app/mcp-listen/SKILL.md \
     -O https://cnvs.app/mcp-listen/package.json \
     --create-dirs -o scripts/listen.mjs https://cnvs.app/mcp-listen/scripts/listen.mjs
npm install

또는 이 저장소를 git clone하고 cp -r .claude/skills/* ~/.claude/skills/를 실행하세요. .claude/skills/ 디렉터리에는 Claude Code의 예상 레이아웃을 위해 cnvs-whiteboard/와 mcp-listen/으로의 심볼릭 링크가 포함되어 있습니다.

스펙 준수

두 스킬 모두 agentskills.io 스펙을 따릅니다:

• name은 포함하는 디렉터리 이름과 일치

• description은 1024자 미만, 명령형 문구, 명시적 트리거 키워드

• 번들 코드용 scripts/ 하위 디렉터리(mcp-listen)

• license: MIT, compatibility 필드 선언, 각 스킬의 'Related skills' 섹션에 상호 참조를 두어 활성화 중복 방지

두 개의 스킬로 나눈 이유

이전 버전에는 단일 페이지(/skill-cnvs.md, cnvs.app에 있음 — 현재는 레거시 리디렉션)가 있었습니다. 두 개의 응집력 있는 단위로 분리한 것은 스펙의 '응집력 있는 단위 설계' 모범 사례를 따릅니다:

• cnvs-whiteboard는 cnvs.app 특화 워크플로(읽기 / 쓰기 / 렌더링 / 주의사항)를 담당합니다.

• mcp-listen은 일반적인 모델 푸시 패턴(모든 MCP 서버에서 사용 가능)을 담당합니다.

상호 참조를 통해 두 스킬이 깔끔하게 짝을 이룹니다. cnvs-whiteboard는 위임된 푸시 채널로 mcp-listen을 언급하고, mcp-listen은 cnvs 특화 작업의 동반자로 cnvs-whiteboard를 언급합니다. 실제로 활성화 중복은 없습니다.

정식 소스

스킬은 또한 다음 위치에서 실시간으로 제공됩니다:

• https://cnvs.app/cnvs-whiteboard/SKILL.md

• https://cnvs.app/mcp-listen/SKILL.md

• https://cnvs.app/mcp-listen/scripts/listen.mjs

• https://cnvs.app/mcp-listen/package.json

cnvs.app URL은 curl 기반 설치 프로그램의 정식 설치 대상입니다. 이 GitHub 저장소는 공개 소스(skills.sh 등)를 크롤링하는 애그리게이터와 git clone을 선호하는 사용자를 위한 참조입니다.

디스커버리 경로

실시간

• 공식 MCP Registry: app.cnvs/whiteboard — 둘러보기

• cnvs.app /.well-known/mcp.json — 두 스킬을 모두 링크

• cnvs.app /.well-known/mcp/server.json — 게시자가 제공한 _meta.skills[]가 포함된 MCP Registry 항목

• cnvs.app /llms.txt — LLM 친화적인 전체 참조

• majiayu000/claude-skill-registry-core — cnvs-whiteboard 등록됨(PR #31 2026-05-04 병합). mcp-listen은 의도적으로 보류됨. 위 mcp-listen/ 섹션의 Registry status 참조.

• Lobehub(Hermes 에이전트가 사용) — 두 스킬 모두 가져옴, MCP 서버 제출됨

계획됨 / 검토 중

향후 배포 확장을 위한 메모입니다. 아직 활성화되지 않았습니다. 다음 유지보수 시점에 환경을 다시 조사할 필요가 없도록 여기에 보관합니다.

• majiayu000/claude-skill-registry-core — PR #40(디렉터리 아카이브 + 번들 스크립트 보안 검사)이 병합되었으므로 mcp-listen을 별도의 PR로 다시 제출하세요. scripts/listen.mjs는 심지어 그들의 테스트 검증에 하드코딩되어 있어 파이프라인이 이미 우리의 정확한 사례를 실행하고 있습니다.

• daymade/claude-code-skills(벤더 모델) — 포크하여 cnvs-whiteboard/와 mcp-listen/을 그들의 트리에 직접 복사하고(그들의 레이아웃은 이미 scripts//references//assets/를 기대함), marketplace.json을 업데이트한 후 두 스킬을 하나의 PR로 제출하세요. 파일이 복사되므로 번들 파일 문제가 없습니다.

• VoltAgent/awesome-agent-skills(큐레이션된 awesome-list, 20k ⭐) — 마크다운 링크, 10단어 이하 설명. 그들의 CONTRIBUTING은 새로운 스킬을 명시적으로 제외합니다('제출하기 전에 스킬이 성숙하고 사용자를 확보할 시간을 주세요'). 문서화된 외부 사용 사례가 생기면 다시 검토하세요.

• sickn33/antigravity-awesome-skills(36k ⭐) — 수동 경로: 포크하고 skills/<name>/SKILL.md를 추가한 다음 npm run validate를 실행하세요. README의 <!-- registry-sync: ... --> 헤더는 업스트림 레지스트리에서 자동으로 가져오는 것을 시사하므로 majiayu000/claude-skill-registry-core에 성공적으로 등록하면 별도의 PR 없이 여기에 전파될 수도 있습니다. 두 번 제출하기 전에 확인하세요.

• agentskills/agentskills(17.8k ⭐, agentskills.io 뒤에 있는 스펙 조직) — 참조 구현을 수용하는지 조사하세요. MCP resources/subscribe 사용의 실제 예제인 mcp-listen이 거기에 적합할 수 있습니다.

• vercel-labs/agent-skills / vercel-labs/skills — 거의 확실히 큐레이션된 목록이지만, 제외하기 전에 CONTRIBUTING을 읽어보세요.

의도적으로 건너뜀: anthropics/skills(큐레이션됨, 커뮤니티 PR 없음); 약 100 ⭐ 미만의 개인 컬렉션; 관련 사용자가 나타나지 않는 한 언어별 목록.

라이선스

MIT. LICENSE 참조.