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 アカウントでサインインします
- 完了です！
利用可能なツール
接続すると、Claude は以下のツールを使用して Arrival Space アカウントとやり取りできます：
スペース管理
| ツール | 説明 |
|---|---|
list_spaces | 所有するすべてのスペースを一覧表示 |
get_space | 特定のスペースの詳細を取得 |
create_space | 新しいスペースを作成 |
update_space | スペースのタイトル、説明、プライバシーを更新 |
delete_space | スペースとそのすべてのエンティティを削除 |
update_space_privacy | スペースのプライバシー設定を変更（Open/Closed） |
エンティティ管理
| ツール | 説明 |
|---|---|
list_entities | スペース内のすべてのエンティティを一覧表示 |
get_entity | 単一のエンティティの詳細を取得 |
create_entity | 新しいエンティティ（3Dモデル、オブジェクトなど）を作成 |
update_entity | エンティティのプロパティを更新 |
delete_entity | スペースからエンティティを削除 |
ユーザー情報
| ツール | 説明 |
|---|---|
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 チームが公式に管理しています。