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

# Create a connection

> Make an API key, choose what it can reach, and get the connection URL.

Go to **Settings → MCP**, under **Integrations**.

<Frame>
  <img src="https://statics.depost.ai/docs/mcp/create-key.png?v=2" alt="The create API key dialog showing key name, brand access, and the permission checkboxes with the first four ticked" />
</Frame>

## Creating a key

<Steps>
  <Step title="Click Create API key">
    Give it a name you'll recognise later — the client it's for, or the person using it.
  </Step>

  <Step title="Choose the brand access">
    Pick a single brand, or **All brands** — which creates one key with full access to every
    brand in the workspace.
  </Step>

  <Step title="Tick the permissions">
    **Context**, **Content knowledge**, **Analytics** and **Drafts** are on by default.
    **Publishing** (marked high risk), **Draft media**, **Knowledge writes** and the two
    workspace-wide reads are opt-in.
  </Step>

  <Step title="Copy the connection URL">
    This is the only time you'll see it.

    <Frame>
      <img src="https://statics.depost.ai/docs/mcp/key-created.png?v=2" alt="The API key created dialog, confirming the key was made and offering the connection URL and the raw API key, each with a copy button" />
    </Frame>

    You get two things. The **connection URL** is the one you want — it's what almost every
    client asks for, and the key is already inside it. The **API key** on its own is only
    for clients that want an Authorization header instead.
  </Step>
</Steps>

<Warning>
  **The full connection URL is shown once, at creation.** If you lose it, you can't recover
  it — delete the key and create a new one.
</Warning>

## Brand key or workspace key

<CardGroup cols={2}>
  <Card title="Brand key" icon="megaphone">
    Scoped to one brand. The client acts on that brand and sees nothing else. Right for most
    people, and for anyone working on a single client.
  </Card>

  <Card title="All brands" icon="building">
    Full access to every brand in the workspace, plus the cross-brand analytics and calendar
    tools. Workspace analytics is admins only. For someone reporting across clients.
  </Card>
</CardGroup>

With a workspace key, anything that *writes* still needs the brand named explicitly — so a
client can't save a draft to the wrong brand by accident.

## Managing keys

<Frame>
  <img src="https://statics.depost.ai/docs/mcp/settings-keys.png?v=2" alt="The MCP settings page listing API keys with their access, permissions and last used date" />
</Frame>

The keys table shows each key's name, access, permissions, when it was last used, and when
it was created. **Last used** is the one to check periodically — a key that's never been
used is either a failed setup or one worth deleting.

**Delete** revokes a key immediately. Any client using it stops working at once, so it's the
right response to a URL you think has leaked.

## Choosing permissions well

<AccordionGroup>
  <Accordion icon="shield" title="Start without Publishing">
    Drafting is reversible; publishing to LinkedIn isn't — and the dialog marks it high risk
    for that reason. Run without it for a while and add it once you trust the setup.
  </Accordion>

  <Accordion icon="user" title="One key per client, not one shared key">
    Separate keys can be revoked separately. A single shared key means revoking it breaks
    everyone.
  </Accordion>

  <Accordion icon="building" title="Only use a workspace key if you need cross-brand reads">
    A brand key is a smaller blast radius. Reach for the workspace key when you actually
    want reporting across brands.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Connect Claude or ChatGPT" icon="link" href="/mcp/connect">
    What to do with the URL you just copied.
  </Card>

  <Card title="What the connector does" icon="plug" href="/mcp/overview">
    Permissions and capabilities in full.
  </Card>
</CardGroup>
