Google Forms MCP

영어 | 러시아어

A1 Google Forms MCP를 사용하면 AI 앱이 자연어로 Google Forms 설문지를 만들고 관리할 수 있습니다. 설문조사를 만들고, 질문을 선택하고, 준비되면 게시하고, 응답을 읽고, 새 제출 알림을 사용할 수 있습니다.

Google 계정으로 Google Forms API를 사용합니다. 초안 양식과 게시된 양식을 구분하며, 모든 양식 작업이 가능한 것처럼 암시하지 않고 Forms API의 한계를 명확히 합니다.

• 13가지 도구. 양식 구조와 응답을 확인하고, 양식과 질문을 만들고 편집하며, 게시를 관리하고 Pub/Sub 감시를 구성할 수 있습니다.

• 의도적으로 게시. API로 만든 양식은 기본적으로 게시되지 않은 상태로 시작하므로, 게시하기 전까지 응답을 수집할 수 없습니다.

• 응답은 그대로 유지됩니다. API는 응답을 읽을 수 있지만 생성하거나 편집할 수 없으며, 서버에는 답변을 제출하는 도구가 없습니다.

• 최소한의 Google 범위. 광범위한 Drive 액세스 없이 forms.body와 forms.responses.readonly를 사용합니다.

읽기 전용 질문부터 시작해 보세요:

어제 고객 피드백 양식에 대한 응답을 보여 주고, 자유 텍스트 답변을 요약해 주세요.

서버 연결하기 · 사용 사례 살펴보기 · 기술 문서 열기

1분 만에 작동 확인하기

사용자: 고객 피드백 양식의 질문과 응답 설정을 보여 주세요.

어시스턴트: 양식, 항목, 게시 여부, 응답 수락 여부를 표시합니다. 변경되는 것은 없습니다.

사용자: 첫 번째 질문 뒤에 “경험은 어떠셨나요?”라는 필수 1–5점 평점 질문을 준비해 주세요.

어시스턴트: 대상 양식, 위치, 제안된 질문을 표시한 다음 추가하기 전에 확인을 요청합니다.

사용자: 확인합니다.

어시스턴트: 질문을 양식에 추가합니다. 별도로 요청하지 않는 한 양식을 게시하거나 닫지 않습니다.

Related MCP server: Google Workspace MCP Server

목차

• 빠른 시작

• 무엇을 요청할 수 있나요

• 양식이 어떻게 변경되나요

• 무엇을 변경할 수 있나요

• 액세스 권한 얻기

• 구성

• 데이터, 제한 사항 및 백그라운드 작업

• 기술 문서

• 지원

빠른 시작

Node.js 20 이상, Google 계정, 그리고 Google Forms API가 사용 설정된 Google Cloud 프로젝트의 OAuth 자격 증명이 필요합니다.

1. Google OAuth 액세스 준비.

2. AI 앱에 서버를 추가하세요.

3. 위의 읽기 전용 질문을 해 보세요.

앱에서: 설정 → 플러그인 → MCP 서버를 열고 서버 추가를 선택한 다음, 다음 환경 변수(GOOGLE_FORMS_CLIENT_ID, GOOGLE_FORMS_CLIENT_SECRET, GOOGLE_FORMS_REFRESH_TOKEN)와 함께 npx -y mcp-google-forms@latest를 추가하세요.

명령줄에서:

codex mcp add google-forms \
  --env GOOGLE_FORMS_CLIENT_ID=your_client_id \
  --env GOOGLE_FORMS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_FORMS_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-forms@latest

codex mcp list

Codex MCP 문서

claude mcp add \
  --env GOOGLE_FORMS_CLIENT_ID=your_client_id \
  --env GOOGLE_FORMS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_FORMS_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-forms \
  -- npx -y mcp-google-forms@latest

claude mcp list

Claude Code MCP 문서

설정 → 개발자 → 구성 편집을 열고 다음을 추가하세요:

