> ## 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.

# Setup & Installation

> How to connect the Feedspace MCP server to Claude Desktop, Cursor, VS Code, and other AI assistants.

<Info>
  **Prerequisites:**

  * A [Feedspace account](https://app.feedspace.io/signin) with at least one workspace
  * An MCP-compatible AI client (Claude Desktop, Cursor, VS Code, etc.)
</Info>

## Connecting to Claude Desktop

1. Open **Claude Desktop** and go to **Settings**
2. Navigate to the **MCP Servers** section (under Developer settings)
3. Add the Feedspace MCP server with the configuration below
4. Restart Claude Desktop
5. When you first use a Feedspace tool, a browser window will open for you to sign in to your Feedspace account

<CodeGroup>
  ```json claude_desktop_config.json theme={null}
  {
    "mcpServers": {
      "feedspace": {
        "url": "https://mcp.feedspace.io/mcp"
      }
    }
  }
  ```
</CodeGroup>

<Tip>
  On macOS, the config file is located at `~/Library/Application Support/Claude/claude_desktop_config.json`. On Windows, it's at `%APPDATA%\Claude\claude_desktop_config.json`.
</Tip>

## Connecting to Other Clients

For any MCP-compatible client, use the server URL below and select **Streamable HTTP** as the transport type. Authentication is handled automatically via OAuth 2.1.

```
https://mcp.feedspace.io/mcp
```

## How Authentication Works

The Feedspace MCP server uses **OAuth 2.1 with PKCE** for secure authentication:

1. When you first use a Feedspace tool, your MCP client opens a browser window
2. You sign in to your Feedspace account at `app.feedspace.io`
3. After authorization, a bearer token is issued and stored by your MCP client
4. All subsequent tool calls use this token automatically
5. The token persists across sessions in most clients

<Note>
  Your Feedspace credentials are never shared with the AI assistant. The bearer token is scoped to your account and transmitted over HTTPS. You can revoke access at any time from your Feedspace account settings.
</Note>

## Verify Your Connection

After setup, try asking your AI assistant:

> "List my Feedspace workspaces"

If the connection is working, you'll see a list of your workspaces with their names and IDs. This confirms that authentication and the MCP connection are functioning correctly.