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

# Troubleshooting & FAQ

> Common issues and solutions when using the Feedspace MCP server.

## Common Issues

<AccordionGroup>
  <Accordion title="Authentication failed or unable to connect" icon="lock">
    **Possible causes and solutions:**

    * Verify you are using the correct server URL: `https://mcp.feedspace.io/mcp`
    * Make sure you have completed the OAuth sign-in flow in your browser when prompted
    * Try removing and re-adding the MCP server in your client settings
    * Check that your Feedspace account is active at [app.feedspace.io](https://app.feedspace.io)
    * Clear your MCP client's cached credentials and re-authenticate
  </Accordion>

  <Accordion title="No workspaces found" icon="building">
    **Possible causes and solutions:**

    * You must have at least one workspace in your Feedspace account
    * Sign in to [app.feedspace.io](https://app.feedspace.io) and create a workspace if needed
    * Ensure you authenticated with the correct Feedspace account
    * If you were recently added to a workspace, the owner may need to verify your access
  </Accordion>

  <Accordion title="Tools not appearing or 'tool not found'" icon="wrench">
    **Possible causes and solutions:**

    * Restart your AI tool (the Claude desktop app in particular needs a restart after configuration changes)
    * Verify the server URL in your client is exactly `https://mcp.feedspace.io/mcp` with no trailing slash or extra path
    * Ensure you are using **Streamable HTTP** as the transport type
  </Accordion>

  <Accordion title="Permission denied errors" icon="shield">
    **Possible causes and solutions:**

    * Your role in the workspace may not have sufficient permissions
    * **Admins** have full access; **Editors** can modify forms, pages, and widgets; **Viewers** have read-only access
    * Contact the workspace Admin to adjust your role
    * Use `list_team_members` to check your current role in the workspace
  </Accordion>

  <Accordion title="Reviews not showing in widgets or pages" icon="eye-slash">
    **Possible causes and solutions:**

    * Make sure you are passing the correct `feed_identifier` values (format: `feed-{type}-item-{id}`)
    * Use `get_reviews` or `filter_reviews` to get the exact identifiers
    * Verify the reviews exist and belong to the correct workspace
    * Check that the reviews have not been soft-deleted
  </Accordion>

  <Accordion title="Slow responses or timeouts" icon="clock">
    **Possible causes and solutions:**

    * If fetching large datasets, use pagination parameters (`page`, `perPage`) to limit results
    * For bulk operations on many reviews, use `batch_update_reviews` rather than individual calls
    * If the issue persists, try again after a few moments
  </Accordion>
</AccordionGroup>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can I delete reviews through the MCP server?" icon="trash">
    **No.** The server never exposes a delete tool of any kind. This is a deliberate rule, so that an AI assistant cannot cause data loss. To delete reviews, forms, widgets, or pages, use the [Feedspace dashboard](https://app.feedspace.io) directly.

    The only "removal" operations available are `unassign_labels` (removes a label association, not the review itself) and unfavouriting, via `favourite_review` or the `unfavourite` action on `batch_update_reviews` (removes the favourite flag).
  </Accordion>

  <Accordion title="Which AI clients are supported?" icon="robot">
    Feedspace supports and documents six AI tools:

    * [ChatGPT](/mcp/setup/chatgpt)
    * [Claude](/mcp/setup/claude) (web and desktop)
    * [Perplexity](/mcp/setup/perplexity)
    * [Lovable](/mcp/setup/lovable)
    * [Bolt](/mcp/setup/bolt)
    * [v0](/mcp/setup/v0)

    The server follows the **Model Context Protocol** over **Streamable HTTP** with OAuth, so other MCP-compatible clients can connect using the same URL. They are not officially supported, and setup steps vary by client.
  </Accordion>

  <Accordion title="Is my data secure?" icon="shield-check">
    Yes. Authentication uses **OAuth 2.1 with PKCE**, the industry standard for secure authorization. Your Feedspace credentials are never shared with the AI assistant. The bearer token is scoped to your account and transmitted over HTTPS.
  </Accordion>

  <Accordion title="Can multiple team members use the MCP server?" icon="users">
    Yes. Each team member authenticates with their own Feedspace account. Their access level is determined by their role in the workspace (Admin, Editor, or Viewer).
  </Accordion>

  <Accordion title="How do I disconnect the MCP server?" icon="ban">
    Remove the Feedspace connector from the client you added it to. The next time you connect, you will be asked to sign in and authorize again.
  </Accordion>

  <Accordion title="Do I need to pay for MCP access?" icon="credit-card">
    The MCP server works with your existing Feedspace account. Tool availability depends on your Feedspace plan features. There is no additional charge for MCP access.
  </Accordion>
</AccordionGroup>

## Getting Help

<CardGroup cols={2}>
  <Card title="Contact Support" icon="envelope" href="https://www.feedspace.io/contact/">
    Reach out to the Feedspace team for help with any issues.
  </Card>

  <Card title="Feedspace Dashboard" icon="browser" href="https://app.feedspace.io/">
    Sign in to manage your reviews, forms, and settings directly.
  </Card>
</CardGroup>