Claude Code MCP Setup | SpecThis Docs

Prerequisites

Claude Code CLI installed (installation guide)
A SpecThis account — you must be logged in via your browser for OAuth authentication

Step 1: Add SpecThis MCP Server

Run the following command to add the SpecThis MCP server to Claude Code:

claude mcp add --transport http spec-this https://app.specthis.ai/api/mcp --scope user

Scope options: Use --scope user to make the server available across all projects, or --scope local for the current project only.

Step 2: Authenticate

When Claude Code first connects to the MCP server, your browser will open to the SpecThis login page. Sign in with your account to authorize the connection. This uses Clerk OAuth and only needs to happen once per session.

Step 3: Verify Connection

Check that the SpecThis MCP server was added successfully:

claude mcp list

You should see spec-this in the list. After adding, restart Claude Code and verify with the /mcp command.

You should see 16 tools available from the spec-this server, organized into plans, work items, changes, repositories, and plan structure groups.

Management Commands

claude mcp list

View all configured MCP servers

claude mcp get spec-this

View detailed configuration for SpecThis server

claude mcp remove spec-this

Remove the SpecThis MCP server

/mcp

Check MCP status within Claude Code

Official Documentation

For more details on Claude Code MCP configuration, see the Claude Code MCP Documentation.