# Claude Code

Connect Claude Code to Shortcut through the hosted Shortcut MCP server.

## Overview

Connect Claude Code to Shortcut through the hosted [Shortcut MCP Server](/help/integrations/mcp-server). Claude Code can then find, create, and update Shortcut work from the terminal using your authorized Workspace access.

## Installation

1. Install and sign in to [Claude Code](https://code.claude.com/docs/en/overview).
2. Add Shortcut as a remote HTTP MCP server:

```bash
claude mcp add --transport http shortcut https://mcp.shortcut.com/mcp
```

3. Start Claude Code and follow the browser prompt to authorize Shortcut.
4. Run `claude mcp list` to confirm that the `shortcut` server is connected.

Authentication is handled with OAuth. You do not need to create or store a Shortcut API token.

## Use Shortcut from Claude Code

Ask Claude Code to work with Shortcut in natural language, for example:

* "Show me Story 12345 and summarize the acceptance criteria."
* "Find my started Stories in the current Iteration."
* "Add a comment to Story 12345 with this implementation update."

Claude Code will show tool calls before making changes that require approval.

For available entities and troubleshooting, see [MCP Server](/help/integrations/mcp-server).