writespace-mcp

Writespace MCP サーバー

Writespace 用のリモートホスト型 Model Context Protocol サーバーです。Writespace はリアルタイムで共同編集できるドキュメントエディターです。Claude、ChatGPT、Gemini、Cursor、その他の MCP 対応エージェントに、あなたと一緒に読み取り、書き込み、整理、検索できる共有ドキュメントワークスペースを提供します。

エンドポイント： https://app.writespace.io/mcp（HTTP トランスポート、Bearer 認証） 無料プラン： あり — ドキュメント最大 10 件、カード登録不要 → 登録

できること

Writespace は、人間向けの Markdown ファーストなドキュメントエディターで、エージェント向けの MCP サーバーを内蔵しています。アプリで実行できるすべての操作が、モデルから呼び出せるツールとして公開されています。

• 読み取り — ワークスペースツリーをたどり、任意のドキュメントをロスレスな JSON または Markdown として取得し、ランキング付きの全文検索を実行します（そのままエージェントに渡して RAG 検索に利用できます）。
• 書き込み — ドキュメントを作成し、コンテンツを追記し、見出しを指定して単一セクションを置き換え、構造化メタデータを浅くマージします。
• 整理 — フォルダーの作成、名前変更、移動、ドキュメントの移動、メタデータによるドキュメントの検索（{ status: "accepted" }）を行います。

エージェントによる書き込みは Realtime 経由でブロードキャストされるため、開いているエディターはリアルタイムで更新されます。人間とエージェントが同じキャンバスで作業できるため、エクスポートや形式の調整は不要です。

クイックスタート

3 ステップ、2 分で完了します。

1. トークンを取得する — app.writespace.io にサインインし、Settings → API tokens を開いてトークンを作成します（トークンは一度だけ表示され、いつでも取り消せます）。
2. エンドポイント — すべてのアカウントで共通のホスト型エンドポイントです：https://app.writespace.io/mcp
3. クライアントを設定する — 以下のスニペットを使用します。

Claude Code（CLI）

claude mcp add --transport http writespace \
  https://app.writespace.io/mcp \
  --header "Authorization: Bearer ws_pat_YOUR_TOKEN_HERE"

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop の設定でサポートされているのは ローカル（stdio） サーバーのみです。そのため、リモート HTTP サーバーは mcp-remote を介して接続します。 Claude Desktop がこれをローカルで起動し、エンドポイントに転送します。

{
  "mcpServers": {
    "writespace": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.writespace.io/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer ws_pat_YOUR_TOKEN_HERE"
      }
    }
  }
}

注意：

• mcp-remote は --header 引数内のスペースを正しく処理できないため、トークンは AUTH_HEADER 環境変数に設定します（また、コロンの後にスペースを入れずに --header Authorization:${AUTH_HEADER} を指定します）。
• Claude Desktop は最小限の PATH で起動します。npx が見つからない場合は、絶対パス（例：/usr/local/bin/npx または nvm のパス）を指定してください。また、バージョン指定された node に依存する場合は、対応する "PATH" エントリーを env に追加してください。
• 編集後は Claude Desktop を完全に終了して（Cmd-Q）、再起動してください。設定は起動時にのみ読み込まれます。

Cursor

Settings → MCP → サーバーを追加

Type:    HTTP
URL:     https://app.writespace.io/mcp
Header:  Authorization: Bearer ws_pat_YOUR_TOKEN_HERE

Gemini CLI

~/.gemini/settings.json

{
  "mcpServers": {
    "writespace": {
      "httpUrl": "https://app.writespace.io/mcp",
      "headers": {
        "Authorization": "Bearer ws_pat_YOUR_TOKEN_HERE"
      }
    }
  }
}

仕様に準拠したその他の MCP クライアントも、HTTP トランスポートと Authorization: Bearer ヘッダーを使って同様に動作します。

ツール

list_workspaces 以外のすべてのツールには workspace_id が必要です。まず list_workspaces を呼び出して、ワークスペースを確認してください。

ツール	説明
list_workspaces	所属するすべてのワークスペースを一覧表示します
list_folders	フォルダーを一覧表示します。親フォルダーの下にネストして指定することもできます
list_docs	ドキュメントを一覧表示します。フォルダーを指定でき、各行のメタデータを返します
get_doc	ID でドキュメントを取得します — 正規の Tiptap JSON、Markdown レンダリング、メタデータを返します
search	<<match>> スニペット付きの、関連度順の全文検索
query_docs	メタデータに JSON オブジェクト（Postgres JSONB @>）を含むドキュメントを検索します
create_doc	Tiptap JSON または Markdown からドキュメントを作成します
update_doc	タイトル、コンテンツ、またはメタデータを更新します（浅いマージ。null はキーを削除します）
upsert_doc	オプションのフォルダー内でタイトルを指定して作成または更新します — 冪等です
append_to_doc	既存のドキュメントに Markdown / Tiptap JSON を追加します
replace_section	見出しテキストを指定してセクションの本文を置き換えます — 必要な箇所のみ編集します
delete_doc	ID でドキュメントを削除します
move_doc	ドキュメントを別のフォルダーに移動します（folder_id: null → ルート）
create_folder	フォルダーを作成します。ネストして作成することもできます
rename_folder	フォルダーの名前を変更します — ID は維持され、リンクも切れません
delete_folder	フォルダーとその内容を削除します

フォーマットに関する注意事項とトラブルシューティングを含む完全なリファレンス：writespace.io/connect

設計上の注意点

• コンテンツを損なわず、2つの形式に対応 — 読み取りでは content（Tiptap JSON）と content_markdown の両方を返し、書き込みではどちらの形式も受け付けます。エディターがサポートするテーブル、タスクリスト、mermaid 図など、すべての要素で Markdown の往復変換に対応しています。
• 書き込みレスポンスを軽量化 — 書き込みツールはデフォルトでメタデータのみを返すため、長いドキュメントではペイロードを 80～95% 削減できます。本文を返すには include_content: true を指定してください。
• 構造化メタデータ — すべてのドキュメントに JSONB の metadata フィールドがあります。検索可能なフロントマターとして扱い、書き込み、浅いマージ、包含条件による検索ができます。
• ドキュメント間リンクを安定して維持 — ドキュメントは writespace://doc/<id> で参照します。名前変更や移動後も ID は維持されます。
• ライブリロード — MCP による書き込みは Realtime 経由で開いているエディターに通知され、同じタブで再取得されます。

ユースケース

• MCP docs server — エージェントがツールとして利用できるドキュメントバックエンド
• Shared docs for Claude — Claude 用の永続メモリとメモ
• Shared docs for ChatGPT — 同じワークスペースを別のモデルで利用
• MCP knowledge base — どのエージェントからも検索できるチームナレッジ

認証とセキュリティ

• エージェントごとの個人アクセストークンを Settings から発行・取り消しできます — アカウントに紐づいており、簡単にローテーションできます
• トークンは作成時に一度だけ表示されます
• 標準の Authorization: Bearer ws_pat_… ヘッダーを使用します。仕様に準拠した HTTP トランスポートです

リンク

• ウェブサイト：writespace.io
• アプリ：app.writespace.io
• セットアップとツールの完全なリファレンス：writespace.io/connect
• お問い合わせ：[email protected]

---

© 2026 Writespace · Pro はユーザーあたり月額 $5 です。無料プランも利用できます。