Shape

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 Shape as a custom remote connector using https://shapefs.app/mcp, then connect and complete OAuth. A directory listing is separate from this package.
• Cursor: install this plugin from a supported Git repository or from the marketplace when listed. Connect the Shape MCP server and complete OAuth. You can also add the same URL as a custom MCP server.
• Grok: open Connectors, choose New Connector → Custom, enter https://shapefs.app/mcp and 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

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, publish them, manage workspace members or change billing. 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: Shape FS. Contact [email protected]. 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.