MarkLayer

marklayer-mcp

MarkLayer の注釈を AI コーディングエージェントに橋渡しする MCP（Model Context Protocol）サーバーです。

ユーザーが MarkLayer でウェブページに注釈を付けると、エージェントはコメントを構造化された作業キューとして受け取ります。それぞれのコメントを確認済みにしたり、解決したり、却下したり、返信したりできます。人間にはステータスの更新がリアルタイムで表示されます。逆の使い方もできます。エージェントにルームを指定してページのレビューを依頼すると、エージェントがコメントやコピー編集の提案を残し、人間が確認して対応できます。

インストール

インストールは不要かもしれません。MarkLayer の共有リンクはすべて、同じアドレスに /mcp を付けたリモート MCP サーバーとしてすでに利用できるため、リモート（Streamable HTTP）サーバーに対応したクライアントなら、何もインストールせずに接続できます。

claude mcp add --transport http marklayer https://marklayer.app/s/abc123/mcp

?agent=cursor、または任意の名前を追加すると、ルーム内の人に誰が作業しているかが表示されます。既定値は agent です。このエンドポイントはそのルームに紐付いているため、以下のすべてのツールを利用できます。ただし、marklayer_connect_room は利用できません。

このパッケージは、Claude 固有の設定を含まない、同じツールの stdio 版です。クライアントからリモートサーバーに接続できない場合や、すべてのルームで使えるインストールを 1 つ用意したい場合（Claude Code、Cursor、Windsurf、VS Code、Codex CLI など）に使用してください。

# Claude Code:
claude mcp add marklayer -- npx -y marklayer-mcp

# Or pre-connect to a specific room:
claude mcp add marklayer -- npx -y marklayer-mcp --room https://marklayer.app/s/abc123

その他の MCP クライアントでは、同じコマンドを指定した stdio サーバーのエントリを追加してください（設定ファイルやキーはクライアントに合わせて調整してください。例：Cursor の ~/.cursor/mcp.json、Windsurf の mcp_config.json、VS Code の .vscode/mcp.json など）。

{
  "mcpServers": {
    "marklayer": {
      "command": "npx",
      "args": ["-y", "marklayer-mcp"],
      "env": { "MARKLAYER_AGENT": "cursor" }
    }
  }
}

このエージェントを識別するために MARKLAYER_AGENT（または --agent）を設定してください。これはコメントの作成者と「担当者」バッジとして人間に表示されるため、Claude 以外のクライアントでは既定値のままにしないでください。

使い方

エージェントへのプロンプト：

MarkLayer の注釈を監視してください。それぞれについて、確認したうえで修正し、概要を添えて解決してください。

エージェントは marklayer_watch_annotations をループ内で呼び出し、新しいフィードバックが届くと処理します。

ツール

ツール	説明
marklayer_connect_room	共有 URL または ID を指定してルームに接続します。
marklayer_room_info	ページ URL、ビューポートの幅、タイムスタンプを取得します。
marklayer_read_page	セレクター付きで、ページの見出し、テキスト、リンク、コントロールを取得します。まだ誰も注釈を付けていないページをエージェントがレビューする場合に役立ちます。
marklayer_list_annotations	注釈を一覧表示します。ステータスで絞り込むこともできます。
marklayer_get_annotation	1 件の注釈の詳細と返信スレッドを取得します。
marklayer_watch_annotations	新しい注釈が届くまで待機し、まとめて返します。
marklayer_acknowledge	対応中に設定し、このエージェントを担当者として指定します。
marklayer_resolve	解決済みに設定します。任意で概要を添えて返信を投稿できます。
marklayer_dismiss	人間に表示される理由を添えて、却下済みに設定します。
marklayer_reply	ステータスを変更せずに返信を投稿します（例：確認の質問）。
marklayer_create_annotation	新しいコメントを自分で残します。返信ではなく、先回りしたフィードバックに使います。
marklayer_suggest_edit	テキストの正確なコピー編集や文法修正を、人間が適用できる差分として提案します。
marklayer_share_preview	作成した URL の新しいレビュールームを開き、そこに接続します。現在のルームと同じ repo + branch（または previous）を指定すると、次のバージョンになります。
marklayer_set_next_steps	注釈 ID に関連付けた、順序付きチェックリストを公開します。前のリストは置き換えられます。
marklayer_complete_next_step	ステップを完了済みにします。レビュアーにはリアルタイムで表示されます。
marklayer_ask	2～6 個の選択肢がある投票をルームに投稿します。レビュアーは 1 票を投じることができ、再投票も可能です。
marklayer_get_feedback	1 回の読み取りで、ステータス別の注釈数、未解決の注釈、チェックリストの進捗状況、投票結果を取得します。

オプション

--room <url-or-id>   Connect at startup; otherwise call marklayer_connect_room.
--api-base <url>     Override worker URL (default https://marklayer.app).
--agent <name>       Identifier shown to humans (default "claude-code").

対応する環境変数：MARKLAYER_ROOM、MARKLAYER_API_BASE、MARKLAYER_AGENT。

トラブルシューティング

初回起動時に「Connection closed」と表示される場合。 初回実行時に npx -y がパッケージをダウンロードするため、ダウンロードに時間がかかると、MCP クライアントの起動タイムアウトを超えることがあります。一度キャッシュを作成してから（npx -y marklayer-mcp --help）、再接続してください。または、事前に npm i -g marklayer-mcp でインストールし、クライアントからバイナリを指定してください。

ツールが「room is not connected」を返す場合。 WebSocket が切断されています。ルームは Durable Object によって接続状態が維持されますが、長時間アイドル状態のエージェントは切断されることがあります。同じ URL で marklayer_connect_room を呼び出して再接続してください。

プログラムからルームを作成する

このサーバーは既存の共有リンクを 使用 します。コードから 1 つまたは複数のリンクを 作成 するには（たとえば、エージェントに渡す前に、複数の URL のページごとにルームを用意する場合）、公開 HTTP API に直接 POST してください。

curl -X POST https://marklayer.app/api/$ID \
  -H 'Content-Type: application/json' \
  -d '{"ops":[],"url":"https://example.com/page-1","width":1440,"expires_in":2592000}'
# Share link: https://marklayer.app/s/$ID

プレビュービルド用のレビュールームでは、POST /api/$ID/preview に { url, title, repo?, branch?, sha?, note?, questions?, previous? } を渡します。既存の ID が上書きされることはありません。バージョンは previous（すでに保持しているルーム）を介してのみ連結されます。バージョン切り替え機能には各ルームの前後のルームが表示されるため、repo と branch だけを使って 2 つのルームが連結されることはありません。marklayer_share_preview はこのルートを stdio 経由で呼び出します。HTTP（/s/:id/mcp）経由の場合は、Worker 内にルームを作成し、URL 内のルームから連結して、再接続用の mcpUrl を返します。このエンドポイントは自身のルームに紐付けられたままになるためです。

$ID は呼び出し元が指定します（アクセス トークンとなるため、nanoid / crypto.randomUUID() を使用してください）。認証も SDK も不要です。詳細については、https://marklayer.app/llms-full.txt をご覧ください。