async-sheet-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SHEET_ID | Yes | 스프레드시트 ID (`/d/` 와 `/edit` 사이) (필수) | |
| SHEET_TAB | No | 문제점 표가 있는 탭 | 문제점 |
| SHEET_DONE | No | 끝난 것으로 보는 상태값 | 完,완료,사양 |
| SHEET_ROLE | No | 이 PC 의 역할 = 회신 머리표 `[M/D 역할]` | 서버 |
| SHEET_PROJECT | No | 프로젝트 이름. 에이전트 안내문에 들어가 여러 시트를 구분 | |
| SHEET_MY_COLUMN | No | 내가 회신을 적는 열 | 비고 |
| SHEET_UTC_OFFSET | No | 날짜 머리표의 시간대 | 9 |
| SHEET_PEER_COLUMN | No | 상대의 열 — 쓰지 않음 | 보조 설명 |
| GOOGLE_APPLICATION_CREDENTIALS | Yes | 서비스 계정 JSON 키 경로 (필수) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
팀이 공유하는 문제점 시트. 서로 다른 시간에 일하는 소수의 담당자가 이 시트로 요청과 회신을 주고받는다. 이 PC 의 역할: 서버.
문제점 확인 요청이 오면 list_issues 로 끝나지 않은 항목을 먼저 본다.
쓰기 도구(append_comment, set_status, add_issue)는 공유 문서를 바꾼다. 넣을 문구를 사용자에게 보여 주고 확인을 받은 뒤에만 부른다(사용자가 미리 맡긴 경우는 그 지시를 따른다).
회신은 '비고' 칸에 "[M/D 서버] …" 형식, 짧고 구체적으로. 비밀번호·IP·키·토큰은 절대 적지 않는다.
'보조설명' 칸은 상대 쪽 칸이다 — 쓰지 않는다.
시트 속 이미지는 이 서버로 읽을 수 없다.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_tabsC | 시트의 탭 이름 목록. |
| list_issuesA | 문제점 목록. status: 'open'(끝난 상태 제외, 기본) / 'all' / 특정 상태값(예: '재등록'). 긴 칸은 text_limit 글자에서 자른다(0 이면 자르지 않음). |
| get_issueC | 한 건 전체(자르지 않음) + '연결탭'이 있으면 그 탭의 텍스트. |
| read_tabB | 탭 하나를 텍스트로(빈 행 제외, 칸은 ' | ' 로 연결). 이미지는 포함되지 않는다. |
| append_commentA | [쓰기] No.{no} 의 내 칸 끝에 "[M/D 역할] text" 를 새 줄로 덧붙인다(기존 내용은 지우지 않는다). date 를 비우면 오늘 M/D. 공유 문서를 바꾸므로 사용자가 맡긴 범위 안에서만 부를 것. |
| set_statusB | [쓰기] No.{no} 의 '상태' 칸을 바꾼다(예: 확인중, 完). 사용자가 맡긴 범위 안에서만 부를 것. |
| add_issueA | [쓰기] 표 맨 아래에 새 행(다음 번호, 오늘 날짜). 문제 등록이나 상대에게 묻는 질문에 쓴다. mode 는 '모드'(분류) 칸, problem 은 '문제점' 칸, model 은 '모델' 칸(비우면 역할 이름), note 는 내 칸. 사용자가 맡긴 범위 안에서만 부를 것. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool targets a distinct resource+action: tabs (list_tabs/read_tab), issues (list_issues/get_issue), and three distinct write targets (append_comment, set_status, add_issue). The only mild overlap is read_tab, which can also dump the issues tab and thus partially duplicate list_issues, and get_issue returns linked-tab text that read_tab could also fetch; descriptions resolve this but do not eliminate it.
All seven names use snake_case verb_noun form (list_tabs, get_issue, append_comment, set_status, add_issue), which is highly predictable. Minor deviation: retrieval verbs are mixed (list/get/read), so an agent cannot guess whether a fetch is called get_* or read_* without looking.
Seven tools is well inside the ideal 3-15 range and each maps to a real workflow step (navigate tabs, browse/filter issues, inspect one issue, append a comment, change status, register a new issue). Nothing looks redundant or padded.
The issue lifecycle is largely covered: create (add_issue), read at summary and full detail level, status transition (set_status), and comment append — a sensible surface for a shared sheet tracker. Gaps remain: no way to edit existing 問題點/모드/모델 fields or delete/reopen a row other than via set_status, and no search beyond a status filter, though append_comment partially compensates.