Xcode 설정 | Weegloo Docs

Xcode는 Claude Code나 Codex 같은 코딩 에이전트를 자체 화면 안에서 실행할 수 있습니다. 여기에 WEEGLOO MCP 서버를 연결하면, Xcode 안에서 도는 에이전트가 Content Type·Content·Media 같은 리소스를 직접 만들고 읽고 수정할 수 있습니다. 설치 도구는 MCP 서버와 함께 Skills와 Rules도 설치하여, 에이전트가 WEEGLOO API를 의도한 방식대로 사용하도록 돕습니다. Skills는 특정 작업을 잘 수행하는 방법을 담은 가이드이고, Rules는 작업 전반에서 지켜야 할 규칙입니다. 아래에서 Xcode 안에서 쓸 에이전트를 고르고, 설치 도구로 한 번에 설정한 다음 MCP 연결 인증을 마치면 됩니다.

MCP 서버와 Skills, Rules에 대한 자세한 내용은 각각 MCP, Skills와 Rules 페이지에서 다룹니다. 이 페이지는 Xcode에 연결하는 방법만 다룹니다.

사전 준비

아래 설치 명령을 실행하려면 Node.js가 필요합니다. 먼저 다음 명령으로 Node.js가 설치되어 있는지, 버전이 18 이상인지 확인하세요.

터미널

node --version # v18 이상이면 OK npx --version # 버전이 출력되면 OK

Node.js는 설치되어 있지만 npx가 설치되어 있지 않은 경우, 아래 명령으로 npm을 최신 버전으로 업데이트하세요. npm을 업데이트하면 npx도 함께 설치됩니다.

터미널

npm install -g npm@latest

Node.js가 설치되어 있지 않거나 버전이 낮다면, 사용 중인 운영체제에 맞는 방법으로 Node.js를 설치하세요.

터미널

brew install node

Homebrew가 없다면 brew.sh에서 먼저 설치하거나, nodejs.org에서 Node.js를 직접 다운로드하세요.

터미널

winget install OpenJS.NodeJS.LTS

winget이 없거나 인식되지 않으면 nodejs.org에서 LTS 설치 파일을 다운로드하세요. 설치한 뒤에는 터미널을 새로 열어야 합니다.

배포판 패키지는 구버전일 수 있으므로, 여러 배포판에서 사용할 수 있는 nvm으로 설치하는 방법을 권장합니다.

터미널

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash source ~/.bashrc nvm install --lts

설치 파일을 직접 받으려면 nodejs.org에서 확인하세요.

Xcode도 설치되어 있어야 합니다. 아직 없다면 Xcode 다운로드에서 받을 수 있습니다.

연결하기

기본 설치는 이 페이지의 설치 명령을 복사해 터미널에서 한 번 실행하면 됩니다. 설치 과정을 단계별로 직접 선택하려면 사용자 지정 설치를 여세요. Xcode 연결은 항상 현재 프로젝트에 설치되므로, 설치 명령은 연동할 프로젝트 폴더 안에서 실행합니다.

코딩 도구

MCP · Skills 설치하기

설치 명령을 복사해 터미널에서 실행하세요. 반드시 연동할 프로젝트 폴더 안에서 실행해야 합니다.

터미널

$ npx weegloo@latest -y \ --agent claude \ --host xcode \ --location project \ --token <Personal Access Token>

MCP 인증 연결

아래 순서대로 인증하세요.

터미널에서 Claude Code를 실행합니다. 반드시 연동할 프로젝트 폴더 안에서 실행해야 합니다.

터미널
claude
처음 실행하면 새 MCP 서버를 활성화할지 묻게 될 수 있습니다. 그러한 경우 weegloo와 weegloo-upload가 체크되어 있는 상태인 것을 확인하고 Enter를 눌러 제출합니다.

터미널
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
/mcp를 입력해 MCP 서버 관리 화면을 엽니다.

