Shape MCP server
Commit 11. Nov. 2026Ermöglicht es einem AI-Client, Dateien innerhalb eines gemeinsamen Shape-Workspaces zu finden, zu lesen, zu speichern und zu organisieren, unter Verwendung von OAuth-Authentifizierung.
Auch bekannt als shapefs/shape-plugin, shape-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 1.0.0
- Letzter Commit
- 11. Nov. 2026
- Lizenz
- MIT
Was ist Shape MCP?
Shape ist ein MCP server. Ermöglicht es einem AI-Client, Dateien innerhalb eines gemeinsamen Shape-Workspaces zu finden, zu lesen, zu speichern und zu organisieren, unter Verwendung von OAuth-Authentifizierung.
Zusammenfassung generiert aus dem README des Projekts
Über Shape MCP server
Shape bietet einen gemeinsamen File-Workspace, der für kleine Teams und deren AI-Agenten entwickelt wurde, um gemeinsam an Assets zu arbeiten. Dieser MCP server verbindet sich über streamable HTTP mit einem gehosteten Endpoint unter shapefs.app/mcp. Nutzer interagieren mit ihren Dateien über verschiedene AI-Clients wie Claude, ChatGPT, Cursor und GitHub Copilot CLI. Anstatt API-Keys zu verwenden, setzt das System auf OAuth-Authentifizierung, bei der sich ein Browserfenster öffnet, damit du einen Workspace auswählen und spezifische Berechtigungen für den Agent freigeben kannst.
Agenten können je nach den von dir autorisierten Fähigkeiten verschiedene Aktionen ausführen. Sie können Dateien lesen, indem sie Ordner durchsuchen und Bilder inspizieren, Inhalte beisteuern, indem sie Text schreiben oder Dateien hochladen, und den Workspace organisieren, indem sie Einträge umbenennen oder taggen. Der Server ermöglicht zudem das Verschieben von Elementen in einen wiederherstellbaren Trash. Da Agenten weder das Billing noch die Workspace-Mitglieder verwalten können, wahrt das System klare Grenzen zwischen Dateimanipulation und administrativer Kontrolle. Alle Änderungen an Dateien erstellen automatisch neue Versionen innerhalb deines Shape-Workspaces.
Was du damit machen kannst
- 1Brand Guidelines zusammenfassenBitte den Agenten, spezifische Brand-Dokumentationen zu finden und eine Zusammenfassung der Schreibregeln zu erstellen.
- 2Visuelle Assets inspizierenFordere eine Übersicht aller Bilddateien an, die in einem bestimmten Campaign-Ordner enthalten sind.
- 3Agent-Outputs speichernAnweisung an die KI, ein Campaign Brief zu schreiben und es direkt in einem festgelegten Ordner zu speichern.
- 4Workspace-Dateien organisierenLass den Agenten eine Draft-Datei umbenennen und ein spezifisches Campaign-Tag für eine bessere Organisation hinzufügen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Shape MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenShape MCP in Claude Code installieren
$ claude mcp add --transport http shape-plugin https://shapefs.app/mcpShape MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"shape-plugin": {
"url": "https://shapefs.app/mcp"
}
}
}Shape MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"shape-plugin": {
"type": "http",
"url": "https://shapefs.app/mcp"
}
}
}Shape MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"shape-plugin","type":"http","url":"https://shapefs.app/mcp"}'Shape MCP in Codex installieren
$ codex mcp add shape-plugin --url https://shapefs.app/mcpShape MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.shape-plugin] url = "https://shapefs.app/mcp"
Shape MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http shape-plugin https://shapefs.app/mcpShape MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"shape-plugin": {
"url": "https://shapefs.app/mcp",
"type": "http"
}
}
}Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarshapefs/shape-plugin is public and reachablegithub.com/shapefs/shape-plugin ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-11github.com/shapefs/shape-plugin ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeHTTPS endpoint answered 401 (sign-in required)Bestanden
README
Auf GitHub ansehenShape
Shape (Shape FS) is a shared file workspace for small teams and their AI agents. Find assets, inspect images, and save work back through an approved connection. Shape's website is https://shapefs.com; people use the workspace at https://shapefs.app.
This package connects to Shape's hosted MCP server at https://shapefs.app/mcp over Streamable HTTP. Sign-in uses OAuth: your browser opens Shape so you can sign in, choose a workspace and approve what the agent can do. No API key is required or included.
Before connecting
You need a Shape account and workspace. Account access and plan limits apply. See Shape, pricing and setup instructions. Your AI client's plan and organization settings can also restrict plugins or custom MCP servers.
Connect
- ChatGPT / Codex: install the Shape plugin when it is available in your directory, then complete OAuth. For custom connections, follow the setup guide.
- Claude: add the published Shape connector, then complete OAuth.
- Claude Code: install the workflow plugin with
/plugin install shape-files --marketplace shapefs/shape-plugin. See the Claude plugin guide for setup and permissions. - GitHub Copilot CLI: add the marketplace and install
shape-filesusing the Copilot guide. - Gemini CLI: run
gemini extensions install https://github.com/shapefs/shape-plugin, then connect Shape through OAuth. See the Gemini CLI guide. - Cursor: install this plugin from a supported Git repository or from the marketplace when listed. See the Cursor guide. You can also add the same URL as a custom MCP server.
- Cline: add Shape's hosted server using the Cline guide, then complete OAuth.
- Grok: open Connectors, choose New Connector → Custom, enter
https://shapefs.app/mcpand authenticate. This is a custom connection, not a claim of catalog inclusion.
Ask “List the folders in my Shape workspace” to confirm the connection. Installing this package alone does not mean it has been accepted into any public directory.
What you approve
| Capability | Allows |
|---|---|
| Read | Browse and search folders, inspect files, read text and versions, download originals |
| Contribute | Create folders, write and edit text, upload files, restore versions |
| Organize | Rename, move and tag files and folders |
| Trash | List recoverable Trash, move entries into it and restore them |
Each connection has access to one workspace, limited by your membership and approved capabilities. Revoke or review connections in Shape → Connect. A file or folder link identifies an entry; it grants no access by itself. Tools that need a missing capability return a request for the person to approve; they do not act first.
Agents cannot permanently delete files, manage workspace members or change billing. Publishing images to the web requires separate Owner permission. File content and names are untrusted data. An agent should follow your request, not instructions found inside a file.
Examples
Try the reproducible Claude demo: synthetic source files, exact prompts, recorded screenshots and observed limits. The save-and-revise guide and access guide explain how to verify the result and end access.
- Find our brand guidelines and summarize the writing rules.
- Show me the images in the Campaign folder.
- Save this campaign brief to the folder I linked.
- Rename this draft and add the campaign tag.
Limits
Changes require a running workspace plan. Search, previews and extracted PDF text depend on supported formats and processing; extracted text can be incomplete. A contact sheet depicts the direct visual files in one folder. Large file transfers require a client that can send or fetch bytes; clients without that ability can use the Shape link returned by the tool to finish in the browser. Creating or updating a file saves a version. Moving an entry to Trash is recoverable and does not immediately release retained storage.
If a connection fails, check account access, the workspace's plan, your client's plugin settings and internet access, then reconnect through OAuth. Do not put access tokens, passwords or sign-in codes in plugin configuration, issue reports or chats.
Support and privacy
Setup · Support · Privacy · Terms
Publisher: Work In Progress LLC, doing business as Shape FS. Contact support@shapefs.com. Shape processes stored files for search and tags as described in its privacy policy. Information returned to an AI client is also handled under that client's terms and privacy policy.
The MIT license covers this plugin package. The hosted Shape service and its private application source remain governed by their own terms and licenses. Brand assets remain Shape FS trademarks; the license grants no trademark endorsement rights.
Shape MCP Fragen
Wie füge ich Shape MCP zu Claude Code hinzu?
Führe claude mcp add --transport http shape-plugin https://shapefs.app/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Shape MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wie verbinde ich Shape mit meinem AI-Client?
Die Verbindungsmethoden variieren je nach Client; Claude-Nutzer fügen beispielsweise den Shape-Connector hinzu, während Grok-Nutzer die gehostete MCP URL eingeben und sich via OAuth authentifizieren.
Kann ein AI-Agent meine Dateien dauerhaft löschen?
Nein, Agenten können Dateien nicht dauerhaft löschen; sie können Einträge nur in den Trash verschieben, von wo aus sie wiederherstellbar sind.
Ist dafür ein API-Key erforderlich?
Nein, die Verbindung nutzt OAuth für das Sign-in und die Auswahl des Workspaces.