Shape MCPサーバー
コミット 2026年11月11日OAuth認証を使用して、AIクライアントが共有Shapeワークスペース内のファイルを検索、読み取り、保存、整理できるようにします。
別名 shapefs/shape-plugin, shape-plugin
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.0.0
- 最終コミット
- 2026年11月11日
- ライセンス
- MIT
Shape MCPとは
ShapeはMCPサーバーです。 OAuth認証を使用して、AIクライアントが共有Shapeワークスペース内のファイルを検索、読み取り、保存、整理できるようにします。.
プロジェクトのREADMEから生成された概要
Shape MCP server について
Shapeは、小規模なチームとそのAIエージェントがアセットを共同作業するために設計された、共有ファイルワークスペースを提供します。このMCP serverは、streamable HTTPを介してshapefs.app/mcpにあるホストされたエンドポイントに接続します。ユーザーは、Claude、ChatGPT、Cursor、GitHub Copilot CLIなどのさまざまなAIクライアントを通じてファイルとやり取りできます。APIキーを使用する代わりに、システムはOAuth認証を利用します。ブラウザウィンドウが開き、ワークスペースの選択と特定のAgent Skillsの権限承認を行います。
エージェントは、許可された機能に応じて、いくつかの異なるアクションを実行できます。フォルダの閲覧や画像の確認によるファイルの読み取り、テキストの書き込みやファイルのアップロードによるコンテンツの追加、そして項目の名前変更やタグ付けによるワークスペースの整理が可能です。また、サーバーはアイテムを復元可能なゴミ箱に移動させることも許可します。エージェントは請求管理やワークスペースメンバーの管理を行うことはできないため、ファイルの操作と管理権限の間には明確な境界が保たれています。ファイルに加えられたすべての変更は、Shapeワークスペース内で自動的に新しいバージョンとして作成されます。
できること
- 1ブランドガイドラインの要約エージェントに特定のブランドドキュメントを探させ、ライティングルールの要約を作成させます。
- 2ビジュアルアセットの確認特定のキャンペーンフォルダに含まれるすべての画像ファイルを表示するよう依頼します。
- 3エージェントの出力結果を保存AIにキャンペーンブリーフを作成させ、指定したフォルダに直接保存するよう指示します。
- 4ワークスペースファイルの整理エージェントにドラフトファイルの名前を変更させ、整理しやすいように特定のキャンペーンタグを付与させます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Shape MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにShape MCPをインストール
$ claude mcp add --transport http shape-plugin https://shapefs.app/mcpCursorにShape MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"shape-plugin": {
"url": "https://shapefs.app/mcp"
}
}
}VS CodeにShape MCPをインストール
.vscode/mcp.json
{
"servers": {
"shape-plugin": {
"type": "http",
"url": "https://shapefs.app/mcp"
}
}
}VS Code CLIにShape MCPをインストール
$ code --add-mcp '{"name":"shape-plugin","type":"http","url":"https://shapefs.app/mcp"}'CodexにShape MCPをインストール
$ codex mcp add shape-plugin --url https://shapefs.app/mcpCodex config.tomlにShape MCPをインストール
~/.codex/config.toml
[mcp_servers.shape-plugin] url = "https://shapefs.app/mcp"
Gemini CLIにShape MCPをインストール
$ gemini mcp add -s user --transport http shape-plugin https://shapefs.app/mcpGemini settings.jsonにShape MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"shape-plugin": {
"url": "https://shapefs.app/mcp",
"type": "http"
}
}
}自動チェック
実行日 2026年11月15日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能shapefs/shape-plugin is public and reachablegithub.com/shapefs/shape-plugin ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-11github.com/shapefs/shape-plugin ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答HTTPS endpoint answered 401 (sign-in required)合格
README
GitHubで見る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 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のよくある質問
Shape MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http shape-plugin https://shapefs.app/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Shape MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
ShapeをAIクライアントに接続するにはどうすればよいですか?
接続方法はクライアントによって異なります。例えば、ClaudeユーザーはShapeコネクタを追加し、GrokユーザーはホストされたMCP URLを入力してOAuth経由で認証を行います。
AIエージェントがファイルを永久に削除することはありますか?
いいえ、エージェントはファイルを永久に削除することはできません。エージェントができるのは項目をゴミ箱に移動することだけであり、ゴミ箱に入ったファイルは復元可能です。
APIキーは必要ですか?
いいえ、接続にはサインインとワークスペース選択のためのOAuth認証を使用します。