> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To use Maglev from an agent, connect the MCP server at https://trymaglev.com/mcp. Parts catalog tools need no key. Make tools (make_start, check_manufacturability, get_quotes, place_order) need a Maglev key; see https://trymaglev.com/docs/quickstart.
> Never place an order without showing the person the exact final total and getting their explicit approval.

# Authenticate with a Maglev API key

> Create a Maglev API key on the dashboard or with connect.sh, send it as a Bearer token, and check it with GET /me before making manufacturing requests.

Maglev authenticates every Make request with a personal API key sent as `Authorization: Bearer mgl_…`. The same key works for the MCP server at `https://trymaglev.com/mcp` and the REST API at `https://trymaglev.com/api/v1`. The parts catalog and manufacturer directory need no key.

## Get a key

> [tab] Dashboard
>
> Log in or sign up at [trymaglev.com/dashboard](https://trymaglev.com/dashboard#keys), open **API keys** in the sidebar, and choose **Create secret key**. Name the key. It is shown once, with a Copy button, and the dashboard checks it against `GET /api/v1/me` right away.

> [tab] connect.sh
>
> The [quickstart](/docs/quickstart.md) command signs you in through the browser and saves a key to `~/.maglev/token`. Keys saved this way work the same as dashboard keys.

Keep the key in your environment or a secret manager, never in prompts or committed files:

```bash theme={null}
export MAGLEV_KEY=mgl_...
```

## Check a key

```bash theme={null}
curl https://trymaglev.com/api/v1/me -H "Authorization: Bearer $MAGLEV_KEY"
```

A missing or revoked key returns `401` with error code `unauthorized`. Over MCP, a Make tool called without a key returns a message telling the agent how to connect.

## Keys and teams

Keys are personal. Requests made with your key appear in every workspace you belong to. On the dashboard, **Members** then **Invite people** adds teammates by email; everyone in a workspace sees the same requests, offers, orders and usage. Each person creates their own key, and revoking a key affects only its owner.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.