跳到正文
登录免费开始

在 AI 助手里使用 Pickshot(MCP)

通过 Pickshot 的 MCP 服务器,AI 助手可以在你的账号里生成图片、视频和声音、运行照片应用并保存你的角色。它可以使用开发者页面的 API 密钥连接,只提供登录连接的应用则使用 Pickshot 登录连接。每次生成都会消耗积分,付费调用必须带价格上限。

你需要准备

  • 有积分的 Pickshot 账号。
  • API 密钥(在 API 页面创建并保密),或者提供登录(OAuth)连接的应用。
  • 使用 API 密钥时,需要能发送请求头的 MCP 客户端。下面的设置涵盖四种。

服务器

一个地址,基于 HTTP 的标准 MCP。你这边不需要安装任何东西。

服务器地址https://pickshot.ai/mcp
传输方式Streamable HTTP(无状态,JSON 响应)
认证Authorization: Bearer <你的 API 密钥>,或下面的登录(OAuth)连接

用 API 密钥设置

把 YOUR_PICKSHOT_API_KEY 换成你的密钥。应用允许的话,请放在环境变量或密钥存储里,不要写进会共享的文件。

Claude Code

在终端里运行一次:

claude mcp add --transport http pickshot https://pickshot.ai/mcp \
  --header "Authorization: Bearer YOUR_PICKSHOT_API_KEY"

Cursor

把服务器加到 ~/.cursor/mcp.json(所有项目)或 .cursor/mcp.json(单个项目):

{
  "mcpServers": {
    "pickshot": {
      "url": "https://pickshot.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PICKSHOT_API_KEY"
      }
    }
  }
}

VS Code

加到项目里的 .vscode/mcp.json:

{
  "servers": {
    "pickshot": {
      "type": "http",
      "url": "https://pickshot.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PICKSHOT_API_KEY"
      }
    }
  }
}

Claude Desktop(通过桥接程序)

像 Claude Desktop 这样只能在设置文件里运行本地程序的应用,需要一个添加请求头的桥接程序。这个例子用的是开源的 mcp-remote 包,不是 Pickshot 做的:

{
  "mcpServers": {
    "pickshot": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://pickshot.ai/mcp",
        "--header",
        "Authorization:${PICKSHOT_AUTH}"
      ],
      "env": {
        "PICKSHOT_AUTH": "Bearer YOUR_PICKSHOT_API_KEY"
      }
    }
  }
}

其他客户端

给它服务器地址,以及由 Bearer、一个空格和你的密钥组成的 Authorization 请求头。只提供登录(OAuth)连接的客户端可以改用上面的登录连接。

检查连接

在终端里运行,应该会返回工具列表:

curl https://pickshot.ai/mcp \
  -H "Authorization: Bearer $PICKSHOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

通过登录(OAuth)连接

有些助手无法发送 API 密钥,只提供登录连接。Pickshot 也支持这种方式:你在浏览器中登录 Pickshot 并点击“允许”,应用就会获得一个有效期很短的令牌。它以你的身份行事,权限与 API 密钥相同,也就是积分价格、限额和安全规则都一样,不会更多。

  1. 在应用中填入上面的服务器地址,并选择登录(OAuth)方式。应用会自行向 Pickshot 注册。
  2. 浏览器会打开一个 Pickshot 页面,写明应用的名称和它返回的地址。请两者都核对:名称是应用自己取的。
  3. 点击“允许”,或点击“拒绝”。允许之前不会连接任何内容。
  4. 要结束时,在 API 页面的“已连接的应用”中断开该应用,它会立即停止。

ChatGPT

在 ChatGPT 中,使用开发者模式把 Pickshot 添加为自定义连接器(应用),填入服务器地址并选择 OAuth。ChatGPT 会自行注册并带你到 Pickshot 允许。菜单名称可能会变,请同时查看 ChatGPT 自己的帮助。

Claude

在 Claude(claude.ai、Claude Desktop 和移动应用)中,用服务器地址添加自定义连接器,并把可选的 OAuth 客户端 ID 和密钥留空。Claude 会自行注册并带你到 Pickshot 允许。

Claude Code

在 Claude Code 中,不带请求头添加服务器,然后在 Claude Code 里运行 /mcp,并按浏览器中的步骤操作:

claude mcp add --transport http pickshot https://pickshot.ai/mcp

其他遵循 MCP 授权规范(使用 PKCE S256 的 OAuth 2.1、动态客户端注册和 resource 参数)的 MCP 客户端也可以用同样的方式连接。Pickshot 没有测试过所有客户端;如果连接不上,请改用 API 密钥。

工具

助手能看到这些工具。只读取信息的工具不花积分。生成内容的工具需要价格上限和固定的密钥。

get_balance你的积分余额和安全设置。
confirm_adult为兼容保留的工具。自 2026 年 11 月 12 日起所有账号均为第 2 级,无需确认(返回 not_available)。
list_models你的账号可用的模型,以及方式、限制和价格。
estimate_cost请求的准确价格,绝不扣费。
create_image在你设的上限内生成图片或编辑。
create_video生成视频并返回任务。
create_audio生成语音、音乐或音效并返回任务。
get_job你发起的任务的状态和结果。
list_apps照片应用、它们的输入项和价格。
run_app用你提供链接的图片,在上限内运行照片应用。
list_characters你保存的角色及其参考图。
create_character用你的图片保存角色,只有在你同意时才执行。
delete_character删除一个已保存的角色。
get_usage这个密钥和账号实际用了多少。

花多少由你决定

  • 每次生成都消耗积分,网站上免费的模型也一样。用密钥没有免费体验。
  • 付费调用需要 max_credits。助手会先询价,价格更高时会在扣费之前被拒绝。
  • 每次付费调用都带固定的密钥,超时后重发也不会重复扣费,而是返回第一次的结果。
  • 为每个应用单独创建一个密钥,可以随时在 API 页面作废。通过登录连接的应用同样在“已连接的应用”中断开。用量标签页会显示每个密钥做了什么。

目前还做不到的事

  • 登录连接:应用通过动态客户端注册来注册(暂不支持 Client ID Metadata Document),返回地址必须是 https 或 localhost,连续 30 天无人使用的连接会结束。每位会员同时最多可保持 3 个应用处于连接状态;要连接其他应用,请先在 API 页面的“已连接的应用”中断开一个。
  • 结果只在你的账号里可见。分享请自己来。

常见问题

MCP 要额外收费吗?

没有额外费用。只读取信息的工具免费,生成内容按 API 价格消耗积分。

哪些助手可以用?

使用 API 密钥时,任何支持通过 HTTP 连接远程服务器、并允许设置请求头的 MCP 客户端都可以。上面的设置涵盖 Claude Code、Cursor、VS Code,以及通过桥接程序的 Claude Desktop。使用登录连接时,可以用 ChatGPT 和 Claude(包括 Claude Code),它们的连接器使用带动态客户端注册的 OAuth,Pickshot 提供这种方式。其他遵循 MCP 授权规范的客户端也可能可用,但 Pickshot 没有全部测试过。

助手能不问就花钱吗?

它只能花它自己设定的 max_credits 范围内的钱,所以请先告诉它你的预算。真正的限制是你账号里的积分,以及可以随时作废的密钥。使用技能后,助手在花钱之前一定会先询问。

在哪里看生成了什么?

图片会出现在你的图库里,并标记为通过 API 生成。API 页面的用量标签页统计每一次调用和运行。