Gå til indhold

Udvikler

Udvikler findes i Konto-gruppen på siden Kontoindstillinger. Du opretter og administrerer personlige API-tokens til letdraws REST API og MCP-server her. Med disse tokens kan du tilgå letdraw-diagrammer programmatisk fra et script eller forbinde en AI-klient (såsom Claude eller Cursor) til LetDraw over MCP.

Kontoindstillinger → Udvikler-sektionen

Loggede Pro/Enterprise-brugere (på SaaS) eller alle medlemmer på selvhostet.

Fra kortet Opret et token:

  • Navn: en etiket, der hjælper dig med at huske tokenet (f.eks. “Min bærbare”, “CI-script”, “Claude MCP”).
  • Scopes: du vælger, hvad tokenet er autoriseret til at gøre (mindste-privilegium- princippet; giv kun, hvad der er nødvendigt):
    • diagrams:read (Læs diagrammer): læser/lister diagrammer.
    • diagrams:write (Opret og redigér diagrammer): opretter og ændrer diagrammer.
    • export (Eksport): eksporterer et diagram som Mermaid / D2 / SVG.
    • ai:generate (Generér fra prompt): genererer et diagram fra en tekstprompt (AI).
  • Arbejdsområde: du kan afgrænse tokenet til alle arbejdsområder eller til kun et enkelt arbejdsområde.
  • Tryk på Opret token.

Når tokenet er oprettet, vises dets rå værdi (med præfikset ld_live_…) kun én gang; serveren gemmer kun et digest af det og kan aldrig vise den fulde værdi igen. Kopiér det med det samme, og opbevar det et sikkert sted. Hvis du mister det, får du et nyt ved at rotere det.

Hvert token, du opretter, vises i kortet Dine tokens; dets navn, præfiks, scopes, (eventuelle) arbejdsområde og senest brugt-dato vises. Der er to handlinger:

  • Rotér: genererer et nyt token og ugyldiggør øjeblikkeligt det gamle. Brug det, når du har mistanke om en lækage, eller til periodisk fornyelse; opdatér derefter dine klienter med det nye token.
  • Tilbagekald: deaktiverer tokenet permanent. Enhver klient, der bruger det, holder op med at virke øjeblikkeligt.

Kortet Tilslutning viser, hvor og hvordan du sender dit token. Tokenet sendes ved hver forespørgsel som en Bearer-header:

Authorization: Bearer <your-token>

Der er to endpoints (kan kopieres på kortet; dem nedenfor er SaaS-adresserne; på selvhostet er det din egen servers adresse):

  • REST API-basisadresse: https://api.letdraw.com/api-v1 (til programmatisk adgang fra scripts).
  • MCP-server-URL: https://api.letdraw.com/mcp (til at forbinde en AI-klient).

MCP (Model Context Protocol) lader AI-klienter (såsom Claude eller Cursor) bruge LetDraw som et værktøj: din klient forbinder til letdraws MCP-server med dit token og læser, opretter, redigerer eller eksporterer diagrammer (hvad end dit tokens scopes tillader).

Trin:

  1. Opret et token ovenfor.
  2. Vælg din klient fra kortet Forbind en MCP-klient.
  3. Indsæt den givne konfiguration i den relevante fil, og gem. (Hvis du netop har oprettet et token, indlejres det automatisk i konfigurationen; ellers skal du erstatte pladsholderen ld_live_YOUR_TOKEN med dit eget token.)
  4. Genstart klienten.

Understøttede klienter og konfigurationsplaceringer:

KlientKonfigurationsplaceringForbindelsesformat
Cursor~/.cursor/mcp.jsonDirekte remote HTTP
VS Code.vscode/mcp.jsonDirekte remote HTTP (type: http)
Claude CodeTerminal (kommando)claude mcp add-kommando
Claude Desktopclaude_desktop_config.jsonnpx mcp-remote-bro
Codex~/.codex/config.tomlnpx mcp-remote-bro
OpenCodeopencode.jsonRemote (type: remote)

For hver klient leverer kortet den fulde klar-til-indsætning-konfiguration. Eksempler:

Cursor (~/.cursor/mcp.json):

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

Claude Code (i terminalen):

Terminal window
claude mcp add --transport http letdraw https://api.letdraw.com/mcp \
--header "Authorization: Bearer ld_live_YOUR_TOKEN"

Bro-note: Da Claude Desktop og Codex ikke taler remote HTTP MCP direkte, brofores de via npx mcp-remote; for disse klienter skal Node.js være installeret, og efter lagring skal du genstarte klienten.

  • Et API-token er lige så stærkt som en adgangskode; del det ikke med nogen, og læg det ikke i offentlige repositories.
  • Mindste privilegium: giv kun de nødvendige scopes, og afgræns, hvor det er muligt, tokenet til et enkelt arbejdsområde.
  • Det rå token vises kun én gang; serveren beholder kun dets digest.
  • I tilfælde af lækage eller mistanke: Rotér eller Tilbagekald.

For den fulde liste over endpoints, scopes og MCP-værktøjer, se siden API- og MCP-reference.