remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides tools for interacting with Shortcut (formerly Clubhouse) to view and manage projects, stories, epics, and objectives, including capabilities for searching through stories and creating new items.

Acceso directo al servidor MCP

[!ADVERTENCIA] Este es un servidor WIP y podría no funcionar como se espera.

Un servidor de Protocolo de Contexto Modelo (MCP) para interactuar con Shortcut (anteriormente Clubhouse).

Características

Ver proyectos, historias, epopeyas y objetivos
Buscar entre historias
Crea nuevas historias, epopeyas y objetivos.
Solo operaciones seguras (sin actualizaciones ni eliminaciones)

Configuración

Instalar Python con asdf:

asdf install

Crear entorno virtual e instalar dependencias:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .  # Install package in editable mode

Configura tu entorno:

cp .env.example .env
# Edit .env and add your Shortcut API token

Ejecutar el servidor:

python -m shortcut_mcp

Estructura del proyecto

shortcut-mcp/
├── src/
│   └── shortcut_mcp/      # Main package directory
│       ├── __init__.py    # Package initialization
│       ├── __main__.py    # Entry point
│       └── server.py      # Server implementation
├── pyproject.toml         # Project configuration
├── .tool-versions         # ASDF version configuration
├── .pylintrc             # Pylint configuration
└── README.md

Uso con Claude Desktop

Agregue esto a su configuración de Claude Desktop:

En MacOS ( ~/Library/Application Support/Claude/claude_desktop_config.json ):

{
  "mcpServers": {
    "shortcut": {
      "command": "python",
      "args": ["-m", "shortcut_mcp"],
      "env": {
        "SHORTCUT_API_TOKEN": "your_token_here"
      }
    }
  }
}

En Windows ( %AppData%\Claude\claude_desktop_config.json ):

{
  "mcpServers": {
    "shortcut": {
      "command": "python",
      "args": ["-m", "shortcut_mcp"],
      "env": {
        "SHORTCUT_API_TOKEN": "your_token_here"
      }
    }
  }
}

Pruebas

Puede probar el servidor utilizando el Inspector MCP:

npx @modelcontextprotocol/inspector python -m shortcut_mcp

Características de seguridad

Este servidor implementa operaciones de solo lectura con capacidades de creación segura:

Sólo permite operaciones GET (lectura) y POST (creación)
No se permite modificación ni eliminación de datos existentes
Todas las operaciones se atribuyen al propietario del token API

Desarrollo

Gestión de versiones de Python

Este proyecto utiliza asdf para la gestión de versiones de Python. La versión de Python requerida se especifica en .tool-versions .

# Install Python with asdf
asdf install python

# The correct version will be automatically selected based on .tool-versions

Calidad del código

Usamos pylint para comprobar la calidad del código. Ejecútalo con:

pylint src/shortcut_mcp

La configuración de pylint está en .pylintrc .

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor de Protocolo de Contexto de Modelo que permite la interacción con la herramienta de gestión de proyectos Shortcut (anteriormente Clubhouse), permitiendo a los usuarios ver y buscar proyectos, historias, epopeyas y objetivos, así como crear nuevos elementos a través del lenguaje natural.

Related Resources

Reddit Discussion about this server

Shortcut MCP Server