Xcode 설정

Xcode는 Claude Code나 Codex 같은 코딩 에이전트를 자체 화면 안에서 실행할 수 있습니다. 여기에 WEEGLOO MCP 서버를 연결하면, Xcode 안에서 도는 에이전트가 Content Type·Content·Media 같은 리소스를 직접 만들고 읽고 수정할 수 있습니다. 아래에서 Xcode 안에서 쓸 에이전트를 고르고, 설치 도구로 한 번에 설정한 다음 인증만 마치면 됩니다.

MCP 자체와 서버 그룹, 파일 업로드 서버에 대한 설명은 MCP에서 다룹니다. 이 페이지는 Xcode에 연결하는 단계만 다룹니다.

사전 준비

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

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

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

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

연결하기

Xcode 안에서 쓸 에이전트를 고르고, 다음 가이드를 따라 진행해 주세요. Xcode 연결은 항상 현재 프로젝트에 설치되므로, 설치 명령은 연동할 프로젝트 폴더 안에서 실행합니다.

Xcode에서 사용할 에이전트Claude Code

1

MCP · Skills 설치하기

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

터미널

$ npx weegloo@latest -y \ --agent claude \ --host xcode \ --token wgl_••••••••••••

명령 복사

2

MCP 인증 연결

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

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

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

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

   /mcp
4. 4.목록에서 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
5. 5.연결 주소가 https://ai.weegloo.com/mcp인지 확인하고 Authenticate를 선택합니다.
   터미널

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

토큰 복사

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

설정 파일 직접 확인하기

설치 도구는 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를 새 버전으로 올리면 이 경로가 어긋나므로, 업그레이드한 뒤에는 설치 도구를 다시 실행해 값을 갱신하세요.

다음으로 할 일

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