Shape MCP server
2026년 11월 11일 커밋OAuth 인증을 통해 AI 클라이언트가 공유 Shape 워크스페이스 내의 파일을 찾고, 읽고, 저장하고, 정리할 수 있도록 합니다.
다른 이름 shapefs/shape-plugin, shape-plugin
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.0
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
Shape MCP란?
Shape은(는) MCP server입니다. 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 인증 방식을 사용합니다.
에이전트는 사용자가 허용한 권한에 따라 여러 가지 작업을 수행할 수 있습니다. 폴더를 탐색하고 이미지를 검사하여 파일을 읽을 수 있으며, 텍스트를 작성하거나 파일을 업로드하여 기여할 수 있고, 항목의 이름을 변경하거나 태그를 지정하여 워크스페이스를 정리할 수 있습니다. 또한 서버를 통해 항목을 복구 가능한 휴지통으로 이동할 수 있습니다. 에이전트는 결제나 워크스페이스 멤버를 관리할 수 없으므로, 파일 조작과 관리 제어 사이에 명확한 경계를 유지합니다. 파일에 가해진 모든 변경 사항은 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Shape를 AI 클라이언트에 어떻게 연결하나요?
연결 방법은 클라이언트마다 다릅니다. 예를 들어 Claude 사용자는 Shape 커넥터를 추가하고, Grok 사용자는 호스팅된 MCP URL을 입력한 뒤 OAuth를 통해 인증합니다.
AI 에이전트가 제 파일을 영구적으로 삭제할 수 있나요?
아니요, 에이전트는 파일을 영구적으로 삭제할 수 없습니다. 항목을 복구 가능한 휴지통으로 이동할 수만 있습니다.
API 키가 필요한가요?
아니요, 연결 시 로그인 및 워크스페이스 선택을 위해 OAuth 인증을 사용합니다.