Kiro CLI

Overview

Connect Kiro CLI to Shortcut through the hosted Shortcut MCP Server. Kiro CLI can then use Shortcut context while planning, writing, and reviewing code from your terminal.

Installation

1. Open or create ~/.kiro/settings/mcp.json. For a project-only connection, use .kiro/settings/mcp.json in your workspace.
2. Add the Shortcut server:

{
  "mcpServers": {
    "shortcut": {
      "url": "https://mcp.shortcut.com/mcp"
    }
  }
}

3. Save the file. Kiro reloads MCP configuration automatically.
4. Follow the browser prompt to authorize Shortcut the first time Kiro connects.

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

Optional OAuth scopes

Most MCP clients select the appropriate OAuth scopes automatically. To manually limit the Shortcut permissions Kiro requests, add oauthScopes to the Shortcut server configuration:

{
  "mcpServers": {
    "shortcut": {
      "url": "https://mcp.shortcut.com/mcp",
      "oauthScopes": ["read", "write"]
    }
  }
}

For available scopes, see MCP Server.

Troubleshooting

Kiro CLI provides MCP commands for managing authentication:

• /mcp auth starts authentication again when a token is expired or invalid.
• /mcp cancel-auth cancels an authentication flow that is waiting for browser confirmation.
• /mcp logout removes stored credentials for a server.

For available entities and general troubleshooting, see MCP Server.