Setup Mcp Connector

---
name: setup-mcp-connector
description: |
  Claude Cowork와 ChatGPT Work에서 Google Drive·Notion·Higgsfield 등의 외부 앱과
  설치된 MoAI 플러그인의 MCP 연결·인증 상태를 확인하고 문제를 좁혀 안내합니다.
  앱 설치, 계정 연결, 도구 노출, 실제 읽기 호출을 각각 구분합니다.
version: "1.1.4"
---

# 외부 앱과 MCP 연결 확인

사용자가 연결하려는 **서비스와 앱**을 먼저 확인한다. 이 스킬은 연결을 안내하며, 다른 플러그인이나 계정 권한이 이미 있다고 가정하지 않는다. `moai-officer` 플러그인 자체의 `.mcp.json`에는 `kordoc`만 선언돼 있다. 다른 기관 데이터 서버는 해당 플러그인을 설치하고 연결해야 한다.

## 공통 절차

1. 현재 앱의 Plugins 또는 Apps/Connectors 화면에서 필요한 플러그인·앱이 보이는지 확인한다. 관리형 워크스페이스에서 사용이 막혀 있으면 관리자 설정을 확인한다.
2. 서비스가 계정 연결을 요구하면 앱 화면에서 대상 계정과 요청 권한을 확인하고 인증한다. 플러그인 설치와 서비스 계정 인증은 별도 단계다. API 키·토큰을 채팅에 붙여 넣게 하지 않는다.
3. 현재 대화에 실제로 노출된 도구 이름과 입력 형식을 읽는다. 목록에 없는 도구 이름이나 과거의 고정된 인자 형식으로 호출하지 않는다.
4. 사용자의 자료 중 공개해도 되는 대상이나 무해한 읽기 호출 하나로 응답을 확인한다. 단순히 `connected` 표시만 보았으면 `설정 표시 확인`, 도구 목록만 보았으면 `도구 노출 확인`, 호출이 성공했을 때만 `읽기 호출 확인`이라고 적는다. 계정별 쓰기 권한과 실제 생성·게시 가능 여부는 각각 별도로 확인한다.
5. 실패하면 앱·플러그인 설치, 워크스페이스 허용, 계정 선택, 서비스 권한, 도구 노출, 실제 호출 중 어느 단계인지 분리해 보고한다. 확인하지 못한 단계는 `미확인`으로 둔다.

## 서비스별 안내

| 서비스 | 현재 앱에서 확인할 것 | 읽기 검증 예 |
|---|---|---|
| Google Drive | Plugins 또는 Apps/Connectors의 Google Drive 연결, 계정과 허용 범위 | 접근 권한이 있는 파일 또는 폴더 목록 |
| Notion | Notion 연결, 선택한 워크스페이스와 허용된 페이지 | 접근 권한이 있는 페이지 읽기 |
| Higgsfield | 공식 Higgsfield 플러그인 또는 MCP 연결, 계정 권한 | 현재 노출된 읽기 전용 모델·계정 도구가 있으면 호출 |
| `kordoc` | `moai-officer` 설치와 `kordoc` 도구 노출 | 사용자가 제공한 문서의 읽기·파싱 |

Higgsfield 생성 모델, 크레딧, 비용과 입력 형식은 **현재 연결**에서 확인한다. 모델 조회 도구가 없으면 계정 연결만으로 특정 모델을 쓸 수 있다고 약속하지 않는다. 이미지·영상 생성은 사용자가 요청한 모델과 비용을 확인한 뒤 해당 앱의 승인 절차를 따른다. 상세 생성 절차는 `moai-media:media-higgsfield-image` 또는 `moai-media:media-higgsfield-video`가 설치돼 있을 때 참고한다.

Google Drive와 Notion의 읽기·쓰기 가능 범위는 앱, 워크스페이스, 계정 권한에 따라 다르다. 읽기 호출 성공을 쓰기 권한의 증거로 쓰지 않는다.

## 다른 플러그인의 데이터 서버

| 데이터 | 담당 플러그인 | 확인할 것 |
|---|---|---|
| KOSIS 통계·건축물대장·OpenDART | `moai-analyst` | 해당 플러그인 설치, 각 서버 연결, 필요한 인증과 실제 조회 |
| 법령·판례 | `moai-lawyer` | `korean-law` 연결과 법제처 OC 인증, 현재 도구 스키마와 원문 조회 |
| 한국 특허·상표 및 해외 IP | `moai-lawyer` | `moai-mcp-ip` 연결, 기관별 자격증명과 실제 인증·검색 |

위 서버가 `moai-officer`에 자동 등록된다고 설명하지 않는다. 각 플러그인의 README와 현재 매니페스트에서 서비스별 설정을 확인한다. 기관 공식 데이터와 이를 중계하는 제3자 MCP의 운영 주체를 구분한다. 해당 플러그인이 없거나 도구가 보이지 않으면 연결 완료로 표시하지 않는다.

## 앱 화면에서 해결하기

- **Claude Cowork**: Customize의 Plugins와 Connectors에서 설치·연결 상태, 계정과 권한을 확인한다. 원격 사용자 지정 MCP는 Claude 계정의 커넥터 설정을 거치며, 외부에서 접근 가능한 서버가 필요하다.
- **ChatGPT Work**: Plugins 또는 Apps에서 설치와 계정 연결 상태를 따로 확인한다. 관리형 워크스페이스에서는 관리자 허용 여부도 확인한다.
- **macOS·Windows**: 두 OS 모두 현재 앱 화면에 표시된 절차를 우선한다. 로컬 실행기가 필요한 서버에서 실패하면 해당 플러그인의 설치 요구사항과 앱 오류를 확인한다. 경로 길이·한글 파일명·브라우저 캐시를 확인 전 원인으로 단정하지 않는다.
- **Linux**: 사용 중인 앱·호스트가 해당 OS를 실제 지원하는지 공식 안내에서 먼저 확인한다. 지원 여부를 확인하지 않은 데스크톱 앱 실행을 보장하지 않는다.

`CLAUDE.md`에 Markdown 목록을 붙여 넣어도 새 슬래시 명령이 등록되지는 않는다. 존재하지 않는 `--check` 명령이나 임의의 셸 설치 절차를 사용자에게 안내하지 않는다. 현재 연결 상태를 이 절차대로 확인해 표로 보고한다.

## 결과 표

| 서비스·앱 | 플러그인/앱 표시 | 계정 인증 | 도구 노출 | 실제 읽기 호출 | 남은 확인 |
|---|---|---|---|---|---|
| 사용자 요청 대상 | 확인/미확인 | 확인/미확인/불필요 | 확인/미확인 | 성공/실패/미실행 | 단계와 조치 |

공식 앱 안내: [Claude 플러그인](https://support.claude.com/en/articles/13837440-use-plugins-in-claude) · [Claude 커넥터](https://support.claude.com/en/articles/11176164-use-connectors-to-extend-claude-s-capabilities) · [ChatGPT 플러그인](https://help.openai.com/en/articles/20001256-plugins-in-chatgpt-and-codex) · [ChatGPT 연결 앱](https://help.openai.com/en/articles/11487775-connected-apps-in-chatgpt).