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

license - not found

quality - not tested

How are these scores calculated?

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.

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

Related MCP Servers

mcp-server-code-assist
abhishekbhakat
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.
Last updated -
12
1
Python
MIT License
Shortcut.com MCP Server
WynnD
-
security
F
license
-
quality
An implementation of a Model Context Protocol server that allows Claude and other AI assistants to interact with Shortcut.com's ticket management system for searching, viewing, creating, and updating stories.
Last updated -
Python
Project Portfolio Guide MCP Server
wonnyboi
-
security
F
license
-
quality
A Model Context Protocol server that helps collect and structure project portfolio information through a guided conversation flow.
Last updated -
TypeScript
QuickBase MCP Server
LawrenceCirillo
A
security
A
license
A
quality
A Model Context Protocol server that provides comprehensive control over QuickBase operations, allowing users to manage applications, tables, fields, records, and relationships through MCP tools.
Last updated -
26
1
TypeScript
MIT License

View all related MCP servers

Shortcut MCP Server