Google Docs Automation via Rube MCP
Rube MCP(Composio)를 사용하여 Google Docs 문서를 프로그래밍 방식으로 생성, 편집, 검색, 내보내기 및 관리합니다.
툴킷 문서: composio.dev/toolkits/googledocs
사전 요구 사항
- Rube MCP가 연결되어 있어야 합니다 (
RUBE_SEARCH_TOOLS사용 가능) RUBE_MANAGE_CONNECTIONS를 통해googledocs툴킷으로 활성 연결이 있어야 합니다.- 항상
RUBE_SEARCH_TOOLS를 먼저 호출하여 현재 도구 스키마를 확인하세요.
설정
Rube MCP 가져오기: 클라이언트 설정에 https://rube.app/mcp를 MCP 서버로 추가하세요. API 키가 필요하지 않습니다. 엔드포인트만 추가하면 작동합니다.
RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP가 사용 가능한지 확인합니다.googledocs툴킷으로RUBE_MANAGE_CONNECTIONS를 호출합니다.- 연결이 ACTIVE 상태가 아닌 경우, 반환된 인증 링크를 따라 설정을 완료합니다.
- 워크플로우를 실행하기 전에 연결 상태가 ACTIVE로 표시되는지 확인합니다.
핵심 워크플로우
1. 새 문서 생성
GOOGLEDOCS_CREATE_DOCUMENT를 사용하여 제목과 초기 텍스트 콘텐츠로 새 Google 문서를 생성합니다.
도구: GOOGLEDOCS_CREATE_DOCUMENT
매개변수:
- title (필수): 문서 파일명/제목
- text (필수): 문서에 삽입할 초기 텍스트 콘텐츠
2. 문서 검색
GOOGLEDOCS_SEARCH_DOCUMENTS를 사용하여 이름, 내용, 날짜 또는 공유 상태로 Google 문서를 찾습니다.
도구: GOOGLEDOCS_SEARCH_DOCUMENTS
매개변수:
- query: 검색 쿼리 문자열
- max_results: 결과 수 제한
- modified_after / created_after: 날짜별 필터링
- shared_with_me: 공유 문서 필터링
- starred_only: 별표 표시된 문서 필터링
- include_shared_drives: 공유 드라이브 검색
- order_by: 결과 정렬
- page_token: 페이지네이션 토큰
3. 마크다운으로 문서 콘텐츠 업데이트
GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN을 사용하여 문서의 전체 콘텐츠를 마크다운 형식의 텍스트로 교체합니다.
도구: GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN
매개변수:
- id (필수): 문서 ID
- markdown (필수): 전체 문서 본문을 교체할 마크다운 콘텐츠
4. 텍스트 찾기 및 바꾸기
GOOGLEDOCS_REPLACE_ALL_TEXT를 사용하여 문서에서 문자열의 모든 항목을 바꿉니다.
도구: GOOGLEDOCS_REPLACE_ALL_TEXT
매개변수:
- document_id (필수): 대상 문서 ID
- find_text (필수): 검색할 텍스트
- replace_text (필수): 바꿀 텍스트
- match_case: 대소문자 구분 일치 (부울)
- search_by_regex: find_text에 정규식 사용
- tab_ids: 검색할 특정 탭
5. 문서를 PDF로 내보내기
GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF를 사용하여 Google 문서를 PDF 형식으로 내보냅니다.
도구: GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF
매개변수:
- file_id (필수): 문서 파일 ID
- filename: 출력 PDF 파일명
6. 문서 복사
GOOGLEDOCS_COPY_DOCUMENT를 사용하여 기존 Google 문서를 복제합니다.
도구: GOOGLEDOCS_COPY_DOCUMENT
매개변수:
- document_id (필수): 복사할 원본 문서 ID
- title: 새 복사본의 제목
- include_shared_drives: 원본 검색 시 공유 드라이브 포함
일반적인 패턴
- 검색 후 편집:
GOOGLEDOCS_SEARCH_DOCUMENTS를 사용하여 이름으로 문서를 찾은 다음, 반환된 문서 ID를GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN또는GOOGLEDOCS_REPLACE_ALL_TEXT와 함께 사용하여 수정합니다. - 템플릿에서 생성:
GOOGLEDOCS_COPY_DOCUMENT를 사용하여 템플릿을 복제한 다음,GOOGLEDOCS_REPLACE_ALL_TEXT를 사용하여 플레이스홀더 텍스트를 채웁니다. - 검색 후 업데이트:
GOOGLEDOCS_GET_DOCUMENT_BY_ID를 사용하여 현재 콘텐츠를 읽은 다음,GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT로 편집을 적용합니다. - 일괄 텍스트 삽입:
GOOGLEDOCS_INSERT_TEXT_ACTION을 사용하여 특정 위치(인덱스 기준)에 텍스트를 삽입하거나 문서 끝에 추가합니다. - 문서 공유: 생성 후
GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE(googledrive 툴킷)와 결합하여 문서를 공유합니다.
알려진 문제점
GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN은 문서의 전체 콘텐츠를 교체합니다. 추가하지 않습니다. 전체 재작성에만 사용하세요.GOOGLEDOCS_INSERT_TEXT_ACTION은 정확한insertion_index(문자 위치)가 필요합니다. 문서 끝에 안전하게 텍스트를 추가하려면append_to_end: true로 설정하세요.GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT는 원시 Google Docs API 배치 업데이트 요청이 포함된editDocs요청 본문을 구성해야 합니다. 올바른 구조는 API 문서를 참조하세요.- 문서 ID와 파일 ID는 Google Docs에서 동일한 값이지만, 도구 간 매개변수 이름이 다릅니다 (
id,document_id,file_id). GOOGLEDOCS_SEARCH_DOCUMENTS는query매개변수에 Google Drive 검색 구문을 사용합니다 (예:name contains 'report').
빠른 참조
| 작업 | 도구 | 주요 매개변수 |
|---|---|---|
| 문서 생성 | GOOGLEDOCS_CREATE_DOCUMENT | title, text |
| 문서 검색 | GOOGLEDOCS_SEARCH_DOCUMENTS | query, max_results, modified_after |
| ID로 문서 가져오기 | GOOGLEDOCS_GET_DOCUMENT_BY_ID | id |
| 마크다운으로 업데이트 | GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN | id, markdown |
| 프로그래매틱 편집 | GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT | document_id, editDocs |
| 텍스트 삽입 | GOOGLEDOCS_INSERT_TEXT_ACTION | document_id, text_to_insert, insertion_index |
| 찾기 및 바꾸기 | GOOGLEDOCS_REPLACE_ALL_TEXT | document_id, find_text, replace_text |
| PDF로 내보내기 | GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF | file_id, filename |
| 문서 복사 | GOOGLEDOCS_COPY_DOCUMENT | document_id, title |
Composio 제공