Back to Docs

MCP Setup

Connect Simple Product to your AI coding assistant using the Model Context Protocol (MCP). Access boards, docs, customers, and feedback without leaving your editor.

Quick Install

Run this command to automatically install the MCP server in your supported tools:

npx @simple-product/mcp --install

This will detect and configure Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code automatically.

Supported Tools

Claude Code

Anthropic's CLI coding assistant

Claude Desktop

Claude's desktop application

Cursor

AI-powered code editor

Windsurf

Codeium's AI IDE

VS Code

With MCP extension

Manual Setup

Claude Code

Run this command to add Simple Product to Claude Code:

claude mcp add simple-product -- npx @simple-product/mcp@latest

For global installation (all projects), add -s user flag.

Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "simple-product": { "command": "npx", "args": ["@simple-product/mcp@latest"] } } }

Cursor

Add to ~/.cursor/mcp.json:

{ "mcpServers": { "simple-product": { "command": "npx", "args": ["@simple-product/mcp@latest"] } } }

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{ "mcpServers": { "simple-product": { "command": "npx", "args": ["@simple-product/mcp@latest"] } } }

Authentication

After installation, the MCP server will guide you through authentication:

  1. The server displays a device code
  2. Visit the provided URL and enter the code
  3. Sign in to your Simple Product account
  4. The server automatically connects to your workspace

Your credentials are stored securely and persist across sessions.

Available Tools

Once connected, your AI assistant can use these tools:

list_boardsList all boards in your workspace
get_boardGet board details including stages and cards
create_cardCreate a new card on a board
move_cardMove a card to a different stage
search_cardsSearch for cards by title or description
search_docsSearch for documents
get_docGet a document's full content
create_docCreate a new document
search_peopleSearch for customers
search_feedbackSearch feedback entries
create_feedbackCreate a feedback entry
list_releasesList changelog releases
create_releaseCreate a new release

Example Usage

With the MCP connected, you can ask your AI assistant things like:

  • "What cards are in the backlog?"
  • "Create a card for implementing dark mode"
  • "Search for feedback about the login page"
  • "Show me recent customer requests"
  • "Create a release note for the new export feature"
  • "Move the authentication bug to In Progress"

Troubleshooting

MCP not showing in tool list

Restart your editor after configuration. The MCP server must be running for tools to appear.

Authentication expired

Run npx @simple-product/mcp --install again to re-authenticate.

Wrong workspace

Use the switch_workspace tool or re-authenticate to select a different workspace.