cnvs-whiteboard-skills

cnvs.app 向けの Agent Skills + 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（カンバン状態）。3 つすべて購読可能です。

• サブスクリプション: 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 クライアント

1 行の設定 — クライアントの 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 やアクセスキーを公開の issue、ログ、リポジトリに貼り付けないでください。

便利なプロンプト

• ブレインストーミングセッション用に新しいホワイトボードを作成して、その URL を返してください。

• この cnvs.app ボードを開いて、プレビューを確認し、レイアウトを要約してください。

• このリストを、優先順位と担当者付きの共有カンバンボードに変換してください。

含まれるスキル

このリポジトリには 2 つの関連する Agent Skills が含まれており、agentskills.io オープン標準に基づいて公開されているため、互換性のある任意のランタイムで動作します。~/.claude/skills/ にインストールすると、エージェントに MCP サーバーの効果的な使い方（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 サーバー向けの push-to-model ポンプです。セッションを開き、呼び出し元が渡したリソース URI を購読し、notifications/resources/updated イベントごとに 1 行の JSON を stdout に出力します — Claude Code の Monitor ツールでラップして、サーバーのプッシュをすべてチャット内通知にすることを想定して設計されています（ポーリングなし、ログ追跡なし）。

v0.3 以降はヘルパーのみでアクティブ化。 呼び出し元（ユーザーまたは別のスキル）が MCP サーバー URL と少なくとも 1 つのリソース URI の両方を提供した場合にのみトリガーされます。「このファイルを監視して」や「最新情報を把握していて」のような一般的なフレーズから自動アクティブ化することはありません。cnvs-whiteboard が正規の呼び出し元であり、プッシュチャネルをここに委任します。

v0.3 以降の出力分割。 デフォルトでは、実行可能な resource_updated イベントのみが stdout に到達します。接続 / 購読 / ハートビート / 一時的なエラーイベントは stderr に送られ、ラップする Monitor がリスナー自身のブックキーピングで発火しないようにします。デバッグや単一チャネルロギングのためにすべてを stdout に統合するには --verbose（または -v）を渡します（レガシー 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 でインストールしてください。

スキルのインストール

# 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」セクションでの相互参照によるアクティブ化の重複防止

なぜ 2 つのスキルなのか

以前のバージョンは単一のページ（cnvs.app の /skill-cnvs.md — 現在はレガシーリダイレクト）でした。2 つの一貫したユニットに分割したのは、仕様の「design coherent units（一貫したユニットを設計する）」ベストプラクティスに従ったものです:

• cnvs-whiteboard は cnvs.app 固有のワークフロー（読み取り / 書き込み / レンダリング / 落とし穴）を担当します。

• mcp-listen は汎用の push-to-model パターン（任意の MCP サーバーに対して使用可能）を担当します。

相互参照により、2 つはきれいにペアリングされます: 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/ セクションの レジストリの状況 を参照してください。

• 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 を更新し、両方のスキルを 1 つの PR で提出します。ファイルがコピーされるため、バンドルファイルの懸念はありません。

• VoltAgent/awesome-agent-skills（キュレーションされた awesome リスト、20k ⭐）— マークダウンリンク、10 語以内の説明。彼らの CONTRIBUTING は新しいスキルを明示的に除外しています（「提出する前にスキルが成熟しユーザーを獲得する時間を与えてください」）。文書化された外部での使用例が出たら再検討します。

• sickn33/antigravity-awesome-skills（36k ⭐）— 手動パス: フォークして skills/<name>/SKILL.md を追加し、npm run validate を実行します。README の <!-- registry-sync: ... --> ヘッダーは上流レジストリからの自動プルを示唆しているため、majiayu000/claude-skill-registry-core への登録が成功すると、別の PR なしでここに伝播する可能性があります — 2 回提出する前に確認してください。

• 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 を参照してください。