MCP Server
Überblick
Der Arrival Space MCP (Model Context Protocol) Server ermöglicht es KI-Assistenten wie Claude, direkt mit Ihrem Arrival Space-Konto zu interagieren. Sie können Spaces erstellen, Entities verwalten und Ihre 3D-Umgebungen durch natürlichsprachliche Konversationen steuern.
Das Model Context Protocol ist ein offener Standard, der es KI-Assistenten ermöglicht, sich sicher mit externen Diensten zu verbinden. Wenn Sie Claude über MCP mit Arrival Space verbinden, kann Claude Aktionen in Ihrem Namen ausführen — wie das Erstellen neuer Spaces oder das Hinzufügen von 3D-Inhalten.
Verbindung mit Claude herstellen
Einrichtung
- Gehen Sie in Claude zu Einstellungen -> Connectors -> Benutzerdefinierten Connector hinzufügen
- Geben Sie die URL ein:
https://api-staging.arrival.space/api/v1/mcp - Melden Sie sich mit Ihrem Arrival Space-Konto an
- Fertig!
Verbindung mit OpenAI Codex herstellen
Einrichtung
- Gehen Sie in Codex zu Settings → MCP servers → Add server
- Konfigurieren Sie die Verbindung:
- Name:
arrival.space - Transport:
Streamable HTTP - URL:
https://api-staging.arrival.space/api/v1/mcp
- Name:
- Klicken Sie auf Save und dann auf Authenticate
- Ein Browserfenster öffnet sich — melden Sie sich mit Ihrem Arrival Space-Konto an
- Fertig!
Verfügbare Tools
Sobald die Verbindung hergestellt ist, kann der KI-Assistent die folgenden Tools verwenden, um mit Ihrem Arrival Space-Konto zu interagieren:
Space-Verwaltung
| Tool | Beschreibung |
|---|---|
list_spaces | Alle Ihre Spaces auflisten. Unterstützt Suche und Paginierung |
get_space | Details eines bestimmten Space abrufen |
create_space | Einen neuen Space erstellen (Hub oder Infinite) |
update_space | Space-Titel, Beschreibung oder Datenschutz aktualisieren |
delete_space | Einen Space und alle seine Entities löschen |
update_space_privacy | Datenschutzeinstellung des Space ändern (Offen/Geschlossen) |
get_space_screenshot | Screenshot eines Space abrufen (JPEG) |
Entity-Verwaltung
| Tool | Beschreibung |
|---|---|
list_entities | Alle Entities in einem Space auflisten. Unterstützt Paginierung |
get_entity | Details einer einzelnen Entity abrufen |
create_entity | Eine neue Entity erstellen (3D-Modell, Plugin, Splat, Bild usw.) |
update_entity | Entity-Eigenschaften aktualisieren (Merge-Semantik) |
delete_entity | Eine Entity aus einem Space löschen |
Entity-Datenfelder
Das entity_data-Objekt unterstützt die folgenden Felder:
| Feld | Typ | Beschreibung |
|---|---|---|
position | {x, y, z} | Weltposition. Beispiel: {x: 0, y: 1.5, z: -3} |
rotation | {x, y, z} | Euler-Rotation in Grad. Beispiel: {x: 0, y: 90, z: 0} |
scale | number | Einheitlicher Skalierungsfaktor. Standard: 1.0. Beispiel: 2.0 = doppelte Größe |
params | object | Plugin-Eigenschaftswerte — Schlüssel entsprechen den statischen Eigenschaftsnamen des Plugins |
glbUrl | string | CDN-URL für das Asset der Entity — 3D-Modell, Bild, Splat oder Plugin-Skript (.mjs). Name ist historisch; wird automatisch gesetzt bei Verwendung von resource_key |
Beim Aktualisieren einer Entity nur die Felder angeben, die geändert werden sollen. Nicht angegebene Felder behalten ihre aktuellen Werte (Merge-Semantik).
Avatar-Verwaltung
| Tool | Beschreibung |
|---|---|
list_avatars | Ihre Avatare mit IDs, Teilen, Farben und Vorschaubildern auflisten |
get_avatar_catalog | Verfügbare Avatar-Teile und Kategorien mit Erscheinungsbeschreibungen abrufen |
create_avatar | Avatar aus Teilen erstellen. Gibt eine jobSeq zurück — get_avatar_status abfragen für das Ergebnis |
generate_avatar_from_description | Avatar aus einer natürlichsprachlichen Beschreibung erstellen (z.B. "kurze rote Haare, blaue Jacke") |
update_avatar | Teile oder Farben eines bestehenden Avatars aktualisieren |
assign_avatar | Einen Avatar als aktiven Avatar festlegen |
get_avatar_status | Status der Avatar-Generierung prüfen und GLB-Modell-URL abrufen |
delete_avatar | Einen Avatar löschen |
Datei-Uploads
| Tool | Beschreibung |
|---|---|
upload_text_file | UTF-8-Textdatei (Plugins, JSON usw.) ins CDN hochladen. Gibt einen resource_key zurück |
upload_file_from_url | Datei von einer externen URL ins CDN hochladen. Gibt einen resource_key zurück |
upload_binary_file | Base64-kodierte Binärdatei (GLB, Bilder usw.) ins CDN hochladen. Gibt einen resource_key zurück |
Verwenden Sie den resource_key aus Datei-Uploads mit create_entity, um hochgeladene Inhalte in einem Space zu platzieren.
Plugins
| Tool | Beschreibung |
|---|---|
get_plugin_docs | Plugin-Dokumentation und Beispiele aus dem Arrival-Plugins-Repository abrufen |
Benutzerinformationen
| Tool | Beschreibung |
|---|---|
get_user_info | Ihre Profilinformationen abrufen |
Beispielkonversationen
Hier sind einige Dinge, die Sie Claude nach der Verbindung fragen können:
Ihre Spaces auflisten:
"Zeige mir alle meine Arrival Space Spaces"
Einen neuen Space erstellen:
"Erstelle einen neuen Space namens 'Meine Galerie' mit der Beschreibung 'Eine Ausstellung meiner 3D-Kunst'"
Entities verwalten:
"Liste alle Entities in meinem Space 45637586_1234 auf"
Datenschutz aktualisieren:
"Mache meinen Space 45637586_1234 privat"
Technische Details
Server-Endpunkt
https://api-staging.arrival.space/api/v1/mcp
Authentifizierung
Der MCP Server verwendet OAuth 2.0 mit PKCE für sichere Authentifizierung. Wenn Sie die Verbindung autorisieren, wird Ihr bestehender API-Schlüssel als Access-Token verwendet — derselbe Schlüssel, der in Ihren Arrival Space-Kontoeinstellungen sichtbar ist.
Unterstützte Transporte
- Streamable HTTP (empfohlen für Claude Desktop)
- SSE (Server-Sent Events) für ältere Clients
OAuth-Discovery
MCP-Clients können OAuth-Endpunkte automatisch erkennen über:
GET /.well-known/oauth-authorization-server
Fehlerbehebung
Verbindungsprobleme
Wenn Claude keine Verbindung zu Arrival Space herstellen kann:
- Überprüfen Sie die Server-URL — stellen Sie sicher, dass sie genau
https://api-staging.arrival.space/api/v1/mcplautet - Starten Sie Claude Desktop neu nach dem Bearbeiten der Konfiguration
- Erneut authentifizieren — versuchen Sie, die Verbindung zu entfernen und neu hinzuzufügen
Authentifizierungs-Popup erscheint nicht
- Stellen Sie sicher, dass Pop-ups in Ihrem Browser nicht blockiert werden
- Versuchen Sie, die OAuth-URL manuell zu öffnen, wenn Claude eine bereitstellt
"Ungültiger API-Schlüssel"-Fehler
- Ihre Sitzung ist möglicherweise abgelaufen — authentifizieren Sie sich erneut, indem Sie eine beliebige Arrival Space-Aktion auslösen
- Überprüfen Sie, ob Ihr Arrival Space-Konto verifiziert und aktiv ist
Sicherheit
- Ihr Passwort wird niemals mit Claude geteilt
- Die Authentifizierung verwendet den Industriestandard OAuth 2.0 mit PKCE
- Der Access-Token ist Ihr API-Schlüssel, den Sie jederzeit in Ihren Arrival Space-Kontoeinstellungen widerrufen können
- Die gesamte Kommunikation ist über HTTPS verschlüsselt
Verbinden Sie sich nur mit MCP-Servern, denen Sie vertrauen. Der Arrival Space MCP Server unter api-staging.arrival.space wird offiziell vom Arrival Space-Team betrieben.