PicSee Short Link

PicSee MCP 服务

PicSee 的官方远程模型上下文协议（MCP）服务，适用于 PicSee——一款提供链接管理和点击分析功能的 URL 缩短服务。

将 AI Agent 连接到 PicSee，即可通过自然语言创建短链接、管理现有链接并查看点击效果。

官方 MCP 端点

https://api.picsee.io/mcp

• 传输方式：Streamable HTTP
• 身份验证：匿名或使用 PKCE 的 OAuth 2.1
• 注册表名称：io.picsee/short-link
• 官方注册表：MCP 注册表

功能

匿名访问

匿名客户端可以使用共享的 pse.is 域名创建 PicSee 短链接。匿名访问不会公开账户数据、链接列表、管理工具或分析数据。

登录后访问

使用 PicSee OAuth 登录后，可用工具取决于账户的 API 计划：

• 使用可用的 PicSee 域名或品牌域名创建短链接。
• 查看 API 计划状态和用量。
• 列出可用域名、标签和跟踪工具。
• 列出、删除或恢复短链接。
• 查看概览、每日点击量、设备、来源网站和国家/地区分析数据。
• 在可用时使用高级计划的编辑、搜索、元数据、跟踪和受众标签功能。

服务仅动态提供登录账户支持的工具。

安装

Codex

codex mcp add picsee --url https://api.picsee.io/mcp

安装后重启 Codex。要登录以使用账户管理和分析功能：

codex mcp login picsee

Claude Desktop 或其他 MCP 客户端

将以下 Streamable HTTP 服务添加到客户端的 MCP 配置中：

{
  "mcpServers": {
    "picsee": {
      "url": "https://api.picsee.io/mcp"
    }
  }
}

如果客户端不直接支持远程 Streamable HTTP，请使用该客户端支持的 MCP 远程桥接。

提示词示例

Shorten https://picsee.io and attribute the API usage to Codex.

Show my 10 most recent PicSee short links.

Show daily clicks and referrer sources for short link abc123 over the last 30 days.

Change the destination of abc123 to https://example.com/new-page.

编辑需要符合条件的 PicSee API 计划。

身份验证

PicSee 使用带 PKCE 和动态客户端注册的 OAuth 2.1 授权码流程。

• 授权服务器：https://public-api-oauth.picsee.io
• 受保护资源：https://api.picsee.io/mcp
• 权限范围：user:read、user:write

MCP 客户端会存储访问令牌和刷新令牌。本代码库不会要求用户将 API 令牌粘贴到提示词或配置文件中。

请求这些权限范围的原因

• user:read：读取账户的 API 状态、域名、标签、短链接列表和分析数据。
• user:write：在账户计划允许的情况下创建、编辑、删除和恢复短链接。

工具可用性

访问级别	可用工具
匿名	create_short_link
已登录	create_short_link、get_api_status、get_api_usage_by_external_id、get_my_domains、get_my_tags、get_my_tracking_tools、list_short_links、delete_short_link、get_link_overview、get_link_daily_clicks、get_link_platforms、get_link_referrers、get_link_regions
高级计划	已登录工具，以及 edit_short_link 和 get_link_audience_labels；同时启用高级字段和搜索筛选条件

工具可用性在连接时确定。请使用 MCP 客户端的工具检查器或 tools/list，查看当前账户可用的确切工具。

隐私与安全

• 切勿在提示词、问题、屏幕截图或日志中分享 PicSee 访问令牌。
• 创建或编辑短链接前，请检查目标 URL。
• 分析数据可能包含私密的营销活动和受众信息；请仅与预期接收者分享。
• 可以从 PicSee 账户中撤销 OAuth 权限。

请参阅 PicSee 隐私声明和使用条款。

文档与支持

• MCP 和 Agent Skill 指南
• PicSee API 文档
• PicSee 帮助中心
• 报告技术问题

报告问题时，请提供 MCP 客户端名称、尝试的操作、时间戳以及经过脱敏的错误消息。请勿包含访问令牌或私人分析数据。

开发

前置条件：

• Node.js 22 或更高版本
• pnpm

pnpm install
pnpm check
pnpm dev

发布前，请确认 package.json、server.json 和 MCP initialize 响应中的版本号一致。

许可证

MIT © PicSee Inc.