MCP 설치와 설정

자체 제작 MCP 서버(moai-mcp- 로 시작하는 것들)를 쓰려면 준비물이 하나 필요합니다. 한 번만 설치하면 모든 MCP 서버가 이걸 씁니다.

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

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

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

PowerShell을 열고 붙여 넣으세요.

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

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

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

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

uv --version

Warning

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

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

Claude Cowork에서:

claude plugin marketplace add modu-ai/moai-cowork

그다음 Plugins 메뉴에서 원하는 코워커를 설치하면 됩니다. ChatGPT Work는 설치와 관리 문서를 보세요.

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

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

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

{
  "env": {
    "NAVER_COMMERCE_CLIENT_ID": "여기에 붙여넣기",
    "NAVER_COMMERCE_CLIENT_SECRET": "여기에 붙여넣기",
    "NAVER_COMMERCE_ACCOUNT_ID": "여기에 붙여넣기"
  }
}

Danger

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

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

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

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

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

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

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

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

• 문제가 생겼다면 → 문제 해결