터미널
/mcp
목록에서 weegloo를 고릅니다. needs authentication 상태로 표시됩니다.

터미널
Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected

목록에 서버가 보이지 않으면: 목록에서 weegloo와 weegloo-upload가 보이지 않으면, 2번 활성화 화면에서 제출하지 않았거나 비활성화된 상태일 수 있습니다. Claude Code를 종료한 뒤 아래 명령을 터미널에 입력하고, 다시 claude를 실행하세요. 2번과 같은 화면이 다시 뜨면 weegloo와 weegloo-upload가 체크된 상태로 Enter를 눌러 제출하세요.
터미널
claude mcp reset-project-choices
연결 주소가 https://ai.weegloo.com/mcp인지 확인하고 Authenticate를 선택합니다.

터미널
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
Authenticate를 선택하면 브라우저에 아래와 같은 WEEGLOO 인증 페이지가 열립니다. 토큰 복사 버튼으로 토큰을 복사하여 붙여넣고 서버 연결을 누릅니다. weegloo가 connected로 바뀌면 완료입니다.

설치 후 Xcode Agent 세션을 새로 열어야 설정이 반영됩니다.

MCP · Skills 설치하기

설치 명령을 복사해 터미널에서 실행하세요. 반드시 연동할 프로젝트 폴더 안에서 실행해야 합니다.

터미널

$ npx weegloo@latest -y \ --agent codex \ --host xcode \ --location project \ --token <Personal Access Token>

MCP 인증 연결

아래 순서대로 인증하세요.

터미널에서 아래 명령을 실행하면 브라우저에 WEEGLOO 인증 페이지가 열립니다.

터미널
codex mcp login weegloo
열린 WEEGLOO 인증 페이지에 아래 토큰 복사 버튼으로 토큰을 복사하여 붙여넣고 서버 연결을 누릅니다. 이미 실행 중이던 에이전트는 인증 완료 후 재시작해야 적용됩니다.

설치 후 Xcode Agent 세션을 새로 열어야 설정이 반영됩니다.

npx weegloo를 대화형으로 실행해, 묻는 항목을 직접 고르며 설치합니다.

코딩 도구

설치 도구 실행하기

연동할 프로젝트 폴더로 이동한 다음, 그 폴더에서 아래 명령을 실행하고 묻는 항목을 차례로 고릅니다. 토큰을 묻는 자리에는 아래 토큰 복사 버튼으로 토큰을 복사하여 붙여넣습니다. 반드시 그 프로젝트 폴더 안에서 실행하세요.

터미널

npx weegloo@latest

터미널

✔ Select your IDE: Claude Code ✔ What would you like to install? MCP server, Skills and Rules ✔ Enter your Weegloo Personal Access Token: **** ← 복사한 토큰 ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

MCP 인증 연결

아래 순서대로 인증하세요.

터미널에서 Claude Code를 실행합니다. 반드시 연동할 프로젝트 폴더 안에서 실행해야 합니다.

터미널
claude
처음 실행하면 새 MCP 서버를 활성화할지 묻게 될 수 있습니다. 그러한 경우 weegloo와 weegloo-upload가 체크되어 있는 상태인 것을 확인하고 Enter를 눌러 제출합니다.

터미널
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
/mcp를 입력해 MCP 서버 관리 화면을 엽니다.

터미널
/mcp
목록에서 weegloo를 고릅니다. needs authentication 상태로 표시됩니다.

터미널
Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected

목록에 서버가 보이지 않으면: 목록에서 weegloo와 weegloo-upload가 보이지 않으면, 2번 활성화 화면에서 제출하지 않았거나 비활성화된 상태일 수 있습니다. Claude Code를 종료한 뒤 아래 명령을 터미널에 입력하고, 다시 claude를 실행하세요. 2번과 같은 화면이 다시 뜨면 weegloo와 weegloo-upload가 체크된 상태로 Enter를 눌러 제출하세요.
터미널
claude mcp reset-project-choices
연결 주소가 https://ai.weegloo.com/mcp인지 확인하고 Authenticate를 선택합니다.

