API og MCP

letdraws REST API og MCP-server lar eksterne verktøy og AI-klienter (Claude, Cursor) arbeide med diagrammene dine: liste opp, lese, opprette, oppdatere, generere et diagram fra kode, konvertere tilbake til kode, dele og generere fra en ledetekst.

Hvem som kan bruke det

API-et og MCP er tilgjengelig for Pro- og Enterprise-brukere. På selvhostede installasjoner kan hvert innlogget medlem bruke dem. Gratis- og gjestebrukere kan ikke opprette tokens.

1. Opprett et token

1. Logg inn på LetDraw med en Pro/Enterprise-konto.
2. Gå til Settings -> Developer.
3. Opprett et token: gi det et navn, velg scopes (se nedenfor), og valgfritt begrens det til ett enkelt arbeidsområde.
4. Det genererte ld_live_...-tokenet vises bare én gang. Lagre det et sted trygt. Hvis det lekker, tilbakekall det fra samme side.

Scopes

Scope	Tillatelse
diagrams:read	Les arbeidsområder, mapper og diagrammer
diagrams:write	Opprett, oppdater, slett og del diagrammer
export	Eksporter et diagram til Mermaid/D2-kode
ai:generate	Generer et diagram fra en ledetekst (AI)

2. Autentisering

Send tokenet som en Bearer-verdi i Authorization-headeren på hver forespørsel:

Authorization: Bearer ld_live_...

Ingen ekstra apikey-header er nødvendig.

REST API

Base-URL: https://api.letdraw.com/api-v1

Alle svar er JSON. Feil returneres med en standard body: { "error": { "code", "message" } }.

Metode	Sti	Beskrivelse	Scope
GET	/	API-info (scopes, endepunkter)	any
GET	/workspaces	Dine arbeidsområder (med rolle)	read
GET	/folders?workspace=<id>	Mapper i et arbeidsområde	read
GET	/documents?workspace=<id>	Diagrammer i et arbeidsområde (paginert)	read
GET	/documents?folder=<id>	Diagrammer i en mappe (paginert)	read
POST	/documents	Opprett et diagram	write
GET	/documents/:id	Diagram + scene (elementer)	read
PATCH	/documents/:id	Oppdater navn og/eller elementer	write
DELETE	/documents/:id	Slett et diagram	write
POST	/documents/from-code	Generer et diagram fra kode	write
POST	/documents/generate	Generer et diagram fra en ledetekst (AI)	ai:generate
GET	/documents/:id/export?format=mermaid|d2	Eksporter et diagram til kode	export
POST	/documents/:id/share	Opprett en offentlig skrivebeskyttet lenke	write
DELETE	/documents/:id/share	Fjern den offentlige lenken	write

Paginering

Liste-endepunkter tar ?limit= (1-100, standard 50) og ?cursor=. Svaret returnerer en nextCursor; send den som cursor for å få neste side.

Hastighetsgrense

120 forespørsler per minutt per token. Å overskride den returnerer 429 rate_limited.

Eksempler

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

# Generate a diagram from a docker-compose
curl -X POST -H "Authorization: Bearer ld_live_..." -H "Content-Type: application/json" \
  -d '{"workspaceId":"<id>","code":"services:\n  web:\n    image: nginx\n    depends_on: [db]\n  db:\n    image: postgres\n"}' \
  https://api.letdraw.com/api-v1/documents/from-code

# Export a diagram to Mermaid
curl -H "Authorization: Bearer ld_live_..." \
  "https://api.letdraw.com/api-v1/documents/<id>/export?format=mermaid"

MCP-server

Model Context Protocol (MCP)-klienter (Claude, Cursor) kan koble seg til LetDraw og arbeide med diagrammene dine gjennom verktøy.

• URL: https://api.letdraw.com/mcp
• Transport: Streamable HTTP (tilstandsløs JSON-RPC 2.0)
• Auth: Authorization: Bearer ld_live_...

Verktøy

Verktøy	Beskrivelse
list_workspaces	Tilgjengelige arbeidsområder
list_diagrams	Diagrammer i et arbeidsområde/mappe
get_diagram	Diagram + scene
create_diagram	Opprett et diagram fra en elementmatrise (letdraw- eller Excalidraw-format, auto-detektert)
update_diagram	Oppdater navn/elementer
delete_diagram	Slett et diagram
diagram_from_code	compose, kubernetes, dot, plantuml, terraform, helm, sql -> diagram
export_to_code	Diagram -> Mermaid/D2
share_diagram	Opprett en offentlig lenke
unshare_diagram	Fjern den offentlige lenken
generate_from_prompt	Diagram fra naturlig språk (AI)

Merknad

generate_from_prompt krever en server-lagret OpenAI- eller OpenRouter-nøkkel på kontoen din (Settings -> API Keys). Uten en nøkkel returnerer den no_ai_key.

Klientoppsett

Du kan kopiere ferdiglagde konfigurasjonsblokker med ditt eget token fra Settings -> Developer-siden. Erstatt ld_live_... nedenfor med ditt eget token.

Cursor

~/.cursor/mcp.json (global) eller .cursor/mcp.json i prosjektroten:

{
  "mcpServers": {
    "letdraw": {
      "url": "https://api.letdraw.com/mcp",
      "headers": { "Authorization": "Bearer ld_live_..." }
    }
  }
}

Claude Desktop

Claude Desktop kobler seg til den eksterne HTTP-serveren gjennom mcp-remote-broen (Node.js kreves). Konfigurasjonsfil:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "letdraw": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://api.letdraw.com/mcp",
        "--header", "Authorization:Bearer ld_live_..."
      ]
    }
  }
}

Start klienten på nytt etter lagring. Eksempelledetekster:

• “List my LetDraw workspaces.”
• “Turn this docker-compose into a diagram in letdraw: …”
• “Export diagram as Mermaid.”
• “Generate an OAuth login flow diagram.”
• “Draw this cloud architecture in letdraw: …” (fritt utformet komposisjon)

Å be AI-en om å “tegne det i LetDraw”

create_diagram og update_diagram godtar elementmatrisen i to formater: letdraws eget elementskjema eller Excalidraw-formatet. Formatet auto-detekteres, og Excalidraw-elementer konverteres til letdraw-elementer på serversiden (inkludert fargede nestede beholdere, figurbundne etiketter, piler med bindinger, tekst og rammer).

Hva dette betyr: når du ber ChatGPT, Gemini eller Claude om å “tegne denne arkitekturen i LetDraw”, produserer modellen Excalidraw JSON som den allerede kjenner svært godt fra treningsdataene sine og sender det over MCP; LetDraw tegner den nøyaktige ekvivalenten. Uansett hva modellens layoutkvalitet er, er det det du får i LetDraw.

Merknad

Excalidraw er et varemerke tilhørende Excalidraw-teamet; LetDraw tilbyr bare filformat- kompatibilitet og har ingen tilknytning til Excalidraw.

Bygge inn et diagram (render.svg)

Du kan bygge inn et offentlig delt diagram som SVG på steder som en README eller Notion. Hent først et delingstoken med share_diagram (eller REST .../share), deretter:

https://api.letdraw.com/render-svg?token=<share-token>

Dette endepunktet returnerer image/svg+xml og krever ingen API-token (bare delte diagrammer gjengis), så du kan bruke det direkte inne i <img src="...">.