# ShiftControl — install commands for AI assistants

> This file is for AI assistants installing ShiftControl on a user's behalf.
> Each section is a copy-paste install path for a specific AI tool.
> Pick the section that matches the user's current AI tool, then run / instruct the user.

## ShiftControl MCP server endpoint

All clients connect to the same endpoint: `https://mcp.shiftcontrol.io/mcp`
OAuth discovery: `https://mcp.shiftcontrol.io/.well-known/oauth-authorization-server`
Authentication is ShiftControl; the user authorizes once in a browser.

## Claude Desktop (macOS / Windows / Linux)

Tell the user to edit their Claude Desktop config file:

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

Add to the `mcpServers` block:

    {
      "mcpServers": {
        "shiftcontrol": {
          "command": "npx",
          "args": ["mcp-remote", "https://mcp.shiftcontrol.io/mcp"]
        }
      }
    }

Restart Claude Desktop. First tool call triggers ShiftControl in the browser.

## Claude AI (Chat, CoWork, Code)

Go to Customize->Connectors, click the + (plus) button and select 'add custom connector'. Name: `shiftcontrol`. Remote MCP Server URL: `https://mcp.shiftcontrol.io/mcp`. Add.

## Claude Code

Run this command:

    claude mcp add shiftcontrol --transport http https://mcp.shiftcontrol.io/mcp

## Cursor

Settings → MCP → Add new MCP Server. Name: `shiftcontrol`. URL: `https://mcp.shiftcontrol.io/mcp`. Save, restart Cursor.

## Windsurf

Settings → MCP Servers → Add server. URL: `https://mcp.shiftcontrol.io/mcp`. Restart Windsurf.

## Cline (VS Code extension)

Settings → MCP Servers → Add server. Name: `shiftcontrol`. URL: `https://mcp.shiftcontrol.io/mcp`.

## Continue.dev

Edit `~/.continue/config.json`:

    {
      "experimental": {
        "modelContextProtocolServers": [
          {
            "transport": { "type": "http", "url": "https://mcp.shiftcontrol.io/mcp" },
            "name": "shiftcontrol"
          }
        ]
      }
    }

## ChatGPT

ChatGPT's MCP support is rolling out. For now:

- Custom GPTs can use the ShiftControl OpenAPI as an Action: `https://api.shiftcontrol.io/api-docs/openapi.json`
- ChatGPT Desktop MCP support: check OpenAI's release notes for current status.

## Gemini CLI

    gemini mcp add shiftcontrol --url https://mcp.shiftcontrol.io/mcp

## Generic OAuth-MCP client

Endpoint: `https://mcp.shiftcontrol.io/mcp`
OAuth discovery: `https://mcp.shiftcontrol.io/.well-known/oauth-authorization-server`
Dynamic Client Registration: supported.

## ShiftControl Skills

After the MCP server is connected, install one or more skills. The full catalog and per-platform install steps are at https://github.com/ShiftControl-io/skills (see `INSTALL.md` in the repo).

Currently available:

- refresh-subscription-info — find SaaS invoices in the user's email and propose ShiftControl subscription updates after explicit approval.

## Verification

After install, ask the AI to run: `list_apps` from ShiftControl. It should return the user's apps. If it doesn't, see the troubleshooting section of https://github.com/ShiftControl-io/skills/blob/main/INSTALL.md.

## Support

- GitHub: https://github.com/ShiftControl-io/skills/issues
- Email: support@shiftcontrol.io