터미널
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
Authenticate를 선택하면 브라우저에 아래와 같은 WEEGLOO 인증 페이지가 열립니다. 토큰 복사 버튼으로 토큰을 복사하여 붙여넣고 서버 연결을 누릅니다. weegloo가 connected로 바뀌면 완료입니다.

설치 후 Xcode Agent 세션을 새로 열어야 설정이 반영됩니다.

설치 도구 실행하기

터미널

npx weegloo@latest

터미널

✔ Select your IDE: Codex ✔ What would you like to install? MCP server, Skills and Rules ✔ Enter your Weegloo Personal Access Token: **** ← 복사한 토큰 ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

MCP 인증 연결

아래 순서대로 인증하세요.

터미널에서 아래 명령을 실행하면 브라우저에 WEEGLOO 인증 페이지가 열립니다.

터미널
codex mcp login weegloo
열린 WEEGLOO 인증 페이지에 아래 토큰 복사 버튼으로 토큰을 복사하여 붙여넣고 서버 연결을 누릅니다. 이미 실행 중이던 에이전트는 인증 완료 후 재시작해야 적용됩니다.

설치 후 Xcode Agent 세션을 새로 열어야 설정이 반영됩니다.

MCP 서버 설정 파일

설치 도구가 설정 파일을 자동으로 생성하고 관리하므로 사용자가 직접 확인하지 않아도 됩니다. 아래 내용은 구체적인 설정 파일 구조와 경로가 필요한 사용자를 위한 참고 자료입니다.

설치 도구는 Xcode 안에서 쓰기로 고른 에이전트의 설정 파일에 서버를 등록합니다. Xcode 연결은 항상 현재 프로젝트에 설치되므로, 파일도 프로젝트 폴더 안에 만들어집니다. 고른 에이전트에 따라 파일이 다릅니다.

Claude Code: 프로젝트 폴더의 .mcp.json (형식은 Claude Code 설정과 같습니다)
Codex: 프로젝트 폴더의 .codex/config.toml (형식은 Codex 설정과 같습니다)

Xcode 안에서 쓸 때만 다른 점이 하나 있습니다. 파일을 다루는 weegloo-upload 서버의 env에 PATH 항목이 함께 들어갑니다. Xcode는 에이전트를 최소한의 PATH로 실행하는데, 이 항목이 없으면 서버 실행에 필요한 npx를 찾지 못하기 때문입니다. Claude Code(.mcp.json)라면 다음과 같은 모양입니다.

{
  "mcpServers": {
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload"],
      "env": {
        "PATH": "/Users/jiwoo/.nvm/versions/node/v22.14.0/bin:/usr/bin:/bin",
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

이 PATH에는 설치를 실행한 Node의 위치가 그대로 기록됩니다. Node를 새 버전으로 올리면 이 경로가 어긋나므로, 업그레이드한 뒤에는 설치 도구를 다시 실행해 값을 갱신하세요.

Skills와 Rules

Skills와 Rules도 고른 에이전트의 방식을 그대로 따릅니다. 자세한 위치는 Claude Code 설정과 Codex 설정의 Skills·Rules 섹션을 참고하세요.

다음으로 할 일

MCP: 서버 그룹·파일 업로드 서버 등 연결의 바탕이 되는 내용을 다룹니다.
Skills와 Rules: 설치 도구가 함께 설치하는 Skills와 Rules가 무엇인지 다룹니다.
최신 상태로 유지하기: 설치한 Skills와 Rules를 최신으로 맞추는 방법을 다룹니다.
AI로 정적 페이지 옮겨오기: 연결한 MCP로 실제 페이지를 콘텐츠 기반 서비스로 옮기는 흐름을 따라갑니다.