{
  "mcpServers": {
    "google-forms": {
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"],
      "env": {
        "GOOGLE_FORMS_CLIENT_ID": "your_client_id",
        "GOOGLE_FORMS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_FORMS_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

구성 편집을 사용할 수 없으면 macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json, Windows에서는 %APPDATA%\Claude\claude_desktop_config.json을 편집하세요.

Claude Desktop MCP 문서

macOS/Linux에서는 ~/.cursor/mcp.json, Windows에서는 %USERPROFILE%\.cursor\mcp.json에 다음을 추가하세요:

{
  "mcpServers": {
    "google-forms": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"],
      "env": {
        "GOOGLE_FORMS_CLIENT_ID": "your_client_id",
        "GOOGLE_FORMS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_FORMS_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Cursor MCP 문서

MCP: Open User Configuration을 실행하고 다음을 추가하세요:

{
  "servers": {
    "google-forms": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"],
      "env": {
        "GOOGLE_FORMS_CLIENT_ID": "${input:forms_client_id}",
        "GOOGLE_FORMS_CLIENT_SECRET": "${input:forms_client_secret}",
        "GOOGLE_FORMS_REFRESH_TOKEN": "${input:forms_refresh_token}"
      }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "forms_client_id", "description": "Google OAuth client ID" },
    { "type": "promptString", "id": "forms_client_secret", "description": "Google OAuth client secret", "password": true },
    { "type": "promptString", "id": "forms_refresh_token", "description": "Google OAuth refresh token", "password": true }
  ]
}

MCP: List Servers로 확인하세요.

VS Code MCP 문서

무엇을 요청할 수 있나요

설문조사와 응답 확인

• 이 양식의 질문, 응답 설정 및 응답자 링크를 보여 주세요.

• 월요일 이후 도착한 답변 수는 몇 개인가요? 자유 텍스트 피드백을 요약해 주세요.

• ID로 응답 하나를 보여 주세요.

양식 만들기 및 개선

• 이름, 식사 선호도, 도착 날짜가 포함된 RSVP 양식을 만들어 주세요.

• 필수 평점, 드롭다운, 날짜, 시간, 선택형 또는 텍스트 질문을 추가해 주세요.

• 질문 순서를 변경하거나 제목, 설명, 퀴즈 모드, 이메일 수집 설정을 업데이트해 주세요.

게시 및 알림 연결

• 준비된 양식을 게시하고 응답자 URL을 보여 주세요.

• 양식을 삭제하지 않고 새 응답 수락을 중지해 주세요.

• 새 제출에 대한 Cloud Pub/Sub 감시를 생성, 갱신 또는 제거해 주세요.

양식이 어떻게 변경되나요

1. create_form은 기본적으로 게시되지 않은 상태로 시작하는 양식을 만듭니다.

2. 질문은 양식에서의 위치로 식별되는 항목입니다.

3. 게시하면 응답자가 양식을 사용할 수 있게 됩니다. 응답 수집을 닫으면 양식은 게시된 상태로 유지되지만 새 제출은 중단됩니다.

4. 응답은 별도의 읽기 전용 레코드입니다. API는 응답자의 답변을 제출, 편집 또는 삭제할 수 없습니다.

파일 업로드 질문은 Forms API로 만들 수 없지만, 기존 파일 업로드 항목은 읽을 수 있습니다. Google의 게시 모델 이전에 만든 레거시 양식은 게시 설정을 지원하지 않을 수 있습니다.

무엇을 변경할 수 있나요

AI 클라이언트가 확인 프롬프트를 제어합니다. 서버는 읽기 도구, 쓰기 도구 및 파괴적 도구를 표시하므로 클라이언트가 조회와 실제 변경을 구분할 수 있습니다.

액세스 권한 얻기

Google Forms는 OAuth 2.0이 필요하며 API 키만으로는 충분하지 않습니다.

1. Google Cloud 프로젝트를 만들거나 선택하고 Google Forms API를 사용 설정합니다.

2. OAuth 동의 화면을 구성하고 데스크톱 앱 OAuth 클라이언트를 만듭니다.

3. 양식을 소유하거나 편집할 수 있는 Google 계정을 승인합니다. OAuth 2.0 Playground에서 Use your own OAuth credentials를 사용 설정하면 새로 고침 토큰을 얻을 수 있습니다.

4. 다음 두 범위를 요청하세요.

   https://www.googleapis.com/auth/forms.body
   https://www.googleapis.com/auth/forms.responses.readonly

테스트 모드 OAuth 새로 고침 토큰은 7일 후 만료될 수 있습니다. 장기 액세스가 필요하면 OAuth 앱을 게시하거나 Workspace 도메인에서 내부 앱을 사용하세요. 클라이언트 시크릿과 새로 고침 토큰은 비밀번호처럼 취급하세요.

구성

* OAuth 자격 증명 3종 또는 액세스 토큰 중 하나를 제공하세요.

데이터, 제한 사항 및 백그라운드 작업

• 요청은 Google Forms로 전송됩니다. 로컬 서버가 Google OAuth 토큰을 새로 고치고 Forms API를 호출합니다. 이 서버의 익명 원격 분석에는 설치 ID, 패키지 버전, AI 클라이언트 및 플랫폼 버전, 도구 이름이 포함되며 OAuth 토큰, 양식 데이터, 도구 인수 또는 프롬프트는 절대 포함되지 않습니다. ASKADS_TELEMETRY=0으로 설정하면 옵트아웃할 수 있습니다.

• Google은 분당 할당량을 적용합니다. 문서화된 한도는 프로젝트당 읽기 975회, list_responses 호출 450회, 쓰기 375회입니다. 429 응답 시 서버는 백오프를 사용합니다. 읽기는 네트워크 및 5xx 오류 후에도 재시도되지만, 쓰기는 결과가 불확실한 실패 후에는 다시 실행되지 않습니다.

• 백그라운드 폴링은 없습니다. 서버는 호출될 때만 실행됩니다. Pub/Sub 감시는 새 응답을 사용자 자신의 인프라에 알릴 수 있으며, AI 앱이 예약 작업을 지원한다면 주기적으로 응답을 확인할 수도 있습니다.

기술 문서

• MCP 기능 카탈로그 — 모든 도구에 대한 작업 중심 페이지.

• 모든 도구 및 입력값

• 개발 문서

• 게시 문서

• Google Forms API 참조

지원

버그를 발견했거나 특정 시나리오가 필요하신가요? 이슈 만들기 또는 Telegram으로 문의하세요.