DiagramZu

@diagramzu/mcp

diagramzu.ai 用の MCP サーバーです。Claude Code、Claude Desktop、Cursor、Windsurf、ChatGPT のカスタム GPT、および任意の MCP クライアントで、Space 内の Mermaid 図を読み書きできます。

AI に話しかけて図を作成すると、Space の diagramzu.ai/app/d/<id> に保存されます。チームで閲覧したり、公開リンクを共有したりできます。

公式の MCP Registry では ai.diagramzu/mcp として利用できます。

1. トークンを取得する

diagramzu.ai に登録し、diagramzu.ai/app/settings/connections で API トークンを作成します。トークンは dz_live_… の形式で、1 つの Space に紐付けられています。別途 space-id を指定する必要はありません。

2. クライアントを接続する

ホスト型サーバーを使うのが手軽です。インストールもビルドも不要で、設定を貼り付けるだけです。

Claude Code

claude mcp add --scope user --transport http diagramzu https://mcp.diagramzu.ai/mcp \
  --header "Authorization: Bearer dz_live_xxx"

Claude Desktop、Cursor、Windsurf、Cline

クライアントの MCP 設定に追加します（macOS の Claude Desktop では ~/Library/Application Support/Claude/claude_desktop_config.json、Cursor では ~/.cursor/mcp.json など）。

{
  "mcpServers": {
    "diagramzu": {
      "type": "http",
      "url": "https://mcp.diagramzu.ai/mcp",
      "headers": { "Authorization": "Bearer dz_live_xxx" }
    }
  }
}

ChatGPT のカスタム GPT（Actions）

GPT ビルダーで、https://mcp.diagramzu.ai/mcp を指す MCP サーバーアクションを追加し、Bearer トークン認証ヘッダーに dz_live_… トークンを設定します。

ローカル stdio（リモート MCP に対応していないクライアント向け）

npx -y @diagramzu/mcp

環境変数：

DIAGRAMZU_BASE_URL=https://diagramzu.ai
DIAGRAMZU_API_TOKEN=dz_live_xxx
DIAGRAMZU_SPACE_ID=<your space id>   # optional

DIAGRAMZU_SPACE_ID は任意です。設定しない場合、サーバーはトークン自体のデフォルトワークスペースを使用します。これはトークン作成時に選択されたワークスペースです。別のワークスペースをこのプロセスのデフォルトとして固定する場合は、値を設定してください。

ほとんどのユーザーには、上記のリモート HTTP トランスポートをおすすめします。stdio 方式は、HTTP MCP に対応していないクライアント向けです。

ワークスペース

トークンは、認証時（同意ページのアクセスラジオボタン、または「設定」→「API トークン」）に選択した、1 つのワークスペースまたは所有者が参加しているすべてのワークスペースに紐付けられます。アカウントに紐付けられたトークンは、所有者の現在のメンバーシップを反映します。ワークスペースに参加するとアクセス対象に追加され、メンバーから削除されると、次の呼び出しからアクセスできなくなります。

• list_spaces は、この接続で操作可能なすべてのワークスペース、デフォルトのワークスペース、および各ワークスペースでのロールを表示します。
• それ以外のすべてのツールでは、省略可能な space を指定できます。値にはワークスペース ID、スラッグ、または正確な名前（大文字・小文字を区別しません）を指定します。省略すると、デフォルトのワークスペースが操作対象になります。複数のワークスペースに一致する名前は推測せずに拒否されるため、ID またはスラッグを指定してください。
• すべてのツールの結果には、操作対象のワークスペースが末尾に表示されます。
• 返される /app/... リンクには ?space= が含まれているため、メンバーであれば、リンクを開くとブラウザーがそのワークスペースに切り替わります。

ツール

ツール	説明
list_spaces	この接続で操作できるすべてのワークスペースを、ID、スラッグ、ロール、デフォルトかどうかとともに一覧表示します
list_diagrams	Space 内の図を一覧表示します（q で絞り込み、updated / created で並べ替え）
list_folders	Space 内のフォルダーを一覧表示します
get_diagram	ID で図を 1 つ取得します（タイトル、説明、Mermaid ソース）
create_diagram	新しい図を作成します（ID と /app/d/<id> URL を返します）
update_diagram	既存の図のタイトル、Mermaid ソース、説明、スタイルを更新します
analyze_diagram	図の構造的な概要を取得します（ノード、エッジ、密度）
list_versions	図のバージョン履歴を一覧表示します
get_version	図の特定の過去バージョンを取得します
list_comments	図のコメントを古い順に一覧表示します（必要に応じて 1 つのノードのスレッドのみを対象にできます）
add_comment	コメントを投稿します。必要に応じてノードにピン留めしたり、スレッドに返信したりできます
list_decks	Space 内のプレゼンテーションデッキを、編集日時が新しい順に一覧表示します
get_deck	ID でデッキを 1 つ取得します（スライドの順序を含む）
create_deck	既存の図を順序付けてプレゼンテーションデッキにまとめます
update_deck	デッキのタイトル、説明、スライドの順序を変更します（slides は宣言的です）
list_pages	ワークスペースの Markdown ページを一覧表示します（ID、タイトル、リビジョン、抜粋。q で絞り込み）
get_page	ID でページを 1 つ取得します。本文全体、アウトラインのみ、または 1 つのセクションのみを取得できます
create_page	Markdown ページを作成します（タイトルは本文のフロントマターまたは最初の見出しから取得します）
update_page	ページを編集します。対象を指定した edits、または baseRevision と新しい本文全体 body を指定できます

公開される URL

ここでは「リンク」と呼ばれるものが 2 種類あり、Space の外部にいる人が利用できるのはそのうち 1 つだけです。

URL	開けるユーザー
diagramzu.ai/app/d/<id>	Space のメンバーのみ — アプリ内の図です。
diagramzu.ai/app/present/<deck id>	Space のメンバーのみ — デッキのプレゼンテーションビューです。
diagramzu.ai/app/pages/<id>	Space のメンバーのみ — アプリ内の Markdown ページです。
diagramzu.ai/s/<slug>	リンクを知っている人なら誰でも — 公開の読み取り専用図ページです。
diagramzu.ai/s/p/<slug>	リンクを知っている人なら誰でも — 公開の読み取り専用デッキです。
diagramzu.ai/s/pg/<slug>	リンクを知っている人なら誰でも — 公開の読み取り専用 Markdown ページです。

ツールが返すのは /app/… URL なので、チャットからそのままコピーして貼り付けたリンクはメンバー専用です。Space の外部にいる人に送ると、サインイン画面が表示されます。公開するには、DiagramZu で図、デッキ、またはページを開き、共有ボタンを使ってください。この MCP サーバーには、意図的に公開リンクを生成するツールを含めていません。トークンで生成できないからではなく（dz_live_… トークンを使えば REST API 経由で生成できます）、Space のコンテンツの公開は会話の副作用ではなく、人が意図的に行うべき操作だからです。図に公開リンクがある場合、get_diagram と update_diagram はそれぞれ独自の Share (public, read-only): 行にそのリンクを表示します。

Markdown ページも同じ方法で共有します。 diagramzu.ai/s/pg/<slug> は公開読み取り専用の URL で、ページの共有ボタンから人が生成します。そのため、get_page、create_page、update_page はメンバー専用の /app/pages/<id> URL を表示し、より広く共有する場合はそのボタンを案内します。これらのツールはページのリンクを検索しません。get_diagram とは異なり、Share (public, read-only): 行を表示しないため、ページの公開 URL はエージェントが見つけるものではなく、人が共有するものです。

セットアップを紹介する

MCP / Claude Code の設定を dotfiles またはサンプルのリポジトリで公開する場合は、次の内容を README に追加すると、図の入手元を次の人に伝えられます。

[![MCP: diagramzu](https://diagramzu.ai/badge/mcp.svg)](https://diagramzu.ai)

小さなシールド風バッジとして表示されます。グレーの MCP とインディゴの diagramzu です。

ローカル開発（このリポジトリ）

diagramzu 自体の開発に取り組む場合は、ソースからビルドしてください。

cd packages/mcp-diagramzu
pnpm install
pnpm run build
# point your client at: node dist/index.js
# with DIAGRAMZU_BASE_URL / DIAGRAMZU_API_TOKEN (DIAGRAMZU_SPACE_ID optional)

ライセンス

MIT