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)

Related MCP server: Shortcut.com MCP Server

Configuración

1. Instalar Python con asdf:

asdf install

2. 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

3. Configura tu entorno:

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

4. 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 .