Skip to main content
  1. 모두의 코워크
  2. /
  3. 플러그인 설치·운용
  4. /
  5. MCP 연동
  6. /
  7. MCP 설치와 설정
MCP 연동

MCP 설치와 설정

검수자 · Goos Kim · 읽는 시간 4분 · 최종 업데이트 2026.08.22

MCP 서버를 쓰려면 준비물이 두 가지 필요합니다. 한 번만 설치하면 이후 모든 MCP 서버가 이걸 같이 씁니다.

준비물어떤 코워커에 필요한가
uv셀러, SNS 크리에이터, 미디어
Node.js회계사, 분석가, 코워커, 사무직원

두 가지 다 설치해 두는 편이 가장 속 편합니다. 어떤 코워커를 나중에 더 설치할지 미리 알 수 없으니까요.

1단계 — uv 설치

uv는 파이썬 프로그램을 알아서 준비해 실행해 주는 도구입니다. 우리가 만든 MCP 서버들은 파이썬으로 되어 있는데, uv가 있으면 필요한 것을 알아서 받아 옵니다. 따로 파이썬을 설치하거나 버전을 맞출 필요가 없습니다.

셀러(스마트스토어·아임웹·카페24), SNS 크리에이터(Threads), 미디어(ElevenLabs) 코워커가 이걸 씁니다.

macOS

터미널을 열고 붙여 넣으세요.

bash
curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

PowerShell을 열고 붙여 넣으세요.

powershell
winget install --id=astral-sh.uv -e

winget 이 없다면 이렇게도 됩니다.

powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

설치 확인

새 터미널을 열고 아래를 입력해 버전이 나오면 성공입니다.

text
uv --version
Warning
설치 직후 같은 창에서는 인식이 안 될 수 있습니다. 터미널을 닫았다 새로 여세요. 그래도 안 되면 컴퓨터를 다시 시작한 뒤 확인하세요.

2단계 — Node.js 설치

Node.js는 uv와 같은 역할을 하는 또 하나의 도구입니다. uv가 파이썬 쪽을 맡는다면, Node.js는 자바스크립트로 만들어진 MCP 서버를 준비해 실행합니다.

회계사·분석가(전자공시 dart), 코워커, 사무직원(문서 변환 kordoc) 코워커가 이걸 씁니다.

macOS

nodejs.org 에서 LTS 표시가 붙은 설치 파일을 받아 실행하세요. 설치 마법사에서 계속 “다음"만 누르면 됩니다.

Homebrew를 쓰신다면 터미널에서 이렇게도 됩니다.

bash
brew install node

Windows

PowerShell을 열고 붙여 넣으세요.

powershell
winget install --id=OpenJS.NodeJS.LTS -e

winget 이 없다면 nodejs.org 에서 LTS 설치 파일(.msi)을 받아 실행하세요. 마법사에서 계속 “다음"만 누르면 됩니다.

설치 확인

새 터미널(PowerShell)을 열고 아래 두 줄을 입력해 버전이 나오면 성공입니다.

text
node --version
npx --version
Warning
Node.js가 없으면 조용히 실패합니다. 오류 메시지가 뜨지 않고 해당 연동 기능이 그냥 목록에서 빠져 버립니다. “이 기능이 원래 없나 보다” 싶을 때는 위 확인 명령부터 해 보세요.

3단계 — 플러그인 설치

MCP 서버는 플러그인 안에 함께 들어 있습니다. 플러그인을 설치하면 서버도 같이 옵니다. 따로 받을 것이 없습니다.

Claude Cowork 앱의 설정(또는 플러그인) 화면에서 마켓플레이스 주소 modu-ai/moai-cowork를 추가하세요. 그다음 Plugins 메뉴에서 원하는 코워커를 설치하면 됩니다. ChatGPT Work도 같은 방식이며, 자세한 화면 흐름은 설치와 관리 문서를 보세요.

4단계 — 자격증명 넣기

MCP가 여러분의 계정으로 일하려면 열쇠가 필요합니다. 이 열쇠를 자격증명이라고 합니다.

서비스마다 발급 방법이 달라서, 각 서버의 안내 문서를 따라가시면 됩니다.

연동안내 문서
스마트스토어·아임웹·카페24셀러 코워커의 각 서버 CONNECTORS.md
Threads·인스타그램SNS 크리에이터 코워커의 CONNECTORS.md

발급받은 값은 설정 파일의 env 부분에 넣습니다. 예를 들어 스마트스토어는 이렇습니다.

json
{
  "env": {
    "NAVER_COMMERCE_CLIENT_ID": "여기에 붙여넣기",
    "NAVER_COMMERCE_CLIENT_SECRET": "여기에 붙여넣기",
    "NAVER_COMMERCE_ACCOUNT_ID": "여기에 붙여넣기"
  }
}
Danger
자격증명은 비밀번호와 같습니다. 채팅에 붙여 넣거나, 화면 공유 중에 열어 두거나, 저장소에 커밋하지 마세요. 화면 공유 중에 설정 파일을 열어 두는 사고가 가장 흔합니다.

5단계 — 연결 확인

설정을 마쳤으면 가벼운 조회부터 시켜 보세요. 처음부터 업로드 같은 큰 작업을 시키지 마시고, 읽기만 하는 것으로 확인하는 게 안전합니다.

  • 셀러: “오늘 주문 몇 건인지 확인해줘”

주문 건수가 나오면 연결된 것입니다.

자격증명이 없어도 됩니다

설정을 안 해도 코워커는 그대로 작동합니다. MCP 도구를 부르면 “아직 연동이 안 됐다"는 안내를 돌려주고, 그 대신 초안·점검표·원고를 만들어 드립니다. 실제 버튼을 누르는 단계는 직접 하실 수 있도록 순서를 알려 드립니다.

서버가 죽거나 대화가 끊기지 않습니다. 자격증명이 없는 것은 오류가 아니라 아직 안 한 일일 뿐이니까요.

토큰은 어디에 저장되나요

한 번 발급받은 열쇠는 시간이 지나면 갱신이 필요합니다. MCP 서버가 알아서 갱신하고, 갱신된 값을 아래 위치에 저장합니다.

운영체제위치
macOS~/.moai/mcp/
WindowsC:\Users\사용자이름\.moai\mcp\

소유자만 읽을 수 있게 권한을 제한합니다. 저장에 실패하는 환경이라면 메모리에만 두고 계속 동작하며, 다음에 켤 때 설정값으로 복구합니다. 어느 쪽이든 멈추지 않습니다.

다음