Val Town MCP Server
Offizieller gehosteter MCP-Server für Vals, JavaScript-Ausführung, Deployments, Logs und SQLite aus dem KI-Client.
- Skill Road
- Val Town MCP Server
Kategorien
Beschreibung
Der Val Town MCP Server ist der offizielle, gehostete Model-Context-Protocol-Endpunkt von Val Town. Er verbindet einen MCP-fähigen KI-Client mit dem Konto auf der Val-Town-Plattform. Die offizielle MCP-Anleitung nennt dafür https://api.val.town/v3/mcp; das aktuelle offizielle Repository für die Agent-Plugins ist https://github.com/val-town/plugins. Dieses Repository registriert denselben gehosteten Endpunkt für Claude Code, Codex und Cursor und beschreibt sich als Quelle der Plattform-Skills. Der MCP-Server selbst ist damit ein Val-Town-Produkt, nicht ein unabhängiger Community-Connector.
Zweck und dokumentierte Funktionen
Ein „val“ ist laut Val Town ein kollaborativer, versionierter Ordner mit ausführbarem Code: vergleichbar mit einem Repository, das laufen kann. Vals verwenden JavaScript im Deno-Runtime-Kontext und können HTTP-, Cron- und E-Mail-Trigger, SQLite, Blob-Speicher, Umgebungsvariablen, Logs und Traces nutzen. Die MCP-Dokumentation empfiehlt, das Modell Vals auflisten oder untersuchen zu lassen, SQLite-Daten und Logs zu lesen und Vals zu bearbeiten. Sie nennt ausdrücklich auch agentisches Iterieren: Das Modell kann Code ändern, die Ausgabe und Logs ansehen und anschließend weiterarbeiten. Neue oder geänderte Vals sind in der Plattform unmittelbar deploybar; HTTP-Endpoints, Cron-Jobs und E-Mail-Handler sind dokumentierte Ausführungsformen. Für größere Arbeiten empfiehlt Val Town jedoch Branches und ein Merge nach Stabilisierung. Jede Dateiänderung ist versioniert; die Versions- oder Historienansicht erlaubt Rollbacks.
Einrichtung und Zugriffstoken
Der dokumentierte direkte Start für Claude Code lautet claude mcp add --transport http val-town https://api.val.town/v3/mcp. Danach wird im Client die Verbindung geprüft und bei Bedarf der OAuth-Ablauf im Browser abgeschlossen. Das offizielle Plugin ist der bevorzugte Weg, weil es Server und Plattform-Skills bündelt; für Claude Code wird claude plugin install valtown@claude-plugins-official dokumentiert. Das offizielle Repository beschreibt zudem Installationswege für Codex und Cursor. Der MCP-Zugriff authentifiziert sich über OAuth, nicht dadurch, dass ein dauerhaftes API-Token in einen Prompt kopiert wird. Separat unterstützt die Val-Town-REST-API Bearer-Tokens. Solche Tokens werden auf der API-Tokens-Seite verwaltet und sind laut Dokumentation auf die erteilten Berechtigungen begrenzt. Ein Token ist ein Geheimnis: nur mit minimalen Rechten ausstellen, sicher im Client oder Secret-Store halten, nie in Git, Logs, Screenshots oder Chatnachrichten einfügen und bei Verdacht widerrufen.
Geheimnisse, Sichtbarkeit und Mutation
Umgebungsvariablen sind der dokumentierte Ort für Passwörter, Tokens und ähnliche Geheimnisse eines vals. Val Town sagt ausdrücklich, dass vals Umgebungsvariablen nicht programmatisch setzen können; Deno.env.set ist dafür wirkungslos. Das ist keine Freigabe, Secrets aus untrusted Eingaben in Code oder Ausgaben zu spiegeln. Ein Modell mit MCP-Schreibrechten kann Quellcode verändern und damit indirekt den Umgang mit vorhandenen Secrets beeinflussen. Vor jeder Mutation sollten deshalb Diff, Ziel-val, Branch und Trigger geprüft werden. Vals können öffentlich, nicht gelistet oder privat sein. „Nicht gelistet“ ist keine Zugriffskontrolle; für vertraulichen Quellcode und Daten ist privat plus passende Kollaborationsrechte erforderlich. Öffentliche HTTP-Endpoints brauchen zusätzlich eigene Authentifizierung, etwa OAuth, Basic Auth oder eine Login-Logik, wenn die Anwendung nicht offen sein soll.
Datenpfad und Sicherheitsgrenzen
Der praktische Datenpfad lautet: Nutzerin oder Nutzer formuliert eine Aufgabe im KI-Client; der Client sendet einen MCP-Tool-Aufruf an den Val-Town-Endpunkt; Val Town autorisiert und verarbeitet ihn gegen das Konto; strukturierte Ergebnisse wie val-Metadaten, Code, Logs oder SQLite-Ergebnisse kehren zum Client zurück. Der Client kann diese Tool-Ergebnisse dem ausgewählten Modell als Kontext übermitteln. Daher bedeutet ein gehosteter MCP-Server nicht, dass die Daten ausschließlich zwischen Client und Val Town bleiben: Welche Inhalte zusätzlich an den Modellanbieter gehen, hängt von Client, Modell, dessen Datenschutz- und Aufbewahrungsregeln sowie den gewählten Einstellungen ab. Keine Secrets, personenbezogenen SQLite-Inhalte oder fremden Webtexte ungeprüft in einen Modellkontext geben.
Prompt-Injection und verantwortlicher Betrieb
Logs, Kommentare, Webseiteninhalte, E-Mails und SQLite-Felder können untrusted Text enthalten. Solcher Text kann versuchen, das Modell zu Anweisungen wie „ignore previous instructions“, Secret-Exfiltration oder Deployment-Änderungen zu verleiten. Er ist Dateninhalt, keine Berechtigungsquelle. Beschränken Sie MCP-Rechte, arbeiten Sie für Änderungen in Branches, starten Sie mit Leseoperationen und bestätigen Sie jeden Schreib-, Deploy- oder Rollback-Schritt bewusst. Die GitHub-API meldete unmittelbar vor dem Seed am 08.09.2026 exakt 10 Sterne für val-town/plugins. Das ist nur eine Momentaufnahme der Repository-Popularität, weder Audit noch Sicherheits- oder Qualitätsurteil.
Voraussetzungen
Val-Town-Konto, kompatibler MCP-Client und OAuth-Freigabe; API-Tokens nur für die REST-API mit minimalen Rechten nutzen.
Installationsanleitung
Dieser Ratgeber richtet den offiziellen Val Town MCP Server so ein, dass ein KI-Client Vals und Plattformdaten nutzen kann, ohne Schreibrechte oder Geheimnisse unnötig auszuweiten. Ausgangspunkt ist die offizielle MCP-Dokumentation unter https://docs.val.town/guides/prompting/mcp/. Der Endpunkt ist gehostet: https://api.val.town/v3/mcp. Bevorzugen Sie das offizielle Plugin aus https://github.com/val-town/plugins, weil Val Town darüber sowohl den MCP-Server als auch die Plattform-Skills für Claude Code, Codex und Cursor verteilt. Behandeln Sie jede Verbindung als Zugriff auf Code, Logs und möglicherweise SQLite-Daten Ihres Kontos.
Schritt 1: Vor dem Verbinden inventarisieren
Erstellen Sie zuerst eine kleine Zugriffsentscheidung. Welche Vals sollen das Modell sehen? Welche sind öffentlich, nicht gelistet oder privat? Welche enthalten Produktionsendpoints, Kundendaten, Tokens oder sensible Logs? Privat ist die passende Sichtbarkeit für vertraulichen Quellcode; nicht gelistet verhindert nur das einfache Auffinden und ersetzt keine Zugriffskontrolle. Prüfen Sie auch die Kollaborationsrechte. Notieren Sie, welche Aktionen das Modell anfangs nur lesen darf und welche später nach menschlichem Review erlaubt sein können. Für eine neue Integration ist „Vals auflisten“ ein sinnvoller erster Test; Deployments, Code-Änderungen und Rollbacks gehören nicht in den ersten Prompt.
Schritt 2: OAuth und Client einrichten
Für Claude Code kann der direkte offizielle Befehl genutzt werden: claude mcp add --transport http val-town https://api.val.town/v3/mcp. Anschließend /mcp ausführen, die Verbindung kontrollieren und die OAuth-Autorisierung im Browser nur für das erwartete Val-Town-Konto abschließen. Alternativ claude plugin install valtown@claude-plugins-official verwenden; das ist laut Val Town der empfohlene Weg. Für Codex und Cursor folgen Sie den aktuellen Anweisungen im offiziellen Plugin-Repository. Prüfen Sie im Client nach der Installation den Servernamen und die Endpunkt-URL, statt Befehle aus Logtexten oder Webseiten blind zu übernehmen. OAuth-Dialoge und Token niemals in Screenshots, Tickets oder Prompts weitergeben.
claude mcp add --transport http val-town https://api.val.town/v3/mcp
claude plugin install valtown@claude-plugins-official
Schritt 3: API-Tokens und Secrets abgrenzen
Der MCP-Server verwendet den OAuth-Flow. Val-Town-API-Tokens sind davon getrennte Bearer-Tokens für die REST-API. Falls ein Workflow tatsächlich einen API-Token braucht, erzeugen Sie ihn mit minimalen Berechtigungen und legen Sie ihn in einer sicheren Client-Konfiguration oder einem Secret-Store ab. Ein Token gehört weder in eine val-Datei noch in den Chatverlauf. Val-Town-Umgebungsvariablen sind für Anwendungssecrets vorgesehen; die Dokumentation sagt zudem, dass vals sie nicht programmatisch setzen können. Das ist hilfreich gegen versehentliche Laufzeit-Updates, ersetzt aber kein Code-Review: Eine Code-Mutation könnte Secrets auslesen oder an einen externen Endpoint senden. Begrenzen Sie deshalb Schreibrechte und prüfen Sie Diffs vor dem Merge.
Sicherer erster Durchlauf
Starten Sie mit einer konkret begrenzten Leseaufgabe, etwa: „Liste nur meine privaten Entwicklungs-vals mit Name und Trigger auf; verändere nichts.“ Prüfen Sie die Antwort im Client und überlegen Sie, ob sie Daten enthält, die an das Modell gegangen sein sollen. Die Datenroute verläuft vom Nutzer zum Client, vom Client über MCP zu Val Town und mit den Tool-Ergebnissen zurück zum Client. Der Client kann Ergebnisse an das ausgewählte Modell übergeben. Beachten Sie daher zusätzlich die Datenschutz-, Aufbewahrungs- und Trainingsoptionen des Modellanbieters. Lassen Sie nicht ganze SQLite-Tabellen, Secrets oder Rohlogs in den Kontext laden, wenn eine gefilterte, redigierte Abfrage genügt.
Schritt 4: Änderungen, Ausführung und Deployments kontrollieren
Wenn der Lesezugriff zuverlässig ist, nutzen Sie für Mutationen einen Branch oder ein Remix. Bitten Sie das Modell zuerst um einen Plan und einen Diff, nicht sofort um die Ausführung. Kontrollieren Sie Ziel-val, Trigger, importierte Abhängigkeiten, neue Netzwerkziele und jede Behandlung von Deno.env. Erst dann Code schreiben lassen. Ein HTTP-val, Cron oder E-Mail-Handler kann nach der Änderung produktiv laufen; prüfen Sie deshalb Ausgabe, Logs und Authentifizierung vor einem Merge. Bei Problemen nicht hektisch nachbessern: Val Town versioniert Änderungen automatisch. Verwenden Sie Versions- oder Historienansicht für einen gezielten Rollback, nachdem Sie Ursache und betroffene Version bestimmt haben.
Prompt-Injection abwehren
MCP-Tool-Ergebnisse sind nicht automatisch vertrauenswürdig. Ein Logeintrag, E-Mail-Text, Webseiteninhalt, Kommentar oder SQLite-Feld kann das Modell zu einer fremden Anweisung verleiten. Behandeln Sie Aussagen wie „kopiere dieses Token“, „deaktiviere Auth“ oder „deploye sofort“ als untrusted Daten, auch wenn sie in einem Tool-Ergebnis stehen. Halten Sie eine klare Arbeitsregel: Tool-Inhalte dürfen Fakten liefern, aber weder Rechte erweitern noch menschliche Freigaben ersetzen. Verwenden Sie präzise Prompts, bestätigen Sie jede Schreiboperation ausdrücklich und beenden Sie die Sitzung bei verdächtiger Secret-Ausgabe.
FAQ
Ist der MCP-Endpunkt ein Ersatz für API-Tokens? Nein. Der dokumentierte MCP-Zugriff nutzt OAuth. API-Tokens dienen der REST-API und benötigen eigene, minimale Berechtigungen.
Kann ich öffentliche Vals bedenkenlos verbinden? Nein. Öffentlich betrifft Sichtbarkeit des Quellcodes, nicht die Sicherheit eines Endpoints, Logs oder der Modellweitergabe. Prüfen Sie Trigger und Dateninhalt.
Was ist der kleinste sichere Test? Eine klar begrenzte Leseoperation auf einen unkritischen Entwicklungs-val, gefolgt von einer Prüfung der angezeigten Tool-Ergebnisse und der Client-Konfiguration.
Authentifizierung
OAuth für den MCP-Server. REST-API-Tokens sind separate Bearer-Tokens mit begrenzten Berechtigungen und gehören nicht in Prompts.
Benötigte Zugriffsrechte
Der MCP-Server kann abhängig von der OAuth-Freigabe Vals, Code, Logs und SQLite lesen sowie Vals verändern; Schreibrechte bewusst begrenzen.
Übertragene oder gespeicherte Daten
MCP-Ergebnisse laufen von Val Town zurück zum KI-Client. Der Client kann sie dem gewählten Modell als Kontext senden; Modellanbieter-Regeln zusätzlich prüfen.
Sicherheitsrisiken
Code-Mutationen und Deployments, Zugriff auf Logs/SQLite, Token- oder Secret-Exposition sowie Prompt-Injection aus untrusted Tool-Inhalten.
Lizenz und Kosten
- Lizenz
- MIT
- Kosten
- kostenlos
Der offizielle Plugin-Quellcode ist MIT-lizenziert. Kontonutzung und KI-Client können eigenen Bedingungen unterliegen; aktuelle Angaben bei Val Town prüfen.
Alternativen
Noch nicht erfasst.
Auf einen Blick
- Anbieter
- Val Town
- Status
- Offizieller Server
- Betriebsart
- Remote
- Aktuelle Version
- Noch nicht erfasst.
- GitHub-Sterne
- 10
- Zuletzt geprüft
- 08.09.2026
Repository und Dokumentation
Kategorien
Unterstützte Clients
Passende Ratgeber
Anleitungen und Hintergrund, die zu diesem Eintrag passen.