Superthread MCP Server

Model Context Protocol (MCP) is a powerful standard that enables AI models to securely access external tools, services, and data. Superthread's MCP servers provide a seamless integration layer for AI assistants to interact with your workspaces, enhancing productivity and unlocking new capabilities for your AI workflow.

superthread

v0.0.3

Description

AI-powered workspace intelligence for Superthread content. Enables natural language queries about your workspace data with tools like 'ask' and 'search', allowing AI to analyze and answer questions using relevant information from your Superthread content.

Endpoint

https://api.superthread.com/mcp/app

Available Tools

ask

Authentication Method

Bearer Token Authentication

Include a Bearer token in the Authorization header with MCP requests
Tokens can be generated in your Superthread workspace's account settings

Manage Your Access Tokens

How to Connect

AI assistants can connect to MCP servers using the appropriate endpoints with your authentication token. Each MCP server provides specialized functionality that extends your AI's capabilities across your workspace.

Client Connection Examples

Claude Desktop

Configuration

Settings > Developer > Local MCP servers > Edit config

Add a config for the Superthread MCP server in the claude_desktop_config.json file.

Claude will automatically detect and utilize available tools when you ask questions related to your workspace.

Example

{
  "mcpServers": {
    "superthread": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.superthread.com/mcp/app",
        "--header",
        "Authorization:${ST_PAT}"
      ],
      "env": {
        "ST_PAT": "Bearer stp-XXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

Claude Code

Configuration

CLI command

To add the Superthread MCP server to Claude Code, run the claude mcp add command in your terminal. Replace the necessary parameters with your own.

Available scope options include:

--scope local (default): Available only to you in the current project
--scope project: Shared with everyone in the project via .mcp.json file
--scope user: Available to you across all projects

Example

claude mcp add \
  --transport http \
  --scope local \
  "superthread" \
  "https://api.superthread.com/mcp/app" \
  --env ST_PAT="stp-XXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXX" \
  --header "Authorization: Bearer ${ST_PAT}"

Zed Editor

Configuration

~/.config/zed/settings.json

To add Superthread MCP to Zed Editor:

Open the Command Palette (Cmd+Shift+P or Ctrl+Shift+P)
Search for "Open Settings" and select it
This will open the settings.json file
Add your Superthread MCP configuration under the "context_servers" section as shown in the example

Example

{
  "context_servers": {
    "superthread": {
      "source": "custom",
      "enabled": true,
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.superthread.com/mcp/app",
        "--header",
        "Authorization: Bearer ${ST_PAT}"
      ],
      "env": {
        "ST_PAT": "stp-XXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

Cursor

Configuration

~/.cursor/mcp.json

Cursor offers native support for MCP.

You can add a Superthread MCP server in two ways:

Go to Settings > Cursor Settings > Tools & Integrations and click New MCP Server or Add Custom MCP
Alternatively, open the Command Palette and search for View MCP Settings, then click the New MCP Server or Add Custom MCP button

This opens the ~/.cursor/mcp.json file where you need to add your Superthread MCP server configuration under the mcpServers object.

Example

{
  "mcpServers": {
    "superthread": {
      "type": "http",
      "url": "https://api.superthread.com/mcp/app",
      "headers": {
        "Authorization": "Bearer stp-XXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

VSCode

Configuration

.vscode/mcp.json

Add Superthread MCP to VS Code using one of these methods:

Create a .vscode/mcp.json file in your workspace
Run the MCP: Add Server command from the Command Palette

VS Code provides multiple options for adding and configuring MCP servers, either for specific workspaces or for all your projects.

Example

{
  "servers": {
    "superthread": {
      "type": "http",
      "url": "https://api.superthread.com/mcp/app",
      "headers": {
        "Authorization": "Bearer stp-XXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

Important: All MCP servers require authentication with a Personal Access Token (PAT). Requests without valid authentication will receive a 401 Unauthorized response. Tokens should be kept secure and never shared publicly.

Troubleshooting

Encountering issues with your MCP connection? Here are solutions to common problems:

Common Issues

Authentication Errors (401): Verify your token is valid and correctly formatted in the Authorization header.
Connection Timeouts: Check your network connection and ensure the MCP server URL is correct.
Permission Errors (403): Your token may not have sufficient permissions for the requested resource.
Rate Limiting: If receiving 429 errors, reduce your request frequency or contact support to increase limits.

Connection Checklist

Verify your MCP server URL is correct
Ensure your authentication token is valid and not expired
Check that you're using the correct request format and parameters
Confirm your network allows the connection (no firewall blocks)