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

# MCP Server

> Give Claude, Cursor, Windsurf, VS Code, and any MCP-compatible AI client direct access to your Sleekplan workspace via Streamable HTTP and OAuth 2.1

The Sleekplan MCP server exposes your entire workspace to any compatible AI client. Once connected, you can ask your AI assistant to find feedback, create changelog entries, tag items, look up users, run surveys, and more — all in natural language, without switching to the Sleekplan dashboard. The server is centrally hosted at `https://mcp.sleekplan.com/mcp` — nothing to install locally.

## Before you connect

* The MCP server uses **OAuth 2.1 with dynamic client registration**. On first connection, your AI client opens a browser window where you sign in to your Sleekplan account and select the workspace to authorize. Subsequent connections are authenticated automatically.
* The server supports **Streamable HTTP transport**. Clients that only support the older SSE transport can use `mcp-remote` as a bridge (see the [Others](#others) tab below).
* Each connection is scoped to a single workspace. To connect multiple workspaces, add a separate MCP server entry for each one.

***

## Setup

<Tabs>
  <Tab title="Claude Desktop">
    Open Claude settings, go to **Connectors**, and add Sleekplan. Alternatively, add the following to your `claude_desktop_config.json`:

    ```json theme={"system"}
    {
      "mcpServers": {
        "sleekplan": {
          "url": "https://mcp.sleekplan.com/mcp"
        }
      }
    }
    ```

    Restart Claude Desktop after saving the file. On the next launch, Claude will prompt you to authorize your Sleekplan account.
  </Tab>

  <Tab title="Claude Code">
    Run the following command in your terminal:

    ```bash theme={"system"}
    claude mcp add sleekplan --transport streamable-http https://mcp.sleekplan.com/mcp
    ```

    Then open a Claude Code session and run `/mcp` to complete the OAuth authorization flow.
  </Tab>

  <Tab title="Cursor">
    1. Open Cursor **Settings**.
    2. Navigate to **MCP tools**.
    3. Click **Add new server** and fill in the fields:

    | Field | Value                           |
    | ----- | ------------------------------- |
    | Name  | `Sleekplan`                     |
    | Type  | `Streamable HTTP`               |
    | URL   | `https://mcp.sleekplan.com/mcp` |

    Save the entry. Cursor will prompt you to authorize the connection on the next use.
  </Tab>

  <Tab title="VS Code">
    Press `Ctrl`/`Cmd` + `P`, type **MCP: Add Server**, select **HTTP**, and enter:

    ```
    https://mcp.sleekplan.com/mcp
    ```

    Alternatively, add the following to your VS Code MCP configuration file:

    ```json theme={"system"}
    {
      "mcpServers": {
        "sleekplan": {
          "url": "https://mcp.sleekplan.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windsurf">
    1. Press `Ctrl`/`Cmd` + `,` to open Windsurf settings.
    2. Scroll to **Cascade → MCP servers**.
    3. Click **Add Server → Add custom server** and enter:

    ```json theme={"system"}
    {
      "mcpServers": {
        "sleekplan": {
          "url": "https://mcp.sleekplan.com/mcp"
        }
      }
    }
    ```

    Save the configuration. Windsurf will prompt you to authenticate on the first use.
  </Tab>

  <Tab title="Others">
    Any MCP-compatible client can connect using the server URL directly:

    ```
    https://mcp.sleekplan.com/mcp
    ```

    If your client does not support Streamable HTTP transport, use `mcp-remote` as a compatibility bridge:

    ```bash theme={"system"}
    npx -y mcp-remote https://mcp.sleekplan.com/mcp
    ```

    <Note>
      `mcp-remote` requires Node.js to be installed. It acts as a local proxy that translates between your client's transport and the Sleekplan server.
    </Note>
  </Tab>
</Tabs>

***

## Available tools

All tools and their parameters are automatically discovered by your AI client — you do not need to configure them manually. Ask your assistant in natural language and it will select the appropriate tool.

| Resource      | Tools                                                                                                                                                                                            |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Feedback**  | `list_feedback`, `create_feedback`, `get_feedback`, `update_feedback`, `delete_feedback`, `get_feedback_stats`, `get_similar_feedback`, `merge_feedback`, `tag_feedback`                         |
| **Comments**  | `list_comments`, `create_comment`, `update_comment`, `delete_comment`                                                                                                                            |
| **Changelog** | `list_changelog`, `create_changelog`, `get_changelog`, `update_changelog`, `delete_changelog`                                                                                                    |
| **Surveys**   | `list_surveys`, `get_survey`, `create_survey`, `update_survey_name`, `update_survey_questions`, `get_survey_summary`, `get_survey_question_feed`, `list_survey_responses`, `get_survey_response` |
| **Votes**     | `list_votes`, `get_voters`                                                                                                                                                                       |
| **Users**     | `list_users`, `get_user`, `get_user_segment`                                                                                                                                                     |
| **Topics**    | `list_topics`, `list_sub_topics`                                                                                                                                                                 |
| **Tags**      | `list_tags`, `create_tag`, `delete_tag`                                                                                                                                                          |
| **Workspace** | `list_feedback_types`, `list_feedback_statuses`, `get_category_template`, `list_admins`, `list_segments`                                                                                         |

***

## FAQ

<AccordionGroup>
  <Accordion title="Which AI clients are supported?">
    Any MCP-compatible client works with the Sleekplan MCP server. This includes Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, and any other tool that supports the Model Context Protocol. Clients without native Streamable HTTP support can use `mcp-remote` as a bridge.
  </Accordion>

  <Accordion title="Can I connect multiple workspaces?">
    Each MCP connection is scoped to a single workspace, selected during the OAuth authorization flow. To connect more than one workspace, add a separate MCP server entry for each one in your client configuration, giving each a distinct name (for example, `sleekplan-acme` and `sleekplan-beta`).
  </Accordion>

  <Accordion title="What permissions does the MCP server have?">
    The MCP server uses your Sleekplan account permissions. You can perform the same actions through the MCP server as you can through the Sleekplan admin dashboard — no more, no less.
  </Accordion>

  <Accordion title="Is my data secure?">
    Yes. Authentication uses OAuth 2.1 with PKCE. Your Sleekplan credentials are never shared with the AI client — the client only receives an access token scoped to the workspace you authorized. All communication between your client, the MCP server, and Sleekplan happens over HTTPS.
  </Accordion>

  <Accordion title="I'm having trouble connecting. What should I try?">
    Clear your cached authentication tokens in the AI client and reconnect. This forces a fresh OAuth flow and resolves most connection issues. If the problem persists, contact [support@sleekplan.com](mailto:support@sleekplan.com).
  </Accordion>
</AccordionGroup>
