Serveur MCP Shape
Commit 11 nov. 2026Permet à un client IA de rechercher, lire, sauvegarder et organiser des fichiers au sein d'un espace de travail Shape partagé via une authentification OAuth.
Aussi connu sous shapefs/shape-plugin, shape-plugin
- Étoiles
- 0
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 1.0.0
- Dernier commit
- 11 nov. 2026
- Licence
- MIT
Qu'est-ce que Shape MCP ?
Shape est un serveur MCP. Permet à un client IA de rechercher, lire, sauvegarder et organiser des fichiers au sein d'un espace de travail Shape partagé via une authentification OAuth.
Résumé généré à partir du README du projet
À propos du MCP server Shape
Shape propose un espace de travail de fichiers partagé conçu pour permettre aux petites équipes et à leurs agents IA de collaborer sur des ressources. Ce MCP server se connecte à un endpoint hébergé sur shapefs.app/mcp via streamable HTTP. Les utilisateurs interagissent avec leurs fichiers via divers clients IA, notamment Claude, ChatGPT, Cursor et GitHub Copilot CLI. Au lieu d'utiliser des clés API, le système s'appuie sur l'authentification OAuth, où une fenêtre de navigateur s'ouvre pour vous permettre de sélectionner un espace de travail et d'approuver les permissions spécifiques de l'agent.
Les agents peuvent effectuer plusieurs actions distinctes selon les capacités que vous autorisez. Ils peuvent lire des fichiers en parcourant les dossiers et en inspectant des images, contribuer en écrivant du texte ou en téléchargeant des fichiers, et organiser l'espace de travail en renommant ou en étiquetant des éléments. Le serveur permet également de déplacer des éléments vers une corbeille récupérable. Comme les agents ne peuvent pas gérer la facturation ou les membres de l'espace de travail, le système maintient des limites claires entre la manipulation de fichiers et le contrôle administratif. Toutes les modifications apportées aux fichiers créent automatiquement de nouvelles versions au sein de votre espace de travail Shape.
Ce que vous pouvez faire avec
- 1Résumer des chartes graphiquesDemandez à l'agent de localiser une documentation de marque spécifique et de fournir un résumé des règles rédactionnelles.
- 2Inspecter des ressources visuellesDemandez une vue de tous les fichiers images contenus dans un dossier de campagne spécifique.
- 3Sauvegarder les résultats de l'agentDonnez instruction à l'IA d'écrire un brief de campagne et de l'enregistrer directement dans un dossier désigné.
- 4Organiser les fichiers de l'espace de travailDemandez à l'agent de renommer un fichier de brouillon et d'appliquer un tag de campagne spécifique pour une meilleure organisation.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Shape MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Shape MCP dans Claude Code
$ claude mcp add --transport http shape-plugin https://shapefs.app/mcpInstaller Shape MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"shape-plugin": {
"url": "https://shapefs.app/mcp"
}
}
}Installer Shape MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"shape-plugin": {
"type": "http",
"url": "https://shapefs.app/mcp"
}
}
}Installer Shape MCP dans VS Code CLI
$ code --add-mcp '{"name":"shape-plugin","type":"http","url":"https://shapefs.app/mcp"}'Installer Shape MCP dans Codex
$ codex mcp add shape-plugin --url https://shapefs.app/mcpInstaller Shape MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.shape-plugin] url = "https://shapefs.app/mcp"
Installer Shape MCP dans Gemini CLI
$ gemini mcp add -s user --transport http shape-plugin https://shapefs.app/mcpInstaller Shape MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"shape-plugin": {
"url": "https://shapefs.app/mcp",
"type": "http"
}
}
}Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibleshapefs/shape-plugin is public and reachablegithub.com/shapefs/shape-plugin ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-11github.com/shapefs/shape-plugin ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPHTTPS endpoint answered 401 (sign-in required)Réussi
README
Voir sur GitHubShape
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.
Questions sur Shape MCP
Comment ajouter Shape MCP à Claude Code ?
Exécutez claude mcp add --transport http shape-plugin https://shapefs.app/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Shape MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Comment connecter Shape à mon client IA ?
Les méthodes de connexion varient selon le client ; par exemple, les utilisateurs de Claude ajoutent le connecteur Shape, tandis que les utilisateurs de Grok saisissent l'URL du MCP hébergé et s'authentifient via OAuth.
Un agent IA peut-il supprimer définitivement mes fichiers ?
Non, les agents ne peuvent pas supprimer définitivement les fichiers ; ils peuvent seulement déplacer des éléments vers la corbeille, ce qui permet leur récupération.
Cela nécessite-t-il une clé API ?
Non, la connexion utilise OAuth pour la connexion et la sélection de l'espace de travail.