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 Snapshot Server
crazyrabbitLTC
A
security
A
license
A
quality
A Model Context Protocol server that enables interaction with Snapshot.org, providing tools to query Snapshot spaces, proposals, and users through natural language.
Last updated -
5
2
TypeScript
MIT License
Workato MCP Server
jacobgoren-sb
-
security
A
license
-
quality
A Model Context Protocol server that provides seamless interaction with Workato's API through custom AI tools, enabling management of recipes, connections, connectors, folders, and activity logs.
Last updated -
TypeScript
MIT License
Loveable.dev MCP Server
iamseancorcoran
-
security
A
license
-
quality
A Model Context Protocol server that enables users to create, check status, and get details of projects on Loveable.dev, a platform for quickly creating applications.
Last updated -
JavaScript
ISC License
Foundry MCP Project
lhemerly
-
security
A
license
-
quality
A Model Context Protocol server that enables interaction with Foundry tools through natural language, allowing users to create projects, build contracts, run tests, and manage Ethereum development environments.
Last updated -
1
Python
MIT License

View all related MCP servers

Shortcut MCP Server