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 が必要です。まず、次のコマンドでインストールされているか、バージョンが 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

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 に変われば完了です。

このブラウザで WEEGLOO にログインしていない場合は、先にログイン画面が開き、ログインすると認証ページに戻ります。WEEGLOO の利用規約にまだ同意していない場合や、利用規約が変更された後の場合は、利用規約に同意するチェックボックスも表示されます。その場合は、このチェックボックスにチェックを入れてから 許可する を押します。

インストール後、設定を反映するには Xcode の Agent セッションを新しく開く必要があります。

MCP・Skills をインストール

インストールコマンドをコピーして、ターミナルで実行してください。必ず連携するプロジェクトフォルダの中で実行してください。

ターミナル

$ npx weegloo@latest -y \ --agent codex \ --host xcode \ --location project

MCP を認証

以下の順序で認証してください。

ターミナルで以下のコマンドを実行すると、ブラウザに WEEGLOO 認証ページが開きます。

ターミナル
codex mcp login weegloo
開いた WEEGLOO 認証ページで、ログイン中のアカウントが正しいことを確認し、許可する を押します。すでに起動していたエージェントは、認証の完了後に再起動しないと反映されません。

このブラウザで 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 ✔ 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 に変われば完了です。

このブラウザで WEEGLOO にログインしていない場合は、先にログイン画面が開き、ログインすると認証ページに戻ります。WEEGLOO の利用規約にまだ同意していない場合や、利用規約が変更された後の場合は、利用規約に同意するチェックボックスも表示されます。その場合は、このチェックボックスにチェックを入れてから 許可する を押します。

インストール後、設定を反映するには Xcode の Agent セッションを新しく開く必要があります。

インストールツールを実行する

ターミナル

npx weegloo@latest

ターミナル

✔ Select your IDE: Codex ✔ What would you like to install? MCP server, Skills and Rules ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

MCP を認証

以下の順序で認証してください。

ターミナルで以下のコマンドを実行すると、ブラウザに WEEGLOO 認証ページが開きます。

ターミナル
codex mcp login weegloo
開いた WEEGLOO 認証ページで、ログイン中のアカウントが正しいことを確認し、許可する を押します。すでに起動していたエージェントは、認証の完了後に再起動しないと反映されません。

このブラウザで WEEGLOO にログインしていない場合は、先にログイン画面が開き、ログインすると認証ページに戻ります。WEEGLOO の利用規約にまだ同意していない場合や、利用規約が変更された後の場合は、利用規約に同意するチェックボックスも表示されます。その場合は、このチェックボックスにチェックを入れてから 許可する を押します。

インストール後、設定を反映するには Xcode の Agent セッションを新しく開く必要があります。

MCP サーバー設定ファイル

インストールツールが設定ファイルを自動的に作成・管理するため、ユーザーが直接確認する必要はありません。以下の内容は、具体的な設定ファイルの構造やパスが必要なユーザー向けの参考資料です。

インストールツールは、Xcode の中で使うために選んだエージェントの設定ファイルにサーバーを登録します。Xcode の接続は常に現在のプロジェクトにインストールされるため、ファイルもプロジェクトフォルダの中に作られます。選んだエージェントによってファイルが異なります。

Claude Code: プロジェクトフォルダの .mcp.json (形式は Claude Code の設定と同じです)
Codex: プロジェクトフォルダの .codex/config.toml (形式は Codex の設定と同じです)

Xcode の中で使うときだけ、異なる点が 1 つあります。ファイルを扱う 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"
      }
    }
  }
}

この PATH には、インストールを実行した Node の場所がそのまま埋め込まれます。Node を新しいバージョンに上げるとこのパスがずれるため、アップグレードしたあとはインストールツールをもう一度実行して値を更新してください。

Skills と Rules

Skills と Rules も、選んだエージェントの方式にそのまま従います。詳しい場所は Claude Code の設定と Codex の設定の Skills・Rules セクションを参照してください。

次にすること

MCP: サーバーグループやファイルアップロードサーバーなど、接続の土台となる内容を扱います。
Skills と Rules: インストールツールが一緒にインストールする Skills と Rules が何かを扱います。
最新の状態に保つ: インストールした Skills と Rules を最新に合わせる方法を扱います。
AIで静的ページを移行する: 接続した MCP で実際のページをコンテンツベースのサービスへ移す流れをたどります。