MCP Server
概要
Arrival Space MCP（Model Context Protocol）サーバーにより、Claude などの AIアシスタントが Arrival Space アカウントと直接やり取りできます。自然言語の会話を通じて、スペースの作成、エンティティの管理、3D環境の制御が可能です。
Model Context Protocol は、AIアシスタントが外部サービスに安全に接続できるようにするオープンスタンダードです。Claude を MCP 経由で Arrival Space に接続すると、Claude がスペースの新規作成や3Dコンテンツの追加など、あなたに代わってアクションを実行できるようになります。
Claude への接続
セットアップ
- Claude で Settings → Connectors → Add custom connector に移動します
- 以下のURLを入力します：
https://api-staging.arrival.space/api/v1/mcp - Arrival Space アカウントでサインインします
- 完了です！
OpenAI Codex への接続
セットアップ
- Codex で Settings → MCP servers → Add server に移動します
- 接続を設定します：
- Name:
arrival.space - Transport:
Streamable HTTP - URL:
https://api-staging.arrival.space/api/v1/mcp
- Name:
- Save をクリックし、次に Authenticate をクリックします
- ブラウザウィンドウが開きます — Arrival Space アカウントでサインインします
- 完了です！
利用可能なツール
接続すると、AIアシスタントは以下のツールを使用して Arrival Space アカウントとやり取りできます：
スペース管理
| ツール | 説明 |
|---|---|
list_spaces | 所有するすべてのスペースを一覧表示。検索とページネーションに対応 |
get_space | 特定のスペースの詳細を取得 |
create_space | 新しいスペースを作成（ハブまたはインフィニット） |
update_space | スペースのタイトル、説明、プライバシーを更新 |
delete_space | スペースとそのすべてのエンティティを削除 |
update_space_privacy | スペースのプライバシー設定を変更（Open/Closed） |
get_space_screenshot | スペースのスクリーンショット画像を取得（JPEG） |
エンティティ管理
| ツール | 説明 |
|---|---|
list_entities | スペース内のすべてのエンティティを一覧表示。ページネーションに対応 |
get_entity | 単一のエンティティの詳細を取得 |
create_entity | 新しいエンティティを作成（3Dモデル、プラグイン、スプラット、画像など） |
update_entity | エンティティのプロパティを更新（マージセマンティクス） |
delete_entity | スペースからエンティティを削除 |
エンティティデータフィールド
entity_data オブジェクトは以下のフィールドをサポートしています：
| フィールド | 型 | 説明 |
|---|---|---|
position | {x, y, z} | ワールド位置。例: {x: 0, y: 1.5, z: -3} |
rotation | {x, y, z} | オイラー回転（度数）。例: {x: 0, y: 90, z: 0} |
scale | number | 均一スケール倍率。デフォルト: 1.0。例: 2.0 = 2倍サイズ |
params | object | プラグインプロパティ値 — キーはプラグインの静的プロパティ名に対応 |
glbUrl | string | エンティティのアセットのCDN URL — 3Dモデル、画像、スプラット、またはプラグインスクリプト（.mjs）。名前は歴史的なもの。resource_key 使用時は自動設定 |
エンティティの更新時は、変更したいフィールドのみを指定してください。省略されたフィールドは現在の値を保持します（マージセマンティクス）。
アバター管理
| ツール | 説明 |
|---|---|
list_avatars | ID、パーツ、ティント、サムネイルURL付きでアバターを一覧表示 |
get_avatar_catalog | 外観説明付きで利用可能なアバターパーツとカテゴリを取得 |
create_avatar | パーツからアバターを作成。jobSeqを返す — 結果は get_avatar_status でポーリング |
generate_avatar_from_description | 自然言語の説明からアバターを作成（例:「短い赤い髪、青いジャケット」） |
update_avatar | 既存アバターのパーツやティントを更新 |
assign_avatar | アバターをアクティブアバターとして設定 |
get_avatar_status | アバター生成状況を確認し、完了時にGLBモデルURLを取得 |
delete_avatar | アバターを削除 |
ファイルアップロード
| ツール | 説明 |
|---|---|
upload_text_file | UTF-8テキストファイル（プラグイン、JSONなど）をCDNにアップロード。resource_key を返す |
upload_file_from_url | 外部URLからファイルをCDNにアップロード。resource_key を返す |
upload_binary_file | Base64エンコードされたバイナリファイル（GLB、画像など）をCDNにアップロード。resource_key を返す |
ファイルアップロードで取得した resource_key を create_entity で使用して、アップロードしたコンテンツをスペースに配置できます。
プラグイン
| ツール | 説明 |
|---|---|
get_plugin_docs | Arrivalプラグインリポジトリからプラグインのドキュメントと例を取得 |
ユーザー情報
| ツール | 説明 |
|---|---|
get_user_info | プロフィール情報を取得 |
会話の例
接続後、Claude に以下のようなことを尋ねることができます：
スペースの一覧表示：
「Arrival Space のスペースをすべて表示して」
新しいスペースの作成：
「『マイギャラリー』という名前で、説明が『3Dアートのショーケース』の新しいスペースを作成して」
エンティティの管理：
「スペース 45637586_1234 のすべてのエンティティを一覧表示して」
プライバシーの更新：
「スペース 45637586_1234 を非公開にして」
技術的な詳細
サーバーエンドポイント
https://api-staging.arrival.space/api/v1/mcp
認証
MCP サーバーは、安全な認証のために OAuth 2.0 with PKCE を使用します。接続を承認すると、既存の API キーがアクセストークンとして使用されます。これは Arrival Space のアカウント設定で表示されるものと同じキーです。
サポートされるトランスポート
- Streamable HTTP（Claude Desktop に推奨）
- SSE（Server-Sent Events） レガシークライアント向け
OAuth ディスカバリー
MCP クライアントは以下のURLで OAuth エンドポイントを自動検出できます：
GET /.well-known/oauth-authorization-server
トラブルシューティング
接続の問題
Claude が Arrival Space に接続できない場合：
- サーバーURLを確認 —
https://api-staging.arrival.space/api/v1/mcpと正確に一致していることを確認してください - 設定の編集後に Claude Desktop を再起動してください
- 再認証 — 接続を削除して再度追加してみてください
認証ポップアップが表示されない
- ブラウザでポップアップがブロックされていないことを確認してください
- Claude が OAuth URL を提供した場合は、手動でその URL を開いてみてください
「Invalid API key」エラー
- セッションが期限切れの可能性があります — Arrival Space の任意のアクションを実行して再認証してください
- Arrival Space アカウントが認証済みでアクティブであることを確認してください
セキュリティ
- パスワードは Claude と決して共有されません
- 認証は業界標準の OAuth 2.0 with PKCE を使用しています
- アクセストークンは API キーであり、Arrival Space のアカウント設定からいつでも取り消すことができます
- すべての通信は HTTPS で暗号化されています
信頼できる MCP サーバーにのみ接続してください。api-staging.arrival.space の Arrival Space MCP サーバーは、Arrival Space チームが公式に管理しています。