Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →[책임 경계] Drive·Notion·Higgsfield 3커넥터 인증·환경변수·트러블슈팅 가이드 전담. 페어 moai-commerce:commerce-morning-brief(MCP 매장 데이터 호출)와 명확히 구분 — 본 스킬은 커넥터 설치·인증 단계, 페어는 인증 이후 실제 MCP 호출 결과물. 다음과 같은 요청 시 반드시 이 스킬을 사용하세요: "MCP 커넥터 연결", "Drive 인증 방법", "Notion Integration Token 어디서", "Higgsfield 키 발급", "Windows MAX_PATH 오류", "한글 파일명 30자 오류", "computer:// 링크 안 열려요", "커넥터 3개 연결 방법", "MCP 3커넥터 인증", "커넥터 오류 해결".
.claude/skills/modu-ai-mcp-connector-setup/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-01 | ✗→✓ | ▲ Improved | 54% | 0% |
| case-02 | ✗→✓ | ▲ Improved | 46% | 0% |
| case-05 | ✗→✓ | ▲ Improved | 55% | 0% |
| case-06 | ✗→✓ | ▲ Improved | 56% | 0% |
| case-08 | ✗→✓ | ▲ Improved | 67% | 0% |
Drive·Notion·Higgsfield 3커넥터를 Cowork에 연결하는 단계별 가이드를 제공합니다. 인증 흐름, API 키 입력, 1회 호출 검증, 트러블슈팅까지 셋업 전 과정을 다룹니다.
셋업 완료 체크리스트 Drive·Notion·Higgsfield — 인증 성공 + 1회 호출 성공 (Drive: 폴더 list / Notion: 공유 페이지 read / Higgsfield: 모델 list)
MCP 커넥터 연결, Drive 인증, Notion Integration Token, Higgsfield API 키, 3커넥터 설치, computer:// 링크, MAX_PATH 오류, 한글 파일명 오류, OAuth redirect URI
커넥터 연결 전에 아래 계정을 미리 생성해 두세요:
> HARD] API 키 보안 수칙: API 키는 본인이 직접 발급·보관합니다. 채팅 대화나 공유 문서에 키 원문을 붙여넣지 말고, 커넥터 설정 화면의 API Key 필드에만 입력하세요.
목적: Cowork 폴더 마운트 + 파일 접근 (drive.readonly, drive.file 권한)
인증 방법: Cowork 앱 → 커넥터 추가 → Google Drive → OAuth 로그인
필수 권한
drive.readonly — 파일 읽기drive.file — Cowork가 생성한 파일 접근인증 단계
1회 호출 검증: 폴더 목록이 응답에 나타나면 성공
목적: 작업 결과물 Notion 페이지 읽기·쓰기
인증 방법: Cowork 앱 → 커넥터 추가 → Notion → OAuth 인증
인증 단계
1회 호출 검증: 공유 페이지 내용이 응답에 나타나면 성공
목적: 광고 영상 생성 등 미디어 작업 (이미지·영상 생성 모델 호출)
인증 방법: API 키 방식 (OAuth 아님)
사전 확인 사항
인증 단계
1회 호출 검증: 사용 가능한 모델 목록이 응답에 나타나면 성공
증상: Cowork 폴더 마운트 실패, 경로 관련 오류 메시지
원인: Windows 기본 MAX_PATH 260자 제한. 한글 파일명이 포함된 긴 경로에서 자주 발생.
해결 방법
C:\cowork\ 또는 D:\cw\)해결이 어려운 경우 (대체 경로): 위 방법으로 해결되지 않으면 로컬 폴더 마운트 대신 Google Drive 커넥터(Connector A)로 파일에 접근하는 임시 경로를 사용할 수 있습니다.
computer:// 링크 안 열림증상: Cowork가 제공하는 computer:// 링크를 클릭해도 열리지 않음
해결 방법
증상: OAuth 화면에서 "접근 거부" 또는 redirect 오류
해결 방법
증상: "Invalid API key" 또는 "Unauthorized" 오류
해결 방법
커넥터 셋업을 마친 뒤, 프로젝트 CLAUDE.md에 아래와 같은 슬래시 커맨드를 등록하면 자주 쓰는 스킬을 빠르게 호출할 수 있습니다:
markdown## 슬래시 커맨드 - `/morning-brief` — 아침 브리핑 (commerce-morning-brief) - `/detail-copy` — 상세페이지 카피 (detail-page-copy) - `/channel-msg` — 채널 메시지 (commerce-channel-message)
프로젝트 폴더의 CLAUDE.md에 위 블록을 붙여넣어 등록합니다.
--check 옵션)사전 준비물 기준으로 3커넥터 가입·인증 상태를 체크하는 옵션입니다.
/mcp-connector-setup --check출력 예시:
[✅] Google Drive — 계정 확인 완료
[✅] Notion — 계정 확인 완료
[⚠️] Higgsfield — 워크스페이스 크레딧 충전 미확인 (충전 후 재시도)예시 1 > "Drive MCP 연결하는 방법 알려줘"
→ Connector A (Google Drive) 인증 단계 제공 + 1회 호출 검증 안내
예시 2 > "Windows에서 Cowork 마운트가 안 돼요"
→ T1 (MAX_PATH 오류) 해결 방법 제공 + 대체 경로 안내
--check 옵션: 3커넥터 상태 체크리스트 (.md 파일 저장 가능)| 커넥터 | 인증 방법 | 1회 호출 검증 | |--------|-----------|---------------| | Google Drive | OAuth (drive.readonly, drive.file) | 폴더 list 응답 | | Notion | OAuth (워크스페이스 연결) | 공유 페이지 read 응답 | | Higgsfield | API Key | 모델 list 응답 |
3커넥터 모두 인증 성공 + 1회 호출 성공이면 셋업이 완료된 것입니다.
moai-commerce:commerce-morning-brief — 인증 완료 후 매장 데이터 아침 브리핑 + 신규 주문 통합 요약 (주문 요약 모드)moai-media:higgsfield-image / moai-media:higgsfield-video — Higgsfield 커넥터 인증 완료 후 이미지·영상 생성moai-commerce:commerce-morning-brief 직접 호출 (전체 브리핑 또는 주문 요약 모드)moai-commerce 스킬 사용moai-marketing:meta-ads-manager 스킬 참조| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-01 | fail→pass | 18,459 | 42,623 | +131% | 1 | 1 | 0% | 3,117 | 4,801 | +54% | 0 | 0 | — |
case-02 | fail→pass | 15,411 | 9,455 | -39% | 1 | 1 | 0% | 2,585 | 3,775 | +46% | 0 | 0 | — |
case-03 | fail→fail | 13,700 | 9,192 | -33% | 1 | 1 | 0% | 2,326 | 3,627 | +56% | 0 | 0 | — |
case-04 | pass→pass | 14,199 | 5,683 | -60% | 1 | 1 | 0% | 2,505 | 3,047 | +22% | 0 | 0 | — |
case-05 | fail→pass | 9,862 | 4,107 | -58% | 1 | 1 | 0% | 1,730 | 2,689 | +55% | 0 | 0 | — |
case-06 | fail→pass | 12,067 | 8,176 | -32% | 1 | 1 | 0% | 2,139 | 3,335 | +56% | 0 | 0 | — |
case-07 | pass→pass | 13,094 | 4,903 | -63% | 1 | 1 | 0% | 2,126 | 2,979 | +40% | 0 | 0 | — |
case-08 | fail→pass | 10,332 | 5,768 | -44% | 1 | 1 | 0% | 1,858 | 3,104 | +67% | 0 | 0 | — |
case-09 | fail→pass | 9,218 | 4,408 | -52% | 1 | 1 | 0% | 1,629 | 2,769 | +70% | 0 | 0 | — |
case-10 | pass→pass | 13,571 | 6,490 | -52% | 1 | 1 | 0% | 2,190 | 3,242 | +48% | 0 | 0 | — |
case-11 | fail→pass | 14,910 | 10,613 | -29% | 1 | 1 | 0% | 2,646 | 3,773 | +43% | 0 | 0 | — |
case-12 | fail→pass | 12,536 | 5,704 | -54% | 1 | 1 | 0% | 2,123 | 2,939 | +38% | 0 | 0 | — |
case-13 | pass→pass | 12,935 | 8,531 | -34% | 1 | 1 | 0% | 2,146 | 3,495 | +63% | 0 | 0 | — |
case-14 | fail→pass | 15,736 | 5,832 | -63% | 1 | 1 | 0% | 2,757 | 3,174 | +15% | 0 | 0 | — |
case-15 | fail→pass | 15,042 | 3,179 | -79% | 1 | 1 | 0% | 2,639 | 2,590 | -2% | 0 | 0 | — |
case-16 | fail→pass | 11,887 | 5,108 | -57% | 1 | 1 | 0% | 2,227 | 3,006 | +35% | 0 | 0 | — |
case-17 | pass→pass | 11,757 | 6,718 | -43% | 1 | 1 | 0% | 1,892 | 3,184 | +68% | 0 | 0 | — |
case-18 | pass→pass | 14,704 | 6,953 | -53% | 1 | 1 | 0% | 2,559 | 3,193 | +25% | 0 | 0 | — |
case-19 | fail→pass | 12,821 | 6,559 | -49% | 1 | 1 | 0% | 2,101 | 3,145 | +50% | 0 | 0 | — |
case-20 | fail→fail | 12,137 | 9,526 | -22% | 1 | 1 | 0% | 1,966 | 3,656 | +86% | 0 | 0 | — |
case-21 | fail→pass | 10,407 | 4,789 | -54% | 1 | 1 | 0% | 1,823 | 2,815 | +54% | 0 | 0 | — |
case-22 | fail→pass | 15,430 | 5,164 | -67% | 1 | 1 | 0% | 2,780 | 2,849 | +2% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted. The headline lift of +64 percentage points is the difference between those two pass rates over the 22 comparable cases.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.