Cómo conectar Shortcut a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Shortcut, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Shortcut + Cursor

Deja que tu IA trabaje en Shortcut: busca historias con los operadores de búsqueda de Shortcut, lee historias con tareas, comentarios e historial, épicas, iteraciones, objetivos, equipos, flujos de trabajo y etiquetas, y crea, modifica y comenta historias tras tu confirmación. Token de API personal.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

SHORTCUT_API_TOKEN

Paso 1 — Obtener credenciales

1. En Shortcut, haz clic en tu avatar y abre Settings → Your Account → API Tokens (https://app.shortcut.com/settings/account/api-tokens).
2. Escribe un nombre como AnythingMCP y haz clic en Generate Token. Shortcut muestra el token una sola vez.
3. Pégalo en SHORTCUT_API_TOKEN e instala el conector. Se envía en la cabecera Shortcut-Token y solo a Shortcut.
4. Comprueba la configuración con shortcut_get_current_member: muestra quién eres, tu nombre de mención y el workspace.

El token actúa como tú: en el workspace en el que se creó y con tus permisos. Las historias y los comentarios que escribe la IA aparecen a tu nombre. Si trabajas en varios workspaces de Shortcut, crea un token por cada uno.

Cambios solo tras tu sí: shortcut_create_story, shortcut_update_story y shortcut_add_story_comment modifican el workspace al instante y avisan a los seguidores. La IA te muestra antes la historia, los campos o el texto del comentario y espera un sí claro. shortcut_delete_story se instala desactivada: una historia borrada no se puede recuperar, y archivarla con shortcut_update_story es la opción más segura.

Busca como en Shortcut: shortcut_search_stories y shortcut_search_epics aceptan los operadores de búsqueda de Shortcut. Tú preguntas con tus palabras y la IA construye la consulta:

• owner:jane, requester:jane, team:"Mobile", epic:"Checkout redesign", iteration:"Sprint 12", label:"customer", state:"In Progress", type:bug, estimate:3.
• is:started, is:done, is:blocked, is:overdue, has:owner, has:deadline, has:comment.
• Fechas: created:2026-10-01..2026-10-15, updated:today, completed:yesterday, due:*..2026-10-31.
• Un signo de exclamación delante de un operador lo excluye, por ejemplo owner:jane is:started !is:archived type:bug.

Qué lee: historias con descripción, tareas, comentarios, enlaces y su historial completo de cambios (quién movió qué y cuándo), épicas con sus comentarios, iteraciones, objetivos, equipos, flujos de trabajo con sus estados, etiquetas, proyectos y miembros. Para mover una historia, la IA cambia su estado del flujo de trabajo, que consulta antes.

Paginación y límites: las búsquedas devuelven 25 resultados por defecto y hasta 250 por página. Solo se pueden recorrer los primeros 1000 resultados, así que la IA prefiere acotar la consulta. 200 peticiones por minuto por token.

Errores frecuentes: 401: el token es incorrecto o se eliminó; genera uno nuevo. 404: el id no existe en este workspace. 400 o 422: no se acepta un valor, por ejemplo un estado de otro flujo de trabajo; Shortcut lo indica en el mensaje.

No incluido: borrar épicas, iteraciones, etiquetas o comentarios, Docs, archivos y adjuntos, editar campos personalizados, plantillas de historias, webhooks, tareas y vínculos entre historias.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Shortcut.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué tengo entre manos ahora mismo? Lista mis historias empezadas que aún no están terminadas, con su épica e iteración."
• "¿Qué bugs se completaron en el Sprint 12 y cuáles siguen abiertos?"
• "Muéstrame el historial de la historia 4521: ¿quién la movió a Ready for Review y cuándo?"
• "Crea una historia de tipo bug 'El checkout falla con una tarjeta caducada' para el equipo Payments, estado Unstarted, responsable Jane. Enséñamela antes de crearla."
• "Comenta en la historia 4521 que la corrección está en staging y muévela a Ready for Review. Pregúntame antes."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT