Task guide

Connect an agent with a personal key

Create a key, connect to MCP, discover shapes, and validate a small model.

Before you start

Prerequisites: An active account and an MCP client that supports authenticated HTTP servers.
Permissions and plan: Personal keys inherit their owner's access. A key does not bypass organization permissions.

Steps

Open the MCP setup page, sign in, and create a personal key. Store it privately; it is shown once.
Configure your client's HTTP MCP server using the endpoint and authentication instructions on that page.
Ask the agent to call list_shapes for the exact service types it needs.
Ask it to create the small example below, retain the returned diagram ID, and validate it.
Use patch_diagram for small changes. Revoke a key from the key-management interface when it is no longer needed.

Runnable example

Flowboard Markdown

Copy this model into Import in the editor. Export current work first. The two stable identifiers, api and db, connect the services to the flow.

# Request path

- API {#api type=service x=100 y=120}
- Database {#db type=database x=500 y=120}

## Flows
- api -> db {#requests label="requests" color=#f05a47 speed=1 direction=forward}

Change a label to describe your system. Keep the identifiers the same when you want existing connections to keep referring to those nodes.

Check your work

Expected outcomeYour agent can discover shapes and work with an authorized diagram.

Next steps

Try the workflow in the editor, then use the reference for control details and model syntax.

Open the example or setup page Detailed reference

If a step does not work, keep an export of your model and follow the troubleshooting guide. Include the error message when contacting support, without sharing credentials or private architecture.