MCP-integration

DiagramKit stiller sine manuelle arbejdsområdeoperationer til rådighed gennem Model Context Protocol (MCP). En tilsluttet klient handler med din kontos eksisterende rettigheder. Den kan læse eller redigere diagrammer og modeller, dokumenter, brainstorms, præsentationer, sprintarbejde og øvrige tilgængelige ressourcer inden for sine tildelte scopes.

Forbind en klient

1. Log ind på DiagramKit, og kontrollér, at du har adgang til det ønskede arbejdsområde.
2. Tilføj https://api.diagramkit.dk/mcp som en ekstern HTTP-MCP-server i din klient.
3. Gennemfør klientens OAuth-login og samtykke gennem den konfigurerede Clerk-autorisationsserver. Klienten skal understøtte OAuth-discovery, PKCE og Client ID Metadata Documents (CIMD) eller bruge en registrering, som operatøren har oprettet. Automatisk Dynamic Client Registration (DCR) er deaktiveret.
4. Anmod kun om de nødvendige scopes, og hent værktøjer og inputskemaer med tools/list.

Ressourcens metadata findes på https://api.diagramkit.dk/.well-known/oauth-protected-resource/mcp. Access tokens skal være udstedt til ressourcen https://api.diagramkit.dk/mcp. En browsersessionscookie eller et token til en anden tjeneste er ikke en MCP-legitimation. Se MCP's autorisationsspecifikation for klientprotokollen.

For en CIMD-klient bruges den offentlige HTTPS-URL til klientens metadatadokument som klient-ID. Den registrerede redirect-URI skal matche callback-adressen i autorisationsforløbet. Klienter, som kun understøtter DCR, kræver en registrering fra operatøren. Almindelige tilladelser omfatter læseadgang og identitet; anmod kun om skriveadgang til redigering. Anmod kun om offline_access, hvis klienten har brug for refresh-tokens.

Rettigheder

Scope	Adgang
diagramkit:read	Læsning, herunder autoriseret eksport af gemte diagrammer
diagramkit:write	Oprettelse, ændring og sletning, som din arbejdsområderolle tillader
diagramkit:admin	Administrative operationer for særskilt godkendte klienter og en administratorkonto

Den almindelige CIMD-klienttilladelse omfatter read/write-scopes; den annoncerer eller giver ikke diagramkit:admin.

Scopes giver ikke medlemskab af et arbejdsområde og gør ikke en seer til redaktør. Værktøjer uden for de tildelte scopes vises ikke ved discovery. Samme autorisationskontrol gælder ved direkte kald til REST-API'et.

Læs, rediger og eksporter

Værktøjsnavne følger de controller-/handlingsnavne, der vises ved discovery. Input samler sti-parametre under path, URL-parametre under query og JSON-data under body. Følg det returnerede skema frem for selv at tilføje konto- eller rettighedsfelter.

Det fundne værktøj render_render accepterer fx:

{
  "path": { "id": "dit-flow-id" },
  "query": { "format": "svg" }
}

Serveren eksporterer det gemte diagram sammen med den fælles model. Resultatet omfatter HTTP-status, indholdstype, kodning og indhold. SVG returneres som tekst; PNG og PDF bruger base64. Rendereren accepterer op til 500 noder og 1.000 forbindelser med begrænset tid og resultatstørrelse; travle eller for store forespørgsler returnerer en fejl frem for at ophobe ubegrænset arbejde.

Diagrammer, dokumenter, præsentationer, brainstorms og planlægningsopgaver kræver den revision, du læste før ændringen: body.expectedRevision ved opdatering og query.expectedRevision ved sletning. En manglende eller forældet revision giver 409. UML-ændringer sender også modellens revision. Indarbejd den ønskede ændring i den nyeste tilstand; hent aldrig blot et nyt revisionsnummer for at overskrive en konflikt.

Værktøjerne resourcehistory_list, resourcehistory_get og resourcehistory_restore giver adgang til samme rettighedsbeskyttede historik som websitet. Se en version før gendannelse, og send dens currentRevision som expectedRevision. Medtag currentModelRevision som expectedModelRevision, når feltet findes. Gendannelse opretter en ny version og kræver write-scope samt Editor- eller Owner-medlemskab. En UML-gendannelse ændrer også arbejdsområdets fælles model; gennemgå de berørte visninger.

Afbryd forbindelsen eller tilbagekald klientens tilladelse gennem OAuth-kontokontrollen, når adgangen ikke længere er nødvendig. Opbevar access- og refresh-tokens i klientens legitimationslager, aldrig i diagramindhold eller delt konfiguration.