Documentation

Supastate Documentation

Complete guide to integrating Supastate's MCP tools with Claude Code for persistent memory and enhanced development capabilities.

Quick Start

Get up and running with Supastate in 5 minutes

MCP Tools

Explore all available MCP tools and their parameters

API Reference

Direct API access and authentication details

Getting Started with Supastate

Set up Supastate MCP server to give Claude Code persistent memory and enhanced capabilities

Supastate provides two ways to enhance Claude Code:

Via Camille CLI

Full-featured integration with automatic code analysis and syncing. See the Camille documentation for setup instructions.

Direct MCP Server

Connect Claude Code directly to Supastate's MCP server for cloud-based memory and search. Continue below for setup.

Step 1: Create Your Supastate Account

  1. 1.Visit supastate.ai and click "Get Started with GitHub"
  2. 2.Authenticate with your GitHub account
  3. 3.Choose to create a personal workspace or join a team

Step 2: Choose Your Authentication Method

Supastate supports two authentication methods:

OAuth (Recommended)

No API key needed! The MCP server will guide you through GitHub OAuth authentication on first use. Your authentication is securely stored.

API Key (Optional)

For programmatic access or CI/CD, you can generate API keys from the dashboard.

Quick Start: Skip this step if using OAuth - just proceed to Step 3 and the MCP server will handle authentication automatically.

Step 3: Configure Claude Code

Option A: OAuth Authentication (Recommended)

Use OAuth to securely connect without managing API keys:

  1. 1.Add the Supastate server to your Claude Desktop configuration
  2. 2.The MCP server will prompt you to authenticate with GitHub
  3. 3.Your authentication is securely stored for future sessions
{
  "mcpServers": {
    "supastate": {
      "command": "npx",
      "args": ["-y", "supastate-mcp-server"]
    }
  }
}

No API key needed - the server will guide you through OAuth authentication on first use.

Option B: API Key Authentication

Alternatively, use an API key for programmatic access:

  1. 1.Generate an API key from your dashboard (see Step 2 above)
  2. 2.Add the key to your Claude Desktop configuration
{
  "mcpServers": {
    "supastate": {
      "command": "npx",
      "args": ["-y", "supastate-mcp-server"],
      "env": {
        "SUPASTATE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Configuration File Locations

The Claude Desktop configuration file is located at:

  • • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • • Linux: ~/.config/claude/claude_desktop_config.json

Option B: Via NPM Package (Alternative)

You can also install the Supastate MCP server globally:

# Install globally
npm install -g supastate-mcp-server

# Then add to Claude Desktop config:
{
  "mcpServers": {
    "supastate": {
      "command": "supastate-mcp-server",
      "env": {
        "SUPASTATE_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Step 4: Verify Setup

Once configured, restart Claude Code and verify the MCP tools are available:

  1. 1.Start a new Claude Code session
  2. 2.Ask Claude: "What MCP tools do you have available?"
  3. 3.You should see Supastate tools like search, searchCode, etc.

Success! Claude Code now has persistent memory and will never forget your code, decisions, and conversations.

Need more help? Visit our GitHub repository or check out Camille for full-featured integration