Contexto de gestão de trabalho para agentes de IA com Smartsheet MCP na AWS

Agentes de IA com contexto real de gestão de trabalho

Agentes de IA são mais úteis quando conseguem atuar sobre o trabalho real que acontece dentro de uma organização. Gestão de trabalho envolve tarefas complexas e multifuncionais — atualizar cronogramas de projetos, reatribuir tarefas, levantar status — e agentes de IA podem ajudar nisso sem que ninguém precise trocar de ferramenta.

A Smartsheet, plataforma de gestão de trabalho para projetos, portfólios e operações, lançou em disponibilidade geral o seu servidor de Protocolo de Contexto de Modelo (MCP). Com o Smartsheet MCP Server, assistentes de IA podem ler, escrever e gerenciar dados do Smartsheet por meio de um protocolo padronizado. O protocolo abrange mais de 40 ferramentas para explorar, criar e gerenciar planilhas, linhas, colunas e automações. É possível atualizar status de tarefas, criar linhas e modificar a estrutura de projetos diretamente por linguagem natural.

O artigo original do blog da AWS apresenta duas formas de conectar esse servidor aos fluxos de trabalho existentes:

• Amazon Quick — um workspace de IA agêntica voltado para usuários de negócio, gerentes de projeto e equipes de operações. Eles podem fazer perguntas, atualizar planilhas e construir dashboards por linguagem natural, sem escrever código.
• Kiro — uma IDE agêntica onde desenvolvedores se conectam ao Smartsheet via MCP para consultar especificações de projetos, atualizar status de tarefas e acompanhar dependências sem sair do ambiente de codificação.

Visão geral da arquitetura

O Smartsheet MCP Server funciona como a camada central de integração que conecta os serviços da AWS. O Amazon Quick e o Kiro se conectam diretamente como clientes MCP. O Amazon Quick atende trabalhadores do conhecimento, gerentes de projeto e equipes de operações que querem consultar, atualizar e automatizar o Smartsheet por linguagem natural. Já o Kiro permite que desenvolvedores referenciem especificações de projetos, atualizem status de tarefas e rastreiem dependências sem sair do fluxo de codificação.

A arquitetura descrita no artigo original mostra o Smartsheet MCP Server no centro, com o Amazon Quick e o Kiro como clientes MCP de um lado, e a API e camada de dados do Smartsheet do outro.

Gestão de sprints com Amazon Quick e Kiro

Para ilustrar, considere uma equipe de engenharia de software que acompanha sua sprint no Smartsheet. Tarefas, responsáveis, status e bloqueios ficam todos em uma planilha de projeto. Veja como cada caminho funciona para a mesma equipe:

Cenário com Amazon Quick: quando um gerente de projeto quer verificar quais tarefas da sprint estão bloqueadas naquela semana, basta perguntar ao Amazon Quick em linguagem natural. O agente de chat do Amazon Quick consulta o Smartsheet MCP Server, busca as linhas relevantes e apresenta um resumo com nomes dos responsáveis e datas de entrega. A resposta é gerada a partir de dados ao vivo do Smartsheet, sem precisar construir relatórios ou dashboards.

Cenário com Kiro: para desenvolvedores que estão corrigindo bugs ou trabalhando em funcionalidades, é possível pedir ao Kiro para buscar a planilha da sprint atual e mostrar as tarefas de backend abertas atribuídas a eles. O Kiro consulta o Smartsheet via MCP e exibe a lista inline. Quando a correção é commitada, um hook do Kiro atualiza automaticamente o status da linha correspondente para “Complete”.

Pré-requisitos

O Smartsheet MCP Server entrega contexto precisamente estruturado, incluindo relacionamentos entre linhas, tipos de colunas, histórico de células e comentários. Isso produz payloads eficientes em tokens, em vez de retornar payloads brutos da API. Essa decisão de engenharia se acumula em redução de custo e melhoria de latência em escala, quando se executam centenas de consultas assistidas por IA em um portfólio de projetos.

Para entender como a Smartsheet construiu seu servidor MCP remoto na AWS, vale conferir o artigo How Smartsheet built a remote MCP server on AWS.

Antes de conectar o Smartsheet MCP Server ao Amazon Quick ou ao Kiro, é necessário ter:

• Uma conta AWS ativa com permissões apropriadas de Gerenciamento de Identidade e Acesso (IAM) para o serviço que será conectado (Amazon Quick ou Kiro).
• Uma conta Smartsheet nos planos Business, Enterprise ou AWM.
• Um Token de Acesso Pessoal do Smartsheet, ou credenciais OAuth se o cliente suportar o fluxo OAuth.
• Para Amazon Quick: permissões de Author ou superiores na conta do Amazon Quick.
• Para Kiro: a IDE Kiro instalada a partir de kiro.dev com Node.js disponível no ambiente.

