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

# Connect from Claude

> Add FloKit to claude.ai as a custom connector, or to the Claude Code CLI with a token.

FloKit connects to Claude two ways: as a **custom connector on claude.ai** (you sign in
with OAuth — nothing to copy), or in the **Claude Code CLI** with an access token. Both
reach the same read-only server.

<Card title="Server URL" icon="link" horizontal>
  `https://api.dashboard.flokitai.com/mcp`
</Card>

## Option A — claude.ai custom connector

<Note>
  Custom connectors are available on Claude Pro, Team, and Enterprise. You'll sign in to
  FloKit and approve access — no token to copy or paste.
</Note>

<Steps>
  <Step title="Open the connector dialog">
    In Claude, go to **Settings → Connectors → Add custom connector**.
  </Step>

  <Step title="Paste the FloKit URL">
    Name it **FloKit** and paste the server URL. Claude discovers the rest automatically.

    <Frame caption="Claude → Settings → Connectors → Add custom connector">
      <img src="https://mintcdn.com/flokitai/dfSJ5h3oFVLOkPx8/images/assistant/claude-add-connector.svg?fit=max&auto=format&n=dfSJ5h3oFVLOkPx8&q=85&s=68646be1663b0a06954b44b07f145e37" alt="Claude add custom connector dialog with the FloKit MCP URL" width="860" height="520" data-path="images/assistant/claude-add-connector.svg" />
    </Frame>
  </Step>

  <Step title="Sign in and approve">
    Claude opens the FloKit consent screen. Sign in with your FloKit work email and click
    **Allow access**. The screen confirms the connection is read-only.

    <Frame caption="The FloKit consent screen — read-only access">
      <img src="https://mintcdn.com/flokitai/dfSJ5h3oFVLOkPx8/images/assistant/consent.svg?fit=max&auto=format&n=dfSJ5h3oFVLOkPx8&q=85&s=d75a5628f85225cc99130ee5e58a31c1" alt="FloKit OAuth consent screen granting status:read" width="860" height="520" data-path="images/assistant/consent.svg" />
    </Frame>
  </Step>

  <Step title="Ask FloKit something">
    Back in Claude, try:

    ```text theme={null}
    Give me a daily briefing on my app and anything waiting on my approval.
    ```

    Claude calls `get_status` and `list_pending_approvals` and answers in plain language.
    You can also pick the **Daily briefing**, **What's waiting on me**, or **Show me
    around** prompt from Claude's prompt menu.
  </Step>
</Steps>

## Option B — Claude Code (CLI)

Claude Code authenticates with a bearer token instead of the browser sign-in.

<Steps>
  <Step title="Create an access token in FloKit">
    In the dashboard, go to **Settings → Connected assistants** and click **Create** under
    Access token. Copy it (it starts with `flk_live_`).

    <Frame caption="Dashboard → Settings → Connected assistants">
      <img src="https://mintcdn.com/flokitai/dfSJ5h3oFVLOkPx8/images/assistant/dashboard-connect.svg?fit=max&auto=format&n=dfSJ5h3oFVLOkPx8&q=85&s=d3f0da436abb8a0412517162de50c1a4" alt="FloKit dashboard connected assistants panel with server URL and access token" width="860" height="520" data-path="images/assistant/dashboard-connect.svg" />
    </Frame>
  </Step>

  <Step title="Add the server">
    ```bash theme={null}
    claude mcp add --transport http flokit \
      https://api.dashboard.flokitai.com/mcp \
      --header "Authorization: Bearer flk_live_your_token_here"
    ```
  </Step>

  <Step title="Confirm it's connected">
    ```bash theme={null}
    claude mcp list
    ```

    You should see `flokit` listed. In a Claude Code session, ask:

    ```text theme={null}
    What's going on with my app?
    ```
  </Step>
</Steps>

<Tip>
  Treat the access token like a password — it grants read access to your workspace.
  Revoke it any time from **Settings → Connected assistants**; the connection stops
  working immediately.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Claude says the connection needs authorization">
    The token was revoked or expired. Create a new one in **Settings → Connected
    assistants** and re-run `claude mcp add`, or reconnect the claude.ai connector.
  </Accordion>

  <Accordion title="'Your workspace hasn't finished onboarding'">
    The connector reads the same data the dashboard does, which unlocks after onboarding
    completes. Finish onboarding, then ask again.
  </Accordion>

  <Accordion title="No approvals show up">
    That's the normal, healthy state — nothing is waiting on you. `list_pending_approvals`
    returns an empty queue rather than an error.
  </Accordion>
</AccordionGroup>