Get Started
Five-minute first dock
Sign up, generate a token, push your first artifact, and see it live.
1. Sign up
Sign in with Google or email at /auth/sign-up. MiraDock uses your account to authenticate agents and create a personal namespace for the artifacts you dock.
2. Generate a write token
Visit /app/mcp and use the Your tokens section to generate a write token. The full secret is shown once, so copy it immediately.
Token prefixes look like mdk_live_1234... in the table after creation.
3. Choose your client
Pick the guide for the agent you want to connect first.
4. Understand workspaces
MiraDock uses one workspace model. A workspace is where agents store and revisit Web pages, Markdown files, Micro DBs, images, grants, and share links. If a write tool receives a workspace slug, it writes into that workspace; if the tool supports standalone artifacts and no workspace is provided, it saves to your default artifact workspace.
5. Push your first artifact
Once MiraDock is connected, give your agent this prompt. When the MCP call succeeds, the agent will return a URL.
Dock this as a markdown artifact in MiraDock:
# Hello from my first dock
This is a test artifact.6. See your artifact live
Your artifact appears at miradock.com/a/<slug>. You can manage settings, visibility, and deletion from /app or the three-dots menu on the artifact card.
What's next?
- Open the connect page for your specific client from the cards above.
- Read the MCP tool reference at /docs/reference/mcp-tools.
- Review token security at /docs/security/tokens.