O Smartsheet MCP Server está disponível em três endpoints regionais. Ele utiliza transporte Streamable HTTP (versões da especificação MCP 2025-06-18 e 2025-03-26) e é autenticado com OAuth 2.0 ou Token de Acesso Pessoal:

• EUA Comercial: https://mcp.smartsheet.com
• EU: https://mcp.smartsheet.eu
• AU: https://mcp.smartsheet.au

Ambas as opções expõem o mesmo conjunto de ferramentas do Smartsheet. A escolha certa depende de onde o trabalho é realizado:

• Amazon Quick — se a necessidade é uma solução totalmente gerenciada e de alcance organizacional que toda a equipe possa usar: sem registro de aplicativo, com OAuth pré-configurado, e que escala para trabalhadores do conhecimento na empresa.
• Kiro — se o usuário é um desenvolvedor que quer algo leve: sem infraestrutura, apenas um arquivo de configuração e um token de acesso pessoal, com escopo limitado ao próprio fluxo de trabalho.

Integração com Amazon Quick

O Amazon Quick inclui o Smartsheet como conector pré-construído em seu diretório. Isso significa que ler status de projetos, atualizar linhas, criar discussões e identificar riscos acontece na mesma interface que os usuários de negócio já utilizam. O Amazon Quick disponibiliza essa integração para toda a organização — de gerentes de projeto e equipes de operações a usuários de negócio que gerenciam trabalho no Smartsheet.

Para adicionar a integração, os passos são:

• No console do Amazon Quick, navegar até Connectors e encontrar o Smartsheet no diretório.
• Selecionar o tile do conector Smartsheet.
• Inserir os detalhes da integração:
  • Name — nome descritivo para a integração com o Smartsheet.
  • Manter as configurações de Connection type e Auth como estão.
  • Base URL — https://mcp.smartsheet.com
  • Client ID — ID do cliente do app registrado nas Smartsheet Developer Tools.
  • Client Secret — segredo do app registrado nas Smartsheet Developer Tools.
  • Token URL — https://api.smartsheet.com/2.0/token
  • Auth URL — https://app.smartsheet.com/b/authorize
• Clicar em Next. Na página Manage Tools & Permissions, visualizar a lista de ferramentas disponíveis e clicar em Next.
• Na página Publish, escolher quem pode acessar a conexão e clicar em Publish.

Após a conexão, o agente de chat do Amazon Quick pode trabalhar com dados do Smartsheet por linguagem natural. Exemplos de prompts mencionados no artigo original:

• “What projects in our portfolio are currently At Risk?”
• “Update the status of the authentication task in the Backend API sheet to Complete.”
• “Create a summary of all overdue items across the Q3 Roadmap and send it to the team.”

Integração com Kiro

O Kiro é o caminho indicado quando desenvolvedores querem ter o contexto de projetos do Smartsheet disponível diretamente no ambiente de desenvolvimento, ao lado do código, sem troca de contexto.

O Kiro é construído em torno de desenvolvimento orientado a especificações. Ele transforma prompts de alto nível em especificações estruturadas e, a partir delas, gera código, documentação e testes. Servidores MCP são a forma como o Kiro obtém contexto do mundo real — conectando-se a documentação, bancos de dados, APIs e sistemas corporativos para fundamentar seu agente em dados ao vivo, em vez de conhecimento do tempo de treinamento.

Uma funcionalidade do Kiro chamada powers é um pacote instalável com um clique que empacota um servidor MCP curado com arquivos de direcionamento e hooks. Isso dá ao agente de codificação do Kiro uma nova capacidade pronta para uso. Para o Smartsheet, configurar a conexão requer apenas um bloco de configuração JSON — a partir daí, o agente do Kiro pode referenciar dados de projetos ao vivo como parte do fluxo de desenvolvimento.

Para conectar o Smartsheet MCP Server ao Kiro, basta adicioná-lo à configuração MCP do Kiro (.kiro/settings/mcp.json para escopo de workspace). Para um passo a passo completo, consultar Getting Started with Kiro and MCP Servers:

{
  "mcpServers": {
    "smartsheet-us": {
      "type": "http",
      "url": "https://mcp.smartsheet.com",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

Essa configuração utiliza a abordagem de Token de Acesso Pessoal (chave de API). Para implantações em produção, OAuth é recomendado. A variável SMARTSHEET_API_TOKEN deve ser definida com o Token de Acesso Pessoal do Smartsheet no ambiente.

O Kiro carrega servidores MCP como processos em segundo plano na inicialização. Após a inicialização, as ferramentas do Smartsheet ficam disponíveis para o agente do Kiro em todos os modos: chat, planejamento de especificações e automação baseada em hooks. Detalhes completos estão na documentação do Smartsheet MCP Server.

A partir daí, o Kiro pode referenciar dados do Smartsheet como parte dos fluxos de desenvolvimento. Exemplos de prompts mencionados no artigo:

• “Check the Backend API project sheet for any open bugs and generate a prioritized fix list.”
• “Pull the Q3 Roadmap sheet and create a spec for the features marked In Progress.”

Governança corporativa

Para equipes que trabalham em ambientes regulados ou corporativos, o modelo de segurança do Smartsheet MCP Server é construído sobre a mesma infraestrutura e camada de permissões da API REST do Smartsheet. Não se trata de uma nova fronteira de confiança:

• Autenticação OAuth 2.0 e Token de Acesso Pessoal: o método de autenticação é escolhido conforme o suporte do cliente MCP.
• Aplicação de permissões no nível do usuário: agentes só podem acessar dados que o usuário autenticado tem permissão para visualizar. Não há escalação de privilégios por meio de prompts em linguagem natural.
• Controles de IA no nível organizacional: administradores de sistema podem ativar ou desativar funcionalidades de IA globalmente. O acesso a ferramentas de escrita é configurável por grupo de usuários.
• Transporte Streamable HTTP: a liberação em firewall é feita por Nome de Domínio Totalmente Qualificado (FQDN) (mcp.smartsheet.com), não por endereço IP.

Para arquitetos de conformidade, é importante saber que o MCP Server não armazena prompts, e o conteúdo dos prompts permanece entre o cliente de IA e o modelo. O Smartsheet recebe apenas as chamadas de ferramentas estruturadas e seus resultados.

Limpeza de recursos

Para quem seguiu o passo a passo e deseja remover a integração depois:

Amazon Quick:

• No console do Amazon Quick, navegar até Connectors.
• Selecionar o conector Smartsheet.
• Escolher Delete para remover a conexão. Isso revoga o token OAuth e interrompe o acesso do agente aos dados do Smartsheet.

Kiro:

• Abrir o arquivo de configuração MCP (.kiro/settings/mcp.json).
• Remover a entrada smartsheet-us do objeto mcpServers.
• Reiniciar o Kiro para descarregar o servidor.

Próximos passos

Para entender os bastidores de como o servidor funciona, vale consultar How Smartsheet built a remote MCP server on AWS.

Após conectar o Smartsheet MCP Server ao sistema de escolha, o artigo original sugere quatro ações para experimentar:

• Monitorar planilhas de projetos ativos: pedir ao agente de chat para identificar linhas marcadas como Blocked ou At Risk, anotar projetos com comentários de discussão e entregar um resumo estruturado para a equipe. Esse fluxo encadeia get_sheet_summary, search e create_discussion_on_row.
• Reconciliar status de tarefas: o agente pode buscar dados via Smartsheet MCP Server para reconciliar status de tarefas entre o rastreador de issues e o plano de projeto no Smartsheet. Ele pode sinalizar divergências e atualizar as linhas afetadas, usando get_sheet_summary, get_columns, update_rows e create_discussion_on_row em sequência.
• Agregar sinais de saúde do projeto: usar relatórios e dashboards para produzir um briefing estruturado sem coleta manual de dados, utilizando list_reports, get_report, list_dashboards, get_dashboard e search.
• Criar trilha de auditoria: usar o agente para acompanhar cada escrita com um comentário de discussão explicando o que mudou e por quê. Isso cria uma trilha de auditoria legível dentro do Smartsheet, combinando update_rows e create_discussion_on_row.

Todos os quatro padrões funcionam nos dois caminhos apresentados: Amazon Quick para fluxos de trabalho voltados a usuários de negócio e Kiro para ações iniciadas por desenvolvedores.

Para quem estiver construindo algo com Smartsheet MCP e AWS, a Smartsheet Developer Community é um bom ponto de partida para compartilhar experiências e trocar ideias.

Fonte

Work management context for AI agents with Smartsheet MCP on AWS (https://aws.amazon.com/blogs/machine-learning/work-management-context-for-ai-agents-with-smartsheet-mcp-on-aws/)