Xcode の設定
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.js はインストールされているのに npx がインストールされていない場合は、以下のコマンドで npm を最新バージョンに更新してください。npm を更新すると npx も一緒にインストールされます。
Node.js がインストールされていない場合、またはバージョンが古い場合は、使用しているオペレーティングシステムに合った方法で Node.js をインストールしてください。
Homebrew がない場合は、まず brew.sh からインストールするか、nodejs.org から Node.js を直接ダウンロードしてください。
winget がインストールされていない、または認識されない場合は、nodejs.org から LTS インストーラーをダウンロードしてください。インストール後は、ターミナルを新しく開く必要があります。
ディストリビューションのパッケージは古い場合があるため、多くのディストリビューションで使える nvm でのインストールをおすすめします。
インストーラーを直接入手する場合は、nodejs.org を確認してください。
Xcode もインストールされている必要があります。まだない場合は Xcode のダウンロード から入手できます。
接続する
基本インストールは、このページのインストールコマンドをコピーして、ターミナルで一度実行するだけです。インストール手順を段階ごとに自分で選びたい場合は、カスタムインストール を開いてください。Xcode の接続は常に現在のプロジェクトにインストールされるため、インストールコマンドは連携するプロジェクトフォルダの中で実行します。
MCP・Skills をインストール
インストールコマンドをコピーして、ターミナルで実行してください。必ず連携するプロジェクトフォルダの中で実行してください。
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 をインストール
インストールコマンドをコピーして、ターミナルで実行してください。必ず連携するプロジェクトフォルダの中で実行してください。
MCP を認証
以下の順序で認証してください。
-
ターミナルで以下のコマンドを実行すると、ブラウザに WEEGLOO 認証ページが開きます。
ターミナルcodex mcp login weegloo -
開いた WEEGLOO 認証ページで、下の トークンをコピー ボタンでトークンをコピーして貼り付け、サーバーに接続 を押します。すでに起動していたエージェントは、認証の完了後に再起動しないと反映されません。
インストール後、設定を反映するには Xcode の Agent セッションを新しく開く必要があります。
npx weegloo を対話形式で実行し、尋ねられる項目を自分で選びながらインストールします。
インストールツールを実行する
連携するプロジェクトフォルダに移動したあと、そのフォルダで以下のコマンドを実行し、尋ねられる項目を順に選びます。トークンを尋ねられる箇所では、下の トークンをコピー ボタンでトークンをコピーして貼り付けます。必ずそのプロジェクトフォルダの中で実行してください。
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 を認証
以下の順序で認証してください。
-
ターミナルで以下のコマンドを実行すると、ブラウザに WEEGLOO 認証ページが開きます。
ターミナルcodex mcp login 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",
"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 で実際のページをコンテンツベースのサービスへ移す流れをたどります。