How to make diagrams in GitHub Copilot (VS Code)

1. Connect Diagram to VS Code + Copilot

Use the one-click Add to VS Code button on the setup page. Or run "MCP: Add Server" from the Command Palette, choose HTTP, paste this URL, and choose Global. VS Code asks you to trust the server the first time it starts:

https://diagram.la/mcp

Sign in once: When VS Code starts the server, it asks to sign in: allow it, then sign in to Diagram and click Allow.

2. Ask VS Code + Copilot for a diagram

Open your repo and switch Copilot Chat to Agent mode, then describe what you want in plain words. For example:

• “Make an architecture diagram of this workspace and give me a link I can share.”
• “Draw what happens when this API route is called, down to the database.”
• “Show the data model as an entity diagram, from the schema in this repo.”
• “Turn the Mermaid in docs/architecture.md into a diagram I can send to my team.”

VS Code + Copilot draws it, saves it to Diagram as a draft only you can see, and gives you a link. Keep the link open: when you ask for a change, the page updates by itself. Nothing is left in a local file you’d have to remember to upload, and you never have to mention Diagram again: it knows to use it.

3. Publish it and share the link

When it looks right, tell VS Code + Copilot to publish it. It asks first and says who will be able to see it: the people on its project. Then paste the link in Slack, a pull request, or a doc. To change it later, ask VS Code + Copilot: the link stays the same and every version is kept.