Cómo conectar Smartsheet a Cursor vía MCP

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

Smartsheet + Cursor

Smartsheet API 2.0 con un token de acceso personal (US, EU, AU o Gov): busca y lee hojas, filas, columnas, resúmenes de hoja e historial de celdas, comentarios y adjuntos, espacios de trabajo, carpetas, informes y paneles, usuarios y uso compartido; añade y cambia filas y columnas, comenta, crea hojas, comparte y envía solicitudes de actualización. Borrar filas viene desactivado al instalar.

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:

SMARTSHEET_API_URL, SMARTSHEET_ACCESS_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas un plan de Smartsheet con acceso a la API (Pro, Business, Enterprise o Advanced Work Management).

1. Inicia sesión en Smartsheet, haz clic en el icono de tu cuenta abajo a la izquierda y abre Apps & Integrations (o Personal Settings), luego API Access.
2. Haz clic en Generate new access token, ponle un nombre como AnythingMCP y copia el token. Solo se muestra una vez.
3. Pégalo en SMARTSHEET_ACCESS_TOKEN, sin la palabra Bearer.
4. Define SMARTSHEET_API_URL con el host de la región de tu cuenta: https://api.smartsheet.com/2.0 para app.smartsheet.com (US), https://api.smartsheet.eu/2.0 para app.smartsheet.eu, https://api.smartsheet.au/2.0 para app.smartsheet.au o https://api.smartsheetgov.com/2.0 para Smartsheet Gov. Un token solo funciona en el host de su propia región; en cualquier otro Smartsheet responde 401 "invalid access token".
5. Instala el conector y ejecuta smartsheet_get_current_user: muestra de quién es el token y lo confirma.

Con qué acceso: cada llamada se ejecuta como el usuario dueño del token, con su acceso a cada hoja, y el token puede hacer todo lo que ese usuario puede hacer en Smartsheet. Si importa, genera el token con un usuario dedicado que solo tenga acceso a las hojas que la IA deba ver.

Qué lee: una búsqueda en todo lo que el usuario puede abrir (nombres de hojas, informes, paneles, carpetas, espacios de trabajo y plantillas, datos de celdas, comentarios, adjuntos y campos de resumen), acotada con scopes como sheetNames; hojas con sus columnas (tipo, opciones de lista desplegable, columna principal) y filas, cada una con número de fila, fila padre para la jerarquía y celdas como value y displayValue; una sola fila; una búsqueda de texto dentro de una hoja; los campos del resumen de hoja; el historial de cambios de una celda con quién la cambió y cuándo; hilos de comentarios en hojas y filas; adjuntos, con un enlace de descarga válido unos 2 minutos; espacios de trabajo y carpetas con su contenido; informes con filas reunidas de varias hojas, celdas identificadas por virtualColumnId; paneles (llamados sights en la API) con sus widgets; los usuarios de la cuenta de la organización (los administradores del sistema ven a todos, los demás una vista limitada) y con quién está compartido un elemento.

Hojas grandes: la IA primero lista las columnas para obtener sus ids y tipos, y luego lee una página de filas o solo algunas filas con row_numbers, row_ids, column_ids o rows_modified_since.

Qué escribe: smartsheet_add_rows y smartsheet_update_rows (solo cambian las celdas indicadas; un campo de ubicación mueve una fila), smartsheet_add_columns y smartsheet_update_column (cambiar el tipo de una columna puede convertir o descartar valores), nuevos hilos de comentarios en hojas y filas y respuestas a ellos, hojas nuevas en un espacio de trabajo o carpeta con columnas propias o como copia de una plantilla u hoja, smartsheet_share_asset y smartsheet_create_update_request. Estas herramientas están activas al instalar. Compartir y las solicitudes de actualización con send_email envían correos, y los seguidores de una hoja pueden recibir avisos de comentarios nuevos, así que la IA te muestra primero destinatarios, nivel de acceso y contenido y espera tu sí.

Escribir celdas: una celda es {"columnId": <id>, "value": <value>}. DATE acepta YYYY-MM-DD, CHECKBOX true o false, PICKLIST una de sus opciones (otros valores se rechazan salvo que strict sea false), CONTACT_LIST una dirección de email, los números se envían como números. Una fórmula va en "formula": "=..." en lugar de value. Las filas nuevas necesitan una ubicación: toBottom, toTop, parentId o siblingId. Las columnas con fórmula de columna, las de sistema (numeración automática, fecha de creación, modificado por) y las bloqueadas no se pueden escribir.

Desactivada al instalar: smartsheet_delete_rows, porque las filas borradas, junto con sus filas hijas, adjuntos y comentarios, no se pueden recuperar a través de la API. Un admin la activa cuando el equipo la necesita.

Formatos de datos: hojas, filas, columnas, espacios de trabajo, carpetas, informes y usuarios tienen ids numéricos largos (hasta 16 dígitos), que la IA pasa como texto tal como llegan. Fechas y horas son ISO 8601 en UTC; las celdas de fecha son YYYY-MM-DD. Las celdas de varios contactos o de selección múltiple vuelven como texto, salvo que se pasen level (2 o 3) e include=objectValue. accessLevel es VIEWER, COMMENTER, EDITOR, EDITOR_SHARE, ADMIN u OWNER. Las llamadas de escritura responden {"message": "SUCCESS", "resultCode": 0, "result": ...}; resultCode 3 significa éxito parcial.

Paginación: hojas, columnas, conversaciones, adjuntos, usuarios e historial de celdas se paginan con page y page_size (100 por defecto; la respuesta trae totalPages y totalCount) o con include_all. Espacios de trabajo, contenido de espacios y carpetas, paneles y uso compartido se paginan con un token: la IA pasa lastKey de la respuesta como last_key hasta que falte.

Límites: 300 peticiones por minuto por token y 30 por minuto para el historial de celdas. Una respuesta 429 (código de error 4003) significa esperar un minuto. Una llamada masiva de filas cuenta como una petición; mantenla por debajo de unos cientos de filas.

Errores habituales: 401 (códigos 1002, 1003, 1004) significa un token no válido o caducado, o el host de otra región. 403 (1004) significa que el usuario del token no puede abrir ese elemento: compártelo con ese usuario o usa el token de un usuario con acceso. 404 (1006) significa que el id no existe o el usuario no lo ve. 400 llega con un errorCode y un message que nombra el problema, por ejemplo un valor que no está en la lista desplegable, una fila nueva sin ubicación o escribir en una columna con fórmula de columna.

El conector no sube archivos, no borra hojas ni columnas y no crea espacios de trabajo ni carpetas.

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

Herramientas disponibles

Ejemplos de prompts

• "Muestra todas las filas de la hoja Project Tracker con estado At Risk, con responsable y fecha de vencimiento."
• "Añade una fila al final de la hoja Calendario de Marketing: Webinar, 2026-11-20, responsable [email protected], estado Planificado."
• "¿Quién cambió la celda del presupuesto en la fila 14 de la hoja Presupuesto T4 y qué valores tenía antes?"
• "Encuentra todas las hojas, comentarios y adjuntos que mencionan Proyecto Apolo."
• "Lee el resumen de la hoja Relanzamiento web y dime el estado general y el porcentaje completado."

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
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot