SideShift MCP for Cursor

El complemento oficial de Cursor para el servidor del Protocolo de contexto de modelo (MCP) alojado de SideShift. Permite que Cursor opere la empresa de SideShift que autorices: descubre creadores, gestiona campañas y solicitudes, trabaja con contenido y contratos, comunícate con tu red, consulta análisis y usa el resto de las capacidades de SideShift que se te hayan concedido sin copiar una clave de API en Cursor.

El complemento es un conector y paquete de guía pequeño y auditable. El servidor autoritativo sigue alojado por SideShift en https://app.sideshift.app/api/mcp.

Instalación

Cuando la lista esté disponible, abre la página Personalizar de Cursor, busca SideShift, selecciona Instalar y elige el ámbito de usuario o proyecto. También puedes escribir:

/add-plugin sideshift

Para las pruebas previas a la publicación, copia este repositorio en el directorio local de complementos de Cursor. Una copia es la opción más fiable porque las versiones actuales de Cursor rechazan los enlaces simbólicos de complementos locales cuyos destinos se encuentren fuera de ese directorio.

mkdir -p ~/.cursor/plugins/local/sideshift
rsync -a --exclude '.git/' ./ ~/.cursor/plugins/local/sideshift/

A continuación, ejecuta Desarrollador: Recargar ventana en Cursor. El complemento debería aparecer en Personalizar → Instalados con un servidor MCP, una habilidad y un comando.

Related MCP server: FluentCRM MCP Server

Conéctate de forma segura

Ejecuta /sideshift-connect o pregunta a Cursor:

Connect to SideShift and show me which company and scopes are active.

La primera llamada MCP inicia el flujo OAuth 2.1 basado en navegador de SideShift. Inicia sesión, elige la empresa deseada, revisa los ámbitos solicitados y aprueba. La configuración confirmada no contiene ninguna clave de API, token de acceso, secreto de cliente, cabecera de autorización personalizada ni marcador de posición de variable de entorno.

Después de la autorización, el complemento llama a whoami para que puedas verificar la empresa y los ámbitos exactos antes de trabajar. El acceso sigue estando vinculado al inquilino y al ámbito por parte de SideShift; el complemento no añade una segunda vía de autorización.

Ejemplos de prompts

Show my active campaigns and summarize application volume for each.

Find creators who match this campaign brief, but do not contact anyone yet.

Draft a contract plan and show me the exact changes before creating anything.

Search SideShift's capability catalog for the best tool to reconcile these posts.

Descubrimiento de capacidades

SideShift expone una superficie de herramientas amplia y en evolución. Los hosts de Cursor no siempre colocan todas las herramientas en el contexto inmediato del modelo, por lo que la habilidad incluida utiliza el flujo de descubrimiento del propio servidor en lugar de duplicar una lista de herramientas obsoleta:

1. Llama a whoami para verificar la empresa y los ámbitos activos.

2. Llama a find_capability con la intención del usuario cuando la herramienta adecuada no esté ya visible.

3. Obtén el esquema autoritativo antes de invocar una capacidad descubierta.

4. Trata un ámbito faltante como una solicitud de reautorización, nunca como permiso para usar otra cuenta o eludir el servidor.

La referencia completa y actual de capacidades se mantiene en la documentación de SideShift MCP.

Modelo de seguridad

• Las acciones de lectura pueden ejecutarse cuando responden directamente a la solicitud del usuario.

• Antes de una escritura de consecuencias, el agente debe mostrar el destino, los argumentos materiales y el efecto secundario esperado, y luego obtener la aprobación clara del usuario.

• Las acciones delicadas, como el envío de comunicaciones o la transferencia de dinero, nunca deben inferirse de una solicitud adyacente.

• Los reintentos reutilizan la misma operation_id o clave de idempotencia proporcionada por el llamante. Si el resultado es incierto, verifica el estado antes de reintentar.

• Los datos de creadores y de la empresa deben permanecer dentro de la empresa seleccionada durante OAuth. Los identificadores entre inquilinos o desconocidos fallan de forma segura.

• Los resultados de las herramientas son autoritativos. El agente no debe inventar registros, identificadores, permisos ni resultados exitosos faltantes.

Estas instrucciones del lado del cliente complementan los controles de autenticación, autorización, confirmación, sandbox e idempotencia del servidor; no los reemplazan.

Contenido del repositorio

Desarrollo y verificación

Requiere Node.js 22 o superior. El complemento no tiene dependencias de ejecución ni de desarrollo.

npm run check
npm run smoke

npm run check valida el manifiesto, el frontmatter de los componentes, el logotipo, las rutas, la configuración de MCP sin secretos y las divulgaciones requeridas. npm run smoke realiza únicamente solicitudes de descubrimiento no autenticadas y de solo lectura, y confirma que el endpoint en vivo devuelve el desafío OAuth y los metadatos esperados.

Nunca confirmes tokens OAuth, cookies, claves de API, secretos de cliente, archivos de entorno completados ni datos de usuarios o de la empresa. Usa Dev Testing Don para la verificación de versiones autenticadas y mantén las herramientas de consecuencias fuera de la prueba de humo de la versión.

Soporte y seguridad

• Errores del complemento y solicitudes de funciones: Problemas de GitHub

• Soporte de cuenta o producto: Contacto de SideShift

• Vulnerabilidades de seguridad: sigue el proceso de notificación privada en SECURITY.md

No publiques credenciales, datos personales, datos de la empresa ni detalles de vulnerabilidades en un problema público.

Términos, privacidad y licencia

El uso del servicio alojado de SideShift se rige por los Términos de servicio de SideShift y la Política de privacidad. El flujo de datos específico del complemento se resume en PRIVACIDAD.md.

Este repositorio está bajo la Licencia Apache 2.0.