LetDraw

LetDraw MCP + REST

AI アシスタントや独自のスクリプトを LetDraw に接続して、 Model Context Protocol (MCP) または 公開 REST API を通じて、 アカウント内の図を読み取り、作成できます。

LetDraw は、手描き風のオンラインホワイトボード兼図表作成アプリです。この連携を使うと、 MCP クライアント（デスクトップ AI アプリ、Cursor、VS Code、Codex など）や任意の HTTP クライアントから、 ワークスペースの一覧表示、図の作成と更新、コードからの図の生成 （compose / Kubernetes / DOT / Terraform / SQL など）、実際の製品アイコンの配置、 Mermaid または D2 へのエクスポート、読み取り専用リンクの共有ができます。

このリポジトリにはクライアント側の連携機能が含まれています。ゼロコンフィグの MCP ブリッジ、型付き REST SDK、API 仕様、セットアップドキュメントを提供します。LetDraw アプリと サーバーはこのリポジトリには含まれていません。

内容

パス	内容
packages/mcp	@letdraw/mcp — ホスト型 MCP サーバーへのゼロコンフィグ stdio ブリッジ（npx @letdraw/mcp）
packages/sdk	@letdraw/sdk — スクリプト作成用の型付き REST クライアント
spec/mcp-tools.md	MCP ツール、リソース、スコープ
spec/openapi.yaml	REST API の OpenAPI 3.1 仕様
spec/capabilities.md	AI クライアント向け「LetDraw で上手に描く方法」ガイド
docs/	はじめに + クライアントごとのセットアップ（デスクトップアプリ、HTTP クライアント、Cursor、VS Code、Codex）
examples/	コピーして使えるレシピ

エンドポイント

REST base   https://api.letdraw.com/api-v1
MCP URL     https://api.letdraw.com/mcp

どちらもログインセッションではなく、個人用 API トークン（Authorization: Bearer ld_live_…）で認証します。LetDraw アプリの Account → Developer から作成してください。正確な URL と、すぐに貼り付けて使えるクライアント設定も そこに表示されます。

60 秒で開始（MCP）

ホスト型サーバーは Streamable-HTTP に対応しているため、ほとんどのクライアントは直接接続できます。stdio クライアントを使う場合、または最も簡単にセットアップする場合は、ブリッジを使ってください。

// MCP client config (mcpServers block)
{
  "mcpServers": {
    "letdraw": {
      "command": "npx",
      "args": ["-y", "@letdraw/mcp"],
      "env": { "LETDRAW_TOKEN": "ld_live_YOUR_TOKEN" }
    }
  }
}

デスクトップアプリ、HTTP クライアント、Cursor、VS Code、Codex については、docs/clients を参照してください。

60 秒で開始（REST）

curl https://api.letdraw.com/api-v1/workspaces \
  -H "Authorization: Bearer ld_live_YOUR_TOKEN"

または SDK を使う場合：

import { LetdrawClient } from '@letdraw/sdk';
const ld = new LetdrawClient({ token: process.env.LETDRAW_TOKEN! });
const { workspaces } = await ld.listWorkspaces();

スコープ

トークンにはスコープが付与され、各ツール／ルートで必要なスコープが異なります。

• diagrams:read — ワークスペース、フォルダー、図、アイコンの一覧表示／取得
• diagrams:write — 図の作成／更新／削除／共有、コードからの生成
• export — Mermaid / D2 へのエクスポート
• ai:generate — プロンプトから図を生成（独自の AI キーを使用）

ライセンス

MIT — LICENSE を参照してください。「LetDraw」と LetDraw のロゴは所有者の商標です。NOTICE.md を参照してください。