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.
Complete access to all Superthread features and tools through a unified endpoint. Ideal for general-purpose integrations needing full workspace capabilities.
https://api.superthread.com/mcp/app
Dedicated access to Superthread boards functionality, allowing AI assistants to view, manage, and interact with your visual collaboration spaces.
https://api.superthread.com/mcp/boards
Specialized endpoint for working with Superthread cards, enabling AI assistants to read, create, and organize content cards within your boards.
https://api.superthread.com/mcp/cards
Focused access to Superthread Notes functionality, providing AI assistants with capabilities to retrieve and manage your knowledge base content.
https://api.superthread.com/mcp/notes
Targeted endpoint for Superthread pages, allowing AI assistants to work with your document pages and their content structure.
https://api.superthread.com/mcp/pages
Core access to Superthread workspace management, enabling AI assistants to navigate and interact with your organizational spaces and projects.
https://api.superthread.com/mcp/spaces
Bearer
token in the
Authorization
header with MCP requests
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.
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.
{
"mcpServers": {
"superthread": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://api.superthread.com/mcp/<server>",
"--header",
"Authorization:${ST_PAT}"
],
"env": {
"ST_PAT": "Bearer stp-XXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXX"
}
}
}
}
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 projectsclaude mcp add \
--transport http \
--scope local \
"superthread" \
"https://api.superthread.com/mcp/<server>" \
--env ST_PAT="stp-XXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXX" \
--header "Authorization: Bearer ${ST_PAT}"
To add Superthread MCP to Zed Editor:
Cmd+Shift+P
or Ctrl+Shift+P
)Open Settings
" and select itsettings.json
filecontext_servers
" section as shown in the example{
"context_servers": {
"superthread": {
"source": "custom",
"enabled": true,
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://api.superthread.com/mcp/<server>",
"--header",
"Authorization: Bearer ${ST_PAT}"
],
"env": {
"ST_PAT": "stp-XXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXX"
}
}
}
}
Cursor offers native support for MCP.
You can add a Superthread MCP server in two ways:
New MCP Server
or Add Custom MCP
View MCP Settings
, then click the New MCP Server
or Add Custom MCP
buttonThis opens the ~/.cursor/mcp.json
file where you need to add your Superthread MCP server configuration under the mcpServers
object.
{
"mcpServers": {
"superthread": {
"type": "http",
"url": "https://api.superthread.com/mcp/<server>",
"headers": {
"Authorization": "Bearer stp-XXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXX"
}
}
}
}
Add Superthread MCP to VS Code using one of these methods:
.vscode/mcp.json
file in your workspaceMCP: Add Server
command from the Command PaletteVS Code provides multiple options for adding and configuring MCP servers, either for specific workspaces or for all your projects.
{
"servers": {
"superthread": {
"type": "http",
"url": "https://api.superthread.com/mcp/<server>",
"headers": {
"Authorization": "Bearer stp-XXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXX"
}
}
}
}
Encountering issues with your MCP connection? Here are solutions to common problems: