Expo MCP Server einrichten – einfache Schritt-für-Schritt-Anleitung

Wenn du mit Expo und Claude Code arbeitest, kann der Expo MCP Server den Unterschied zwischen allgemeinem KI-Gerede und wirklich brauchbarer Projektunterstützung ausmachen. Claude bekommt damit deutlich mehr Kontext zu deinem Expo-Projekt und kann gezielter bei Struktur, Navigation, Komponenten, Expo-spezifischen Fragen und typischen Entwicklungsaufgaben helfen. Gerade für Anfänger ist das hilfreich, weil du nicht jedes Detail selbst zusammensuchen musst. Für fortgeschrittene Nutzer spart es Zeit, weil Claude näher an der echten Expo-Arbeitsweise bleibt.

Wichtig ist aber: Die Einrichtung wirkt auf den ersten Blick einfacher, als sie tatsächlich ist. Viele scheitern nicht am eigentlichen Befehl, sondern an Kleinigkeiten wie dem falschen Projektordner, fehlender Authentifizierung, einem ungeeigneten Account oder falschen Erwartungen an den Login. Diese Anleitung zeigt dir deshalb nicht nur irgendeinen Befehl, sondern den sauberen Weg von Anfang bis Ende, damit du das Setup stabil und nachvollziehbar einrichtest.

1. Was der Expo MCP Server überhaupt macht

Der Expo MCP Server verbindet Claude Code mit dem Expo-Ökosystem. Dadurch kann Claude dein Projekt besser einordnen und Expo-spezifischer arbeiten. Das ist besonders nützlich, wenn du mit expo-router, Navigation, Screens, Komponenten, Builds oder Expo-Dokumentation arbeitest. Expo beschreibt den MCP-Server als Schnittstelle für AI-gestützte Entwicklung mit Expo-Kontext und zusätzlicher Dokumentations- und Projektunterstützung.

Für die Praxis heißt das: Claude kann besser verstehen, welche Expo-Struktur in deinem Projekt steckt, welche typischen Expo-Werkzeuge relevant sind und wie Änderungen sinnvoll in dein bestehendes Projekt eingebaut werden. Das macht Claude nicht automatisch perfekt, aber deutlich brauchbarer.

2. Welche Voraussetzungen du vor der Einrichtung prüfen solltest

Bevor du irgendetwas installierst, solltest du die Grundvoraussetzungen sauber prüfen. Du brauchst ein funktionierendes Node.js-Umfeld, npx, ein Expo-Konto, Claude Code und einen sauberen Projektordner. Wenn du noch gar kein Expo-Projekt hast, legst du zuerst eines an. Expo empfiehlt dafür den Weg über create-expo-app.

Ein weiterer wichtiger Punkt ist dein Expo-Account. Der Expo MCP Server setzt laut Expo einen bezahlten EAS-Plan voraus. Wenn du nur einen kostenlosen Account nutzt, kann es sein, dass die Authentifizierung zwar formal startet, du am Ende aber trotzdem keinen Zugriff erhältst. Genau dieser Punkt wird gern übersehen, weil viele denken, ein Token allein reiche aus. Das ist falsch. Ein Token authentifiziert dich, ersetzt aber keine Berechtigung.

3. Ein neues Expo-Projekt anlegen

Wenn du noch kein Projekt hast, leg zuerst eines an. Arbeite sauber in einem eigenen Projektordner und starte Claude später immer direkt in diesem Ordner. Das verhindert Chaos und sorgt dafür, dass Reports, Änderungen und Konfigurationsdateien nicht irgendwo im System landen.

cd C:\Claude_Projekte npx create-expo-app@latest expo-test-app

Nach der Erstellung wechselst du in den Projektordner:

cd C:\Claude_Projekte\expo-test-app

Dieser Schritt wirkt banal, ist aber wichtig. Wenn du Claude aus dem falschen Ordner startest, arbeitet es mit dem falschen Kontext. Das ist einer der häufigsten Fehler bei solchen Tools.

4. Claude Code im richtigen Projektordner starten

Starte Claude nicht irgendwo in C:\ oder im Benutzerordner, sondern direkt in deinem Expo-Projekt. Nur dann ist der Arbeitskontext sauber und Claude kann dateibezogen korrekt arbeiten.

claude

Wenn du weniger Bestätigungsabfragen willst, kannst du später projektbezogen auch einen passenderen Berechtigungsmodus setzen. Für den Anfang reicht aber der normale Start im richtigen Projektordner.

5. Expo MCP Server hinzufügen

Der nächste Schritt ist die eigentliche MCP-Verbindung. Expo dokumentiert für Claude Code den MCP-Server über eine HTTP-Verbindung. Der offizielle Befehl lautet so:

claude mcp add --transport http expo-mcp https://mcp.expo.dev/mcp

Wenn Claude meldet, dass der Server bereits existiert, ist das nicht automatisch ein Problem. Dann wurde der Eintrag bereits in der Konfiguration angelegt. Entscheidend ist nicht, ob der Server eingetragen ist, sondern ob er danach auch wirklich authentifiziert und aktiv ist.

6. MCP-Menü öffnen und Status prüfen

Starte Claude im Projekt und öffne den MCP-Bereich:

/mcp

Dort solltest du den Eintrag expo-mcp sehen. Am Anfang steht oft etwas wie needs authentication. Das ist normal. Es bedeutet nur, dass Claude den Server kennt, aber noch keine gültige Verbindung herstellen kann.

7. Authentifizierung: Warum ein Personal Access Token nötig ist

