PhotoShelter MCP Server and API by Cotlet

Name: PhotoShelter MCP Server and API by Cotlet
Author: cotlet.dev

远程服务

cotlet.dev文件与存储02 天前更新

代码仓库访问官网

关于 PhotoShelter MCP Server and API by Cotlet

Cotlet.dev 的 PhotoShelter MCP 服务让 AI Agent 在已登录的 PhotoShelter 账户中管理图片和图库，适用于摄影师及团队。可使用托管连接，也可通过本地 stdio 服务转发调用。

主要功能

01创建并分享图库
02查找和整理照片
03为图片添加关键词
04查看图库活动
05支持托管和本地 stdio

适用场景

01用近期上传的照片创建图库
02将带标签的照片移入合集
03查找近期未浏览的图库
04为选定图片添加关键词

MCP 相关

通过 Cotlet.dev 托管端点向 MCP 客户端提供 PhotoShelter 工具。也可使用本地 stdio 服务，将工具调用转发至托管服务。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://cotlet.dev/mcp/v1/photoshelter/connect

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http dev-cotlet-photoshelter https://cotlet.dev/mcp/v1/photoshelter/connect

Cursor.cursor/mcp.json{"mcpServers":{"dev-cotlet-photoshelter":{"type":"http","url":"https://cotlet.dev/mcp/v1/photoshelter/connect"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"dev-cotlet-photoshelter":{"type":"http","url":"https://cotlet.dev/mcp/v1/photoshelter/connect"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"dev-cotlet-photoshelter":{"type":"http","url":"https://cotlet.dev/mcp/v1/photoshelter/connect"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"dev-cotlet-photoshelter":{"serverUrl":"https://cotlet.dev/mcp/v1/photoshelter/connect"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://cotlet.dev/mcp/v1/photoshelter/connect

Streamable HTTPhttps://cotlet.dev/mcp/v1/photoshelter需要授权

工具

详细介绍

如何将 PhotoShelter 连接到 Claude Code、ChatGPT 和任何 AI Agent

没错，Claude、ChatGPT 和其他 AI Agent 都能在你的 PhotoShelter 账户中工作。 PhotoShelter 内置了 AI 助手，但目前没有确认 PhotoShelter 官方推出了 ChatGPT 应用或 Claude 连接器。Cotlet.dev 会将你已登录的 PhotoShelter 账户连接到任何 AI Agent，让你用日常语言发出请求，再由 AI 帮你查找、添加标签、整理和分享照片。

你可以这样请求

从我周六上传的 240 张照片中创建一个名为“Smith Wedding 2026”的图库，并分享给 [email protected]。

找出 10 月所有标记了“product launch”的照片，并将它们移到“Marketing 2026”收藏集中。

哪些图库在过去 30 天内没有被查看过？请列出它们及其创建日期。

给我昨天上传的 18 张图片添加“headshot”和“Chicago office”关键词。

将“Spring Campaign”图库设为私密，并把下载链接通过电子邮件发给代理公司的 Tom。

2 分钟内完成连接

前往 https://cotlet.dev/app 获取 API 密钥，并将其导出为 COTLET_API_KEY。

Claude Code

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT

前往 Settings → Apps → 添加连接器 URL https://cotlet.dev/mcp/v1，然后使用 Cotlet.dev 登录。无需 API 密钥。

Cursor

将此仓库中的 .cursor/mcp.json 复制到你的项目中：

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

在本地运行（stdio）

此仓库是一个真正的 MCP 服务。它通过 stdio 使用 MCP 协议，无需密钥即可列出 PhotoShelter 工具，并将每次工具调用转发到托管的 Cotlet.dev 服务。建议使用上方的托管 URL。如果你的客户端只能启动本地服务，请使用此方式。

{"mcpServers":{"photoshelter":{"command":"uvx","args":["photoshelter-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}

也可以使用 Docker：

docker build -t photoshelter-mcp .
docker run -i --rm -e COTLET_API_KEY photoshelter-mcp

工具：photoshelter_guide、photoshelter_status、photoshelter_open、photoshelter_read、photoshelter_click、photoshelter_type、photoshelter_close。如果没有设置 COTLET_API_KEY，工具调用会返回：“Set COTLET_API_KEY. Get a key at https://cotlet.dev/app”。

命令行

需要 Python 3.10+，无需安装其他内容。通过 PyPI 安装：

pip install photoshelter-mcp        # or run it once: uvx photoshelter-mcp connect
photoshelter-mcp connect

或者直接从此仓库安装：

export COTLET_API_KEY="your-key"
python3 photoshelter_agent.py connect   # ready config for Claude Code, Cursor, ChatGPT
python3 photoshelter_agent.py status    # is PhotoShelter ready in your Cotlet.dev account
python3 photoshelter_agent.py guide     # PhotoShelter screens and sign-in link
python3 photoshelter_agent.py read      # open PhotoShelter, read the page, close the browser
python3 photoshelter_agent.py tools     # list Cotlet.dev tools
python3 photoshelter_agent.py serve     # start the stdio MCP server (same as no argument)

PhotoShelter 用户常见问题

PhotoShelter 有可供 AI 使用的 API 吗？

PhotoShelter 提供 API 文档，但只有联系 PhotoShelter 支持才能获取密钥。Cotlet.dev 则直接在你已登录的 PhotoShelter 账户中工作，因此你的 AI Agent 无需密钥即可创建图库、为图片添加说明并分享图片。

如何将 PhotoShelter 连接到 ChatGPT？

在 ChatGPT 中添加 Cotlet.dev 应用（Settings → Apps，连接器 URL 为 https://cotlet.dev/mcp/v1），在 Cotlet.dev Cloud Browser 中登录一次 PhotoShelter，然后用日常语言向 ChatGPT 发出请求。无需编写代码，也无需 PhotoShelter API 密钥。

可以在 PhotoShelter 中使用 Claude 吗？

可以。在 Claude Code 中运行上方的一行 claude mcp add 命令；在 Claude 应用中，将 https://cotlet.dev/mcp/v1 添加为自定义连接器。之后，Claude 就能在你自己的 PhotoShelter 账户中工作。

有 PhotoShelter MCP 服务吗？

PhotoShelter 没有官方 MCP 服务，也没有官方的 ChatGPT 或 Claude 应用（截至 2026 年 11 月核实）。Cotlet.dev 是托管的 PhotoShelter MCP 服务，可在你自己的账户中与 Claude、ChatGPT、Cursor、Codex、n8n、Make 和 Zapier 配合使用。

PhotoShelter 的 AI 助手和连接 ChatGPT 或 Claude 是一回事吗？

不是。PhotoShelter 内置的 AI 助手在 PhotoShelter 内部工作。Cotlet.dev 则让你已经在使用的 AI Agent（例如 Claude 或 ChatGPT）在你的 PhotoShelter 账户中工作。