AI 에이전트는 조직 전반에서 진행되는 실제 업무에 직접 작용할 수 있을 때 가장 유용합니다. 프로젝트와 운영을 진행하려면 프로젝트 일정 업데이트, 작업 재할당, 현황 파악과 같은 복잡하고 부서 간 협업이 필요한 업무를 수행해야 합니다. AI 에이전트는 누구나 도구를 전환하지 않고도 이러한 업무를 지원할 수 있습니다. Smartsheet 정식 출시(generally available)된 Model Context Protocol(MCP) 서버를 출시했습니다.
함께 Smartsheet MCP 서버, AI 어시스턴트가 표준화된 프로토콜을 통해 Smartsheet 데이터를 읽고, 쓰고, 관리할 수 있습니다. 이 프로토콜은 시트, 행, 열 및 자동화를 탐색, 생성, 관리하는 40개 이상의 도구를 포괄합니다. 자연어를 통해 직접 작업 상태를 업데이트하고, 행을 생성하며, 프로젝트 구조를 수정할 수 있습니다.
이 게시물에서는 이를 기존 워크플로에 연결하는 두 가지 방법을 살펴봅니다. Amazon Quick 비즈니스 사용자, 프로젝트 관리자, 운영팀을 위해 설계된 에이전틱 AI 작업 공간입니다. 사용자는 코드를 작성하지 않고도 자연어를 통해 질문하고, 시트를 업데이트하고, 대시보드를 만들 수 있습니다. Kiro 개발자가 코딩 워크플로를 벗어나지 않고도 MCP를 통해 Smartsheet에 연결하여 프로젝트 사양을 참조하고, 작업 상태를 업데이트하고, 종속성을 추적할 수 있는 에이전틱(agentic) IDE입니다.
아키텍처 개요
다음 다이어그램은 Smartsheet MCP Server가 AWS 서비스에 연결되는 중앙 통합 계층으로 자리 잡는 방식을 보여줍니다. Amazon Quick과 Kiro는 MCP 클라이언트로서 직접 연결됩니다.
Amazon Quick은 자연어를 통해 Smartsheet를 쿼리, 업데이트 및 자동화하려는 지식 근로자, 프로젝트 관리자, 운영 팀을 위해 서비스를 제공합니다. Kiro를 사용하면 개발자가 코딩 워크플로를 벗어나지 않고도 프로젝트 사양을 참조하고, 작업 상태를 업데이트하고, 종속성을 추적할 수 있습니다.
다음 아키텍처 다이어그램은 이러한 통합 경로를 보여줍니다. 가운데에 Smartsheet MCP Server가 있고, 왼쪽에는 MCP 클라이언트인 Amazon Quick와 Kiro가, 오른쪽에는 Smartsheet의 API 및 데이터 레이어가 배치되어 있습니다.
그림 1: Amazon Quick와 Kiro의 MCP 클라이언트 연결이 서버를 통해 Smartsheet API 계층으로 이어지는 것을 보여주는 Smartsheet MCP Server 아키텍처
Amazon Quick과 Kiro를 활용한 스프린트 관리
스마트시트(Smartsheet)에서 스프린트를 관리하는 소프트웨어 엔지니어링 팀을 생각해 보세요. 작업, 담당자, 상태, 장애 요소가 모두 프로젝트 시트에 기록되어 있습니다. 동일한 팀에게 각 경로가 어떤 모습인지 살펴보겠습니다:
프로젝트 매니저와 같은 사용자가 이번 주 어떤 스프린트 작업이 차단되었는지 확인하고 싶을 때, Amazon Quick에게 자연어로 질문할 수 있습니다. Amazon Quick 챗 에이전트는 Smartsheet MCP Server를 쿼리하여 관련 행을 가져오고 담당자 이름과 마감일이 포함된 요약을 제공합니다. 응답은 보고서나 대시보드를 만들지 않고도 실시간 Smartsheet 데이터를 기반으로 생성됩니다.
버그를 수정하거나 기능을 작업 중인 개발자는 Kiro에게 현재 스프린트 시트를 가져와 자신에게 할당된 미해결 백엔드 작업을 보여달라고 요청할 수 있습니다. Kiro는 MCP를 통해 Smartsheet에 쿼리하고 목록을 인라인으로 표시합니다. 수정 사항이 커밋되면 Kiro 훅이 자동으로 해당 행의 상태를 Complete로 업데이트합니다.
필수 조건
Smartsheet MCP 서버는 행 관계, 열 유형, 셀 기록, 댓글을 포함하여 정확하게 구조화된 컨텍스트를 제공합니다. 이를 통해 원시 API 페이로드를 반환하는 대신 토큰 효율적인 페이로드 크기가 생성됩니다. 이러한 엔지니어링 결정은 프로젝트 포트폴리오 전반에서 수백 개의 AI 지원 쿼리를 실행할 때 비용 절감과 대규모 지연 시간 개선으로 이어집니다. Smartsheet가 AWS에서 원격 MCP 서버를 구축한 방법을 알아보려면 다음을 참조하세요. Smartsheet이 AWS에서 원격 MCP 서버를 구축한 방법.
Smartsheet MCP Server를 Amazon Quick 및 Kiro에 연결하기 전에, 다음 사항이 준비되어 있는지 확인하십시오:
- 연결하려는 서비스(Amazon Quick 또는 Kiro)에 적절한 AWS Identity and Access Management (IAM) 권한이 있는 활성 AWS 계정
- Business, Enterprise 또는 AWM 플랜의 Smartsheet 계정.
- Smartsheet 개인 액세스 토큰, 또는 클라이언트가 OAuth 흐름을 지원하는 경우 OAuth 자격 증명이 필요합니다.
- Amazon Quick의 경우: Amazon Quick 계정에서 작성자(Author) 이상의 권한이 필요합니다.
- Kiro의 경우: 다음에서 설치한 Kiro IDE kiro.dev 함께
Node.js사용자의 환경에서 사용 가능합니다.
Smartsheet MCP Server는 세 개의 지역 엔드포인트에서 사용할 수 있습니다. Streamable HTTP 전송(MCP spec 버전 2025-06-18 및 2025-03-26)을 사용하며 OAuth 2.0 또는 Personal Access Token으로 인증됩니다.
- 상업용 미국: https://mcp.smartsheet.com.
- EU: https://mcp.smartsheet.eu.
- AU: https://mcp.smartsheet.au.
두 옵션 모두 동일한 Smartsheet 도구 세트를 제공합니다. 올바른 선택은 업무가 이루어지는 환경에 따라 달라집니다:
온 팀이 사용할 수 있고 앱 등록이 필요 없으며 사전 구축된 OAuth만 사용하고 기업 내 지식 근로자 전반으로 확장되는 완전 관리형 조직 전체 솔루션이 필요하다면 Amazon Quick를 선택하세요.
인프라 없이 설정 파일과 개인 액세스 토큰만으로 자신의 워크플로우에 맞춘 가벼운 솔루션을 원하는 개발자라면 Kiro를 선택하세요.
Amazon Quick 통합
Amazon Quick는 디렉터리에 사전 구축된 커넥터로 Smartsheet를 포함하고 있습니다. 이는 프로젝트 상태 읽기, 행 업데이트, 토론 생성, 위험 도출 등을 비즈니스 사용자가 이미 작업 중인 동일한 인터페이스에서 모두 수행할 수 있음을 의미합니다.
Amazon Quick은 프로젝트 관리자와 운영팀부터 Smartsheet에서 업무를 관리하는 비즈니스 사용자에 이르기까지 조직 전반에서 이러한 통합을 사용할 수 있게 해줍니다.
빠른 통합(Quick integration)을 추가하려면:
- 다음은 Amazon Quick 콘솔, 다음으로 이동합니다 커넥터 디렉터리에서 Smartsheet를 찾습니다.
그림 2: Amazon Quick Connectors 디렉터리의 Smartsheet 커넥터
- 다음을 선택 Smartsheet 커넥터 타일.
- 다음 통합 세부 정보를 입력하세요:
- 이름 – Smartsheet 통합의 설명이 포함된 이름입니다.
- 다음을 유지하세요 연결 유형 그리고 인증 구성 설정을 그대로 유지합니다.
- 기본 URL – https://mcp.smartsheet.com.
- 클라이언트 ID – Smartsheet Developer Tools 앱 등록에서 발급받은 앱 클라이언트 ID.
- 클라이언트 시크릿(Client Secret) – Smartsheet 개발자 도구(Developer Tools) 앱 등록에서 발급받은 App secret.
- 토큰 URL – https://api.smartsheet.com/2.0/token.
- 인증 URL – https://app.smartsheet.com/b/authorize.
Figure 3: Amazon Quick에서 Smartsheet 연결 세부 정보 입력하기
- 선택 다음.
- 그 위에 도구 및 권한 관리 페이지에서 사용 가능한 도구 목록이 표시됩니다. 선택하세요 다음.
그림 4: Smartsheet 커넥터의 도구 및 권한 관리 페이지
- 그날 아침 게시 페이지에서 이 연결에 액세스할 수 있는 사용자를 선택한 다음 선택합니다 게시.
그림 5: Publish 페이지에서 Smartsheet 연결에 접근할 수 있는 사용자 선택하기
- 선택 다음.
연결이 완료되면 Amazon Quick 채팅 에이전트가 자연어를 통해 Smartsheet 데이터를 사용할 수 있습니다:
- “우리 포트폴리오에서 현재 At Risk 상태인 프로젝트는 무엇인가요?”
- “Backend API 시트에서 인증 작업의 상태를 Complete로 업데이트해 줘.”
- “Q3 Roadmap에서 기한이 지난 모든 항목의 요약을 만들어 팀에 보내 주세요.”
그림 6: Smartsheet 프로젝트 시트에서 기한이 지난 작업을 요약하며 주요 관찰 내용과 권장 조치를 제시하는 Amazon Quick 채팅 응답
Kiro 통합
Kiro 개발자가 컨텍스트 전환 없이 코드와 함께 개발 환경에서 직접 Smartsheet 프로젝트 컨텍스트를 사용할 수 있게 하려는 경우에 적합한 방법입니다.
Kiro는 사양(spec) 기반 개발을 중심으로 구축되었습니다. Kiro는 상위 수준의 프롬프트를 구조화된 사양으로 변환한 다음, 이를 작동하는 코드, 문서, 테스트로 변환합니다. MCP 서버는 문서, 데이터베이스, API 및 엔터프라이즈 시스템에 연결함으로써 학습 시점의 지식이 아닌 실시간 데이터에 기반하도록 에이전트를 만들어, Kiro가 실제 환경의 맥락을 얻는 방식입니다.
powers라 불리는 Kiro 기능은 큐레이션된 MCP 서버를 스티어링 파일 및 훅과 함께 패키징한 원클릭 설치형 번들입니다. 이는 Kiro 코딩 에이전트에 즉시 사용 가능한 새로운 기능을 제공합니다. Smartsheet의 경우 연결 설정은 단일 JSON 구성 블록만으로 완료되며, 그 시점부터 Kiro 에이전트는 개발 워크플로의 일부로 실시간 프로젝트 데이터를 참조할 수 있습니다.
Smartsheet MCP 서버를 Kiro에 연결하려면 Kiro MCP 구성에 이를 추가하세요(.kiro/settings/mcp.json (워크스페이스 범위인 경우). 전체 절차에 대한 설명은 다음을 참조하세요 Kiro 및 MCP 서버 시작하기:
{
"mcpServers": {
"smartsheet-us": {
"type": "http",
"url": "https://mcp.smartsheet.com",
"headers": {
"Authorization": "Bearer <SMARTSHEET_API_TOKEN>"
}
}
}
}이 구성은 개인 액세스 토큰(Personal Access Token, API 키) 방식을 사용합니다. 프로덕션 배포에는 OAuth가 권장됩니다.
설정 SMARTSHEET_API_TOKEN 환경의 Smartsheet Personal Access Token에 연결하세요. Kiro는 시작 시 MCP 서버를 백그라운드 프로세스로 로드합니다. 초기화가 완료되면 Smartsheet 도구를 채팅, 스펙 계획, 훅 기반 자동화 등 모든 모드에서 Kiro 에이전트가 사용할 수 있습니다. 자세한 내용은 다음을 참조하세요. Smartsheet MCP 서버 문서.
이후 Kiro는 개발 워크플로의 일부로 Smartsheet 데이터를 참조할 수 있습니다.
- “백엔드 API 프로젝트 시트에서 열려 있는 버그를 확인하고 우선순위가 매겨진 수정 목록을 생성해 줘.”
그림 7: Kiro가 Backend API 프로젝트 시트의 미해결 버그를 기반으로 우선순위가 지정된 수정 목록을 생성하는 모습
- “Q3 로드맵 시트를 불러와서 In Progress로 표시된 기능들의 명세를 작성해 줘.”
그림 8: Q3 Roadmap 시트의 진행 중인 기능들을 기반으로 Kiro가 spec을 생성하는 모습
엔터프라이즈 거버넌스
규제 대상 또는 엔터프라이즈 환경에 배포하는 개발자를 위해 Smartsheet MCP Server의 보안 모델은 Smartsheet REST API와 동일한 인프라 및 권한 계층 위에 구축되었습니다. 이는 새로운 신뢰 경계가 아닙니다:
- OAuth 2.0 및 개인 액세스 토큰 인증: MCP 클라이언트가 지원하는 인증 방식을 선택하세요.
- 사용자 수준 권한 적용: 에이전트는 인증된 사용자가 볼 권한이 있는 데이터에만 접근할 수 있습니다. 자연어 프롬프트를 통한 권한 상승은 불가능합니다.
- 조직 수준 AI 통제: 시스템 관리자는 AI 기능을 전역적으로 켜거나 끌 수 있습니다. 쓰기 도구 접근 권한은 사용자 그룹별로 구성할 수 있습니다.
- Streamable HTTP 전송: 방화벽 허용 목록은 IP 주소가 아닌 정규화된 도메인 이름(FQDN)(mcp.smartsheet.com) 기준으로 수행됩니다.
컴플라이언스 아키텍트 입장에서 보면, MCP Server는 프롬프트를 저장하지 않으며 프롬프트 내용은 AI 클라이언트와 모델 사이에만 머무릅니다. Smartsheet는 구조화된 도구 호출과 그 결과만 확인합니다.
정리
이 안내를 따라 진행한 후 통합을 제거하고 싶다면, 각 경로를 되돌리는 방법은 다음과 같습니다:
Amazon Quick
- Amazon Quick 콘솔에서 다음으로 이동합니다: 커넥터.
- Smartsheet 커넥터를 선택합니다.
- 선택 삭제 연결을 제거하면 OAuth 토큰이 취소되고 Smartsheet 데이터에 대한 에이전트 접근이 중단됩니다.
Kiro
- MCP 구성 파일을 여십시오(
.kiro/settings/mcp.json). - 제거하십시오
smartsheet-us다음의 항목mcpServers객체입니다. - 서버를 언로드하려면 Kiro를 재시작하십시오.
다음 단계
서버 작동 방식에 대한 배경 설명은 Smartsheet가 AWS에서 원격 MCP 서버를 구축한 방법을 참조하십시오. Smartsheet MCP Server를 원하는 시스템에 연결한 후에는 다음 네 가지 작업을 시도해 보시기를 권장합니다:
챗 에이전트에게 활성 프로젝트 시트를 모니터링하도록 요청하여 Blocked 또는 At Risk로 표시된 행을 식별할 수 있습니다. 토론 댓글로 프로젝트에 주석을 달고, 선호하는 채널을 통해 팀에 구조화된 요약을 전달하도록 요청할 수도 있습니다. 이는 다음을 연결하는 워크플로의 예입니다: get_sheet_summary, search및 create_discussion_on_row.
에이전트는 Smartsheet MCP Server를 통해 데이터를 검색하여 이슈 트래커와 Smartsheet 프로젝트 계획 간의 작업 상태를 일치시킬 수도 있습니다. 두 항목 간의 불일치를 표시하고 영향을 받는 행을 업데이트할 수 있으며, 이때 다음을 사용합니다: get_sheet_summary, get_columns, update_rows및 create_discussion_on_row 을 순서대로 사용합니다.
또한 보고서와 대시보드 전반에서 프로젝트 상태 신호를 집계해 볼 수도 있습니다. 다음을 활용하여 수동 데이터 수집 없이 구조화된 브리핑을 생성하는 데 사용할 수 있습니다: list_reports, get_report, list_dashboards, get_dashboard및 search.
마지막으로, 에이전트를 사용하여 모든 쓰기 작업 후에 무엇이 변경되었고 왜 변경되었는지 설명하는 토론 댓글을 남기도록 할 수 있습니다. 이는 다음의 조합을 통해 Smartsheet 내에 사람이 읽을 수 있는 감사 추적을 생성합니다. update_rows 및 create_discussion_on_row.
네 가지 패턴 모두 앞서 설명한 경로 전반에서 작동합니다. 비즈니스 사용자 대상 워크플로를 위한 Amazon Quick, 개발자 시작 작업을 위한 Kiro.
Smartsheet MCP와 AWS로 무언가를 만들고 계신가요? 댓글에서 진행 중인 작업을 공유하거나 Smartsheet 개발자 커뮤니티.