Bei der Expo-MCP-Authentifizierung landest du nicht zwingend in einem klassischen Login-Fenster. Häufig wird stattdessen direkt ein Expo-Token verlangt. Dafür brauchst du einen Personal Access Token aus deinem Expo-Account. Expo stellt diese Tokens im Account-Bereich für programmgesteuerten Zugriff bereit.

Wähle dabei keinen Robot-User, wenn du nur dein eigenes Setup für Claude Code einrichten willst. Für den normalen Einstieg ist ein persönlicher Zugriffstoken der richtige Weg. Robot-User sind eher für getrennte Maschinenkonten, Automatisierungen oder Team-Setups gedacht.

Gehe also in deinem Expo-Account in den Bereich für Access Tokens, erstelle einen neuen Personal Access Token und kopiere den Wert sofort. Danach fügst du ihn in Claude bei der MCP-Authentifizierung ein.

8. Was du tun musst, wenn die Authentifizierung scheitert

Wenn du eine Meldung bekommst, dass dein Account keinen Zugriff hat, liegt das oft nicht am Token selbst, sondern an fehlender Berechtigung. Genau hier scheitern viele Nutzer. Der häufigste Denkfehler lautet: „Token erstellt, also muss es funktionieren.“ Nein. Wenn dein Account den Dienst nicht nutzen darf oder der passende Plan fehlt, hilft dir auch ein korrekter Token nicht weiter.

Prüfe deshalb in diesem Fall zuerst deinen Expo-Plan. Wenn du den kostenlosen Plan nutzt, musst du auf einen bezahlten EAS-Plan wechseln. Nach dem Upgrade kann die Authentifizierung funktionieren, wenn dein Account damit die nötige Berechtigung erhält. Erst danach lohnt sich ein neuer Versuch.

9. Prüfen, ob der Expo MCP Server wirklich aktiv ist

Nach erfolgreicher Authentifizierung öffnest du erneut das MCP-Menü mit /mcp. Dort sollte expo-mcp jetzt nicht mehr als unverbunden erscheinen, sondern als aktiv oder authentifiziert. Erst dann ist die Einrichtung wirklich abgeschlossen. Alles davor ist nur Vorbereitung.

Wenn der Server dort aktiv angezeigt wird, ist das die Bestätigung, dass Claude ab jetzt mit dem Expo-MCP-Kontext arbeiten kann. Genau diesen Status solltest du immer prüfen, statt einfach anzunehmen, dass nach einem Befehl schon alles richtig läuft.

10. Onboarding im Expo-Projekt ausführen

Nach der erfolgreichen Verbindung solltest du nicht sofort wahllos Befehle ausprobieren. Der bessere Weg ist das Onboarding. Damit analysiert Claude dein bestehendes Expo-Projekt und erkennt die vorhandene Struktur.

/expo-mcp:onboarding

Das ist sinnvoller als direkt mit Diagnosen oder Fehlersuche zu starten. Onboarding ist der richtige Einstieg, weil Claude dadurch zuerst versteht, welche Expo-Version, welche Routing-Struktur und welche Projektarchitektur gerade vorliegt. Danach werden seine Vorschläge deutlich präziser.

11. Projekt lokal starten und Änderungen testen

Nach der Einrichtung solltest du nicht blind weiterarbeiten, sondern das Projekt lokal starten und prüfen, ob alles sauber läuft. Dafür nutzt du den normalen Expo-Startbefehl:

npx expo start

Wenn Metro sauber startet, kannst du die App im Browser, in Expo Go oder später auf einem Emulator testen. Für die Webansicht reicht meist die Taste w im laufenden Expo-Terminal. So kontrollierst du direkt, ob Claude brauchbare Änderungen erzeugt hat oder nur ordentlich klingende Vorschläge macht.

12. Typische Fehler bei der Expo-MCP-Einrichtung

Einige Fehler tauchen immer wieder auf. Du startest Claude im falschen Ordner, nutzt keinen bezahlten Plan, verwechselst Personal Access Token mit anderen Token-Arten oder erwartest einen normalen Login, obwohl stattdessen ein Token verlangt wird. Ebenfalls häufig: Der Server wurde hinzugefügt, aber nie sauber auf aktiv geprüft.

Wenn du strukturiert arbeitest, vermeidest du fast alle dieser Probleme. Projekt anlegen, in den Projektordner wechseln, Claude dort starten, MCP hinzufügen, Token korrekt erstellen, Status prüfen, Onboarding ausführen, lokal testen. Genau diese Reihenfolge ist robust.

13. Für wen sich das Setup besonders lohnt

Das Setup lohnt sich vor allem dann, wenn du regelmäßig an Expo-Apps arbeitest und Claude nicht nur für allgemeine Fragen, sondern wirklich als Entwicklungswerkzeug nutzen willst. Wenn du nur einmal im Monat eine Kleinigkeit an einer App änderst, ist der Mehrwert kleiner. Wenn du aber Screens, Navigation, UI, Projektstruktur oder Expo-spezifische Aufgaben regelmäßig mit Claude bearbeitest, spart dir Expo MCP spürbar Zeit.

14. Fazit

Der Expo MCP Server ist kein Zaubertrick, aber ein sinnvoller Baustein für ein besseres Claude-Setup im Expo-Projekt. Entscheidend ist nicht nur der Installationsbefehl, sondern die saubere Reihenfolge: Erst ein ordentliches Expo-Projekt, dann Claude im richtigen Ordner, dann MCP hinzufügen, korrekt authentifizieren, den Account-Plan prüfen und zum Schluss Onboarding und Testlauf durchführen. Genau so wird aus einer theoretischen Funktion ein Arbeitssetup, das dir im Alltag wirklich hilft.

Wenn du Unterstützung benötigst, kannst du dich jederzeit per E-Mail an hello@mikas.at wenden.