在 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 密钥相同,也就是积分价格、限额和安全规则都一样,不会更多。
- 在应用中填入上面的服务器地址,并选择登录(OAuth)方式。应用会自行向 Pickshot 注册。
- 浏览器会打开一个 Pickshot 页面,写明应用的名称和它返回的地址。请两者都核对:名称是应用自己取的。
- 点击“允许”,或点击“拒绝”。允许之前不会连接任何内容。
- 要结束时,在 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 页面的用量标签页统计每一次调用和运行。