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

# Connect an MCP client

> Connect through approved OAuth or a workspace-pinned personal access token.

Floral Agent must be enabled for the workspace before an MCP connection can use it. A workspace administrator controls that setting under **Settings > Assistants**.

## Connect with OAuth

Use OAuth when your approved MCP client supports remote server sign-in.

<Steps>
  <Step title="Add the server">
    In the MCP client, add `https://app.floral.so/mcp` as a remote server.
  </Step>

  <Step title="Sign in to Floral">
    Follow the client connection flow. Floral asks you to sign in and choose an eligible organization and workspace.
  </Step>

  <Step title="Approve the connection">
    Review the selected workspace before you continue. The resulting OAuth connection is read-only.
  </Step>

  <Step title="Check Floral settings">
    The connection appears under **Settings > Assistants > MCP**, where you can disconnect it.
  </Step>
</Steps>

OAuth clients must be approved for Floral's MCP resource. If the client cannot start or complete the sign-in flow, use a personal access token if it supports custom headers, or contact Floral.

## Connect with a personal access token

<Steps>
  <Step title="Open MCP settings">
    In the target workspace, open **Settings > Assistants > MCP** and select **New key**.
  </Step>

  <Step title="Choose access">
    Give the key a recognizable name, select the smallest required scopes, and choose 30 days, 90 days, one year, or no expiry.
  </Step>

  <Step title="Copy the key">
    Copy it when Floral displays it. The full value is shown once.
  </Step>

  <Step title="Configure the client">
    Use the MCP server URL and send the key as a bearer token:
  </Step>
</Steps>

```http theme={null}
Authorization: Bearer floral_pat_...
```

Client configuration formats differ. Use the client's current documentation to set a custom header. Revoke the key in Floral when the client is retired or the key may have been exposed.