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

# Troubleshooting

> Solutions to common issues with the Flowla MCP server.

## Switching to a different Flowla organisation

Claude caches your OAuth session in `~/.mcp-auth`. If you want to sign in to a
different Flowla account or organisation, clear that cache and restart Claude:

<Tabs>
  <Tab title="Mac / Linux">
    1. Quit Claude Desktop completely.
    2. Run in your terminal:
       ```bash theme={null}
       rm -rf ~/.mcp-auth
       ```
    3. Reopen Claude Desktop — you will be prompted to authorise Flowla again.
  </Tab>

  <Tab title="Windows (PowerShell)">
    1. Quit Claude Desktop completely.
    2. Run in PowerShell:
       ```powershell theme={null}
       Remove-Item -Recurse -Force "$env:USERPROFILE\.mcp-auth"
       ```
    3. Reopen Claude Desktop — you will be prompted to authorise Flowla again.
  </Tab>
</Tabs>

## Flowla does not appear in Settings → Developer

The MCP server entry is written to Claude's config file during installation.
If it is missing:

1. Re-run the install script — it is safe to run more than once and will not
   duplicate the entry.
2. Make sure you fully quit and reopen Claude Desktop after installation (not
   just close the window).
3. Check that the config file was written correctly. On Mac the file is at:
   ```
   ~/Library/Application Support/Claude/claude_desktop_config.json
   ```
   It should contain a `"flowla"` key inside `"mcpServers"`.

## Tools are not available in a conversation

If Flowla appears in Settings → Developer but Claude says the tools are
unavailable:

1. Start a **new conversation** — tools are loaded per session.
2. If a new conversation does not help, quit and reopen Claude Desktop.
3. Check your internet connection — the MCP server is remote and requires
   network access.