Los agentes de IA son más útiles cuando pueden actuar sobre el trabajo real que ocurre en toda su organización. La ejecución de proyectos y operaciones implica tareas complejas y multifuncionales, como actualizar cronogramas de proyectos, reasignar tareas y mostrar el estado. Los agentes de IA pueden ayudarle con esto sin que nadie tenga que cambiar de herramienta. Smartsheet ha lanzado un servidor Model Context Protocol (MCP) con disponibilidad general.
Con el Smartsheet MCP Server, los asistentes de IA pueden leer, escribir y gestionar datos de Smartsheet a través de un protocolo estandarizado. El protocolo abarca más de 40 herramientas para explorar, crear y gestionar hojas, filas, columnas y automatizaciones. Puede actualizar el estado de las tareas, crear filas y modificar la estructura del proyecto directamente mediante lenguaje natural.
En esta publicación, recorremos dos formas de conectarlo a sus flujos de trabajo existentes. Amazon Quick es un espacio de trabajo de IA agéntica diseñado para usuarios de negocio, gerentes de proyecto y equipos de operaciones. Pueden hacer preguntas, actualizar hojas y crear paneles mediante lenguaje natural sin escribir código. Kiro es un IDE agéntico donde los desarrolladores se conectan a Smartsheet a través de MCP para consultar especificaciones de proyecto, actualizar el estado de las tareas y realizar un seguimiento de las dependencias sin salir de su flujo de trabajo de programación.
Descripción general de la arquitectura
El siguiente diagrama muestra cómo el Smartsheet MCP Server se ubica como la capa central de integración que se conecta a los servicios de AWS. Amazon Quick y Kiro se conectan directamente como clientes MCP.
Amazon Quick atiende a trabajadores del conocimiento, gerentes de proyecto y equipos de operaciones que desean consultar, actualizar y automatizar Smartsheet mediante lenguaje natural. Con Kiro, los desarrolladores pueden consultar especificaciones de proyecto, actualizar el estado de las tareas y realizar un seguimiento de las dependencias sin salir de su flujo de trabajo de programación.
El siguiente diagrama de arquitectura ilustra estas rutas de integración: el Smartsheet MCP Server en el centro, con Amazon Quick y Kiro como clientes MCP a la izquierda, y la capa de API y datos de Smartsheet a la derecha.
Figura 1: Arquitectura del Smartsheet MCP Server que muestra las conexiones de clientes MCP desde Amazon Quick y Kiro a través del servidor hasta la capa de API de Smartsheet
Gestión de sprints con Amazon Quick y Kiro
Considere un equipo de ingeniería de software que realiza el seguimiento de su sprint en Smartsheet. Las tareas, los responsables, los estados y los impedimentos residen en una hoja de proyecto. Así se ve cada ruta para el mismo equipo:
Cuando un usuario, como un gerente de proyecto, quiere verificar qué tareas del sprint están bloqueadas esta semana, puede preguntar a Amazon Quick mediante lenguaje natural. El agente de chat de Amazon Quick consulta el Smartsheet MCP Server, extrae las filas relevantes y presenta un resumen con los nombres de los responsables y las fechas de vencimiento. La respuesta se genera a partir de datos en vivo de Smartsheet sin necesidad de crear un informe o panel.
Para los desarrolladores que están corrigiendo errores o trabajando en funcionalidades, pueden pedirle a Kiro que extraiga la hoja del sprint actual y les muestre las tareas de backend abiertas asignadas a ellos. Kiro consulta Smartsheet a través de MCP y muestra la lista en línea. Cuando se confirma la corrección, un hook de Kiro actualiza automáticamente el estado de la fila correspondiente a Complete.
Requisitos previos
El Smartsheet MCP Server entrega contexto estructurado con precisión, incluyendo relaciones de filas, tipos de columnas, historial de celdas y comentarios. Esto produce tamaños de carga eficientes en tokens en lugar de devolver cargas de API sin procesar. Esta decisión de ingeniería se traduce en costos reducidos y una latencia mejorada a escala cuando se ejecutan cientos de consultas asistidas por IA en una cartera de proyectos. Para aprender cómo Smartsheet construyó su servidor MCP remoto en AWS, consulte How Smartsheet built a remote MCP server on AWS.
Antes de conectar el Smartsheet MCP Server a Amazon Quick y Kiro, verifique que cuenta con lo siguiente:
- Una cuenta de AWS activa con los permisos adecuados de AWS Identity and Access Management (IAM) para el servicio que está conectando (Amazon Quick, o Kiro)
- Una cuenta de Smartsheet en un plan Business, Enterprise o AWM.
- Un Smartsheet Personal Access Token, o credenciales de OAuth si su cliente admite el flujo de OAuth.
- Para Amazon Quick: permisos de Author o superiores en su cuenta de Amazon Quick.
- Para Kiro: Kiro IDE instalado desde kiro.dev con
Node.jsdisponible en tu entorno.
El Smartsheet MCP Server está disponible en tres endpoints regionales. Utiliza el transporte Streamable HTTP (versiones de la especificación MCP 2025-06-18 y 2025-03-26) y se autentica con OAuth 2.0 o con un Personal Access Token.
- Comercial EE. UU.: https://mcp.smartsheet.com.
- UE: https://mcp.smartsheet.eu.
- AU: https://mcp.smartsheet.au.
Ambas opciones exponen el mismo conjunto de herramientas de Smartsheet. La elección correcta depende de dónde se realiza tu trabajo:
Elige Amazon Quick si necesitas una solución totalmente gestionada y para toda la organización que todo tu equipo pueda usar: sin registro de aplicación, solo OAuth preconstruido, y se escala entre los trabajadores del conocimiento de tu empresa.
Elige Kiro si eres un desarrollador que quiere algo ligero: sin infraestructura, solo un archivo de configuración y un token de acceso personal, acotado a tu propio flujo de trabajo.
Integración con Amazon Quick
Amazon Quick incluye Smartsheet como un conector preconstruido en su directorio. Eso significa leer el estado de los proyectos, actualizar filas, crear discusiones y revelar riesgos, todo en la misma interfaz en la que ya trabajan sus usuarios de negocio.
Amazon Quick pone esa integración a disposición de toda la organización, desde los gestores de proyectos y equipos de operaciones hasta los usuarios de negocio que gestionan el trabajo en Smartsheet.
Para añadir la integración de Quick:
- En la consola de Amazon Quick, navegue a Connectors y encuentre Smartsheet en el directorio.
Figura 2: El conector de Smartsheet en el directorio de Connectors de Amazon Quick
- Seleccione el mosaico del conector de Smartsheet .
- Introduzca los siguientes detalles de integración:
- Name – Nombre descriptivo para su integración de Smartsheet.
- Mantenga la Connection type y la Auth configuration tal como están.
- Base URL – https://mcp.smartsheet.com.
- Client ID – ID de cliente de la aplicación del registro de su aplicación en Smartsheet Developer Tools.
- Client Secret – Secreto de la aplicación del registro de su aplicación en Smartsheet Developer Tools.
- Token URL – https://api.smartsheet.com/2.0/token.
- Auth URL – https://app.smartsheet.com/b/authorize.
Figura 3: Introducción de los detalles de conexión de Smartsheet en Amazon Quick
- Elija Siguiente.
- En la Manage Tools & Permissions página, verá una lista de las herramientas disponibles. Elija Siguiente.
Figura 4: La página Manage Tools and Permissions del conector de Smartsheet
- En la Publish página, elija quién puede acceder a esta conexión y luego elija Publish.
Figura 5: Elección de quién puede acceder a la conexión de Smartsheet en la página Publish
- Elija Siguiente.
Después de conectarse, su agente de chat de Amazon Quick puede trabajar con los datos de Smartsheet mediante lenguaje natural:
- “¿Qué proyectos de nuestro portafolio están actualmente At Risk?”
- “Actualice el estado de la tarea de autenticación en la hoja Backend API a Complete.”
- “Cree un resumen de todos los elementos vencidos en el Q3 Roadmap y envíelo al equipo.”
Figura 6: Respuesta del chat de Amazon Quick que resume las tareas vencidas de una hoja de proyecto de Smartsheet con observaciones clave y acciones recomendadas
Integración con Kiro
Kiro es el camino adecuado cuando los desarrolladores quieren tener el contexto del proyecto de Smartsheet disponible directamente en su entorno de desarrollo, junto con su código, sin cambiar de contexto.
Kiro se basa en el desarrollo guiado por especificaciones (spec-driven development). Convierte prompts de alto nivel en especificaciones estructuradas y luego en código, documentación y pruebas funcionales. Los servidores MCP son la forma en que Kiro obtiene contexto del mundo real al conectarse a documentación, bases de datos, API y sistemas empresariales para fundamentar su agente en datos en vivo en lugar de conocimiento de su entrenamiento.
Una función de Kiro llamada powers es un paquete instalable con un clic que incluye un servidor MCP seleccionado junto con archivos de steering y hooks. Proporciona al agente de código de Kiro una nueva capacidad lista para usar. Para Smartsheet, configurar la conexión requiere un único bloque de configuración JSON y, a partir de ese momento, el agente de Kiro puede hacer referencia a datos del proyecto en vivo como parte de un flujo de trabajo de desarrollo.
Para conectar el Smartsheet MCP Server a Kiro, agréguelo a su configuración MCP de Kiro (.kiro/settings/mcp.json para el ámbito de workspace). Para obtener una guía completa, consulte Getting Started with Kiro and MCP Servers:
{
"mcpServers": {
"smartsheet-us": {
"type": "http",
"url": "https://mcp.smartsheet.com",
"headers": {
"Authorization": "Bearer <SMARTSHEET_API_TOKEN>"
}
}
}
}Esta configuración utiliza el enfoque de token de acceso personal (clave de API). Para implementaciones en producción, se recomienda OAuth.
Configúrelo SMARTSHEET_API_TOKEN con su token de acceso personal de Smartsheet en su entorno. Kiro carga los servidores MCP como procesos en segundo plano al iniciar. Una vez inicializado, las herramientas de Smartsheet están disponibles para el agente de Kiro en todos los modos: chat, planificación de especificaciones y automatización basada en hooks. Todos los detalles en la documentación del servidor MCP de Smartsheet.
A partir de ahí, Kiro puede hacer referencia a los datos de Smartsheet como parte de los flujos de trabajo de desarrollo:
- «Consulta la hoja del proyecto Backend API en busca de errores abiertos y genera una lista priorizada de correcciones.»
Figura 7: Kiro genera una lista priorizada de correcciones a partir de errores abiertos en la hoja del proyecto Backend API
- «Extrae la hoja del Roadmap del Q3 y crea una especificación para las funcionalidades marcadas como In Progress.»
Figura 8: Kiro crea una especificación a partir de las funcionalidades en curso en la hoja del Roadmap del Q3
Gobernanza empresarial
Para quienes desarrollan en entornos regulados o empresariales, el modelo de seguridad del servidor MCP de Smartsheet se basa en la misma capa de infraestructura y permisos que la API REST de Smartsheet. No es un nuevo límite de confianza:
- Autenticación OAuth 2.0 y token de acceso personal: elija el método de autenticación compatible con su cliente MCP.
- Aplicación de permisos a nivel de usuario: los agentes solo pueden acceder a los datos que el usuario autenticado tiene permiso para ver. Sin escalada de privilegios mediante prompts de lenguaje natural.
- Controles de IA a nivel de organización: los administradores del sistema pueden activar o desactivar las funciones de IA globalmente. El acceso a las herramientas de escritura es configurable por grupo de usuarios.
- Transporte Streamable HTTP: la lista de permitidos del firewall se realiza por nombre de dominio completo (FQDN) (mcp.smartsheet.com), no por dirección IP.
Para los arquitectos de cumplimiento, el servidor MCP no almacena los prompts, y el contenido de los prompts permanece entre el cliente de IA y el modelo. Smartsheet solo ve las llamadas estructuradas a herramientas y sus resultados.
Limpieza
Si siguió este tutorial y desea eliminar la integración después, así es como deshacer cada ruta:
Amazon Quick
- En la consola de Amazon Quick, navegue a Connectors.
- Seleccione su conector de Smartsheet.
- Elija Delete para eliminar la conexión. Esto revoca el token de OAuth y detiene el acceso del agente a los datos de Smartsheet.
Kiro
- Abra su archivo de configuración MCP (
.kiro/settings/mcp.json). - Elimine la entrada
smartsheet-usdelmcpServersobjeto. - Reinicie Kiro para descargar el servidor.
Próximos pasos
Para obtener información sobre cómo funciona el servidor, consulte Cómo Smartsheet construyó un servidor MCP remoto en AWS. Después de haber conectado el Smartsheet MCP Server a su sistema de preferencia, aquí hay cuatro acciones que le recomendamos probar:
Puede pedirle al agente de chat que monitoree sus hojas de proyecto activas e identifique las filas marcadas como Blocked o At Risk. También puede pedirle que anote los proyectos con un comentario de discusión y entregue un resumen estructurado a su equipo a través de su canal preferido. Este sería un ejemplo de flujo de trabajo que encadena get_sheet_summary, search, y create_discussion_on_row.
El agente también puede recuperar datos a través del Smartsheet MCP Server para conciliar los estados de las tareas entre su rastreador de incidencias y su plan de proyecto de Smartsheet. Puede señalar las discrepancias entre ambos y actualizar las filas afectadas, usando get_sheet_summary, get_columns, update_rows, y create_discussion_on_row en secuencia.
También puede intentar agregar señales de salud del proyecto en sus informes y paneles. Puede usarlo para producir un informe estructurado sin recopilación manual de datos, apoyándose en list_reports, get_report, list_dashboards, get_dashboard, y search.
Por último, puede usar el agente para seguir cada escritura con un comentario de discusión que explique qué cambió y por qué. Esto crea un rastro de auditoría legible por humanos dentro de Smartsheet mediante la combinación de update_rows y create_discussion_on_row.
Los cuatro patrones funcionan en las rutas anteriores: Amazon Quick para flujos de trabajo orientados a usuarios de negocio y Kiro para acciones iniciadas por desarrolladores.
¿Está construyendo algo con Smartsheet MCP y AWS? Comparta en lo que está trabajando en los comentarios, o conéctese con nosotros en la Smartsheet Developer Community.