English Français العربية

LetDraw

السجل الرسمي أدوات المطورين

Create, edit, share and export hand-drawn LetDraw diagrams, from code or a prompt.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http letdraw 'https://api.letdraw.com/mcp' --header 'Authorization: <Bearer followed by your personal LetDraw API token (ld_live_...). Create it in the LetDraw app under Account > Developer.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "letdraw": {
            "type": "http",
            "url": "https://api.letdraw.com/mcp",
            "headers": {
                "Authorization": "<Bearer followed by your personal LetDraw API token (ld_live_...). Create it in the LetDraw app under Account > Developer.>"
            }
        }
    }
}
NPM package @letdraw/mcp
Claude Code 
claude mcp add letdraw -e 'LETDRAW_TOKEN=<your letdraw_token>' -e 'LETDRAW_MCP_URL=<LETDRAW_MCP_URL>' -- npx -y @letdraw/mcp@0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "letdraw": {
            "command": "npx",
            "args": [
                "-y",
                "@letdraw/mcp@0.1.2"
            ],
            "env": {
                "LETDRAW_TOKEN": "<your letdraw_token>",
                "LETDRAW_MCP_URL": "<LETDRAW_MCP_URL>"
            }
        }
    }
}

متغيرات البيئة

  • LETDRAW_TOKEN إلزامي سري Your personal LetDraw API token (ld_live_...). Create it in the LetDraw app under Account > Developer.
  • LETDRAW_MCP_URL Override the hosted MCP endpoint. Default: https://api.letdraw.com/mcp

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. LetDraw MCP + REST
  2. What's here
  3. Endpoints
  4. 60-second start (MCP)
  5. 60-second start (REST)
  6. Scopes
  7. License

LetDraw MCP + REST

Connect AI assistants and your own scripts to LetDraw — read and author diagrams in your account through the Model Context Protocol (MCP) or the public REST API.

LetDraw is a hand-drawn–style online whiteboard and diagramming app. With this integration an MCP client (desktop AI apps, Cursor, VS Code, Codex, …) or any HTTP client can list workspaces, create and update diagrams, build a diagram from code (compose / Kubernetes / DOT / Terraform / SQL / …), stamp real product icons, export to Mermaid or D2, and share read-only links.

This repository ships the client-side integration: a zero-config MCP bridge, a typed REST SDK, the API spec, and setup docs. The LetDraw app and server are not part of this repo.

What's here

PathWhat it is
packages/mcp@letdraw/mcp — zero-config stdio bridge to the hosted MCP server (npx @letdraw/mcp)
packages/sdk@letdraw/sdk — typed REST client for scripting
spec/mcp-tools.mdThe MCP tools, resources, and scopes
spec/openapi.yamlOpenAPI 3.1 spec for the REST API
spec/capabilities.md"How to draw well in LetDraw" guide for AI clients
docs/Getting started + per-client setup (desktop apps, HTTP clients, Cursor, VS Code, Codex)
examples/Copy-paste recipes

Endpoints

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

Both authenticate with a personal API token (Authorization: Bearer ld_live_…), not a login session. Create one in the LetDraw app under Account → Developer. The exact URLs and a ready-to-paste client config are shown there too.

60-second start (MCP)

The hosted server speaks Streamable-HTTP, so most clients connect directly. For a stdio client, or for the simplest possible setup, use the bridge:

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

See docs/clients for desktop apps, HTTP clients, Cursor, VS Code and Codex.

60-second start (REST)

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

Or with the SDK:

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

Scopes

Tokens carry scopes; each tool/route requires one:

  • diagrams:read — list/get workspaces, folders, diagrams, icons
  • diagrams:write — create/update/delete/share diagrams, from-code
  • export — export to Mermaid / D2
  • ai:generate — generate a diagram from a prompt (uses your own AI key)

License

MIT — see LICENSE. "LetDraw" and the LetDraw logo are trademarks of their owner; see NOTICE.md.

الأسئلة الشائعة

ما هو LetDraw؟

Create, edit, share and export hand-drawn LetDraw diagrams, from code or a prompt.

كيف أثبّت LetDraw؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http letdraw 'https://api.letdraw.com/mcp' --header 'Authorization: <Bearer followed by your personal LetDraw API token (ld_live_...). Create it in the LetDraw app under Account > Developer.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج LetDraw إلى مفتاح API؟

نعم. يتطلب LETDRAW_TOKEN, Authorization، وتضبطها في إعداداته.

هل LetDraw مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون LetDraw؟

ينشره letdraw. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.