pdauth — 面向 AI Agent 的动态 OAuth 授权方案

使用 pdauth 为自己（即 Agent）授予对 2500+ 个 API 的 OAuth 访问权限。整体流程如下：

1. Agent 需要访问某个应用（如 Spotify、Slack、Notion 等）
2. 通过 pdauth connect 生成 OAuth 授权链接
3. 将该链接分享给用户 → 用户点击并完成授权
4. Agent 即可通过 pdauth call 调用对应工具

快速参考

# 配置（一次性设置）
pdauth config

# 搜索应用
pdauth apps --search spotify

# 生成 OAuth 授权链接
pdauth connect spotify --user USER_ID

# 查看当前已连接的应用
pdauth status --user USER_ID

# 列出指定应用支持的工具
pdauth tools spotify --user USER_ID

# 调用工具
pdauth call spotify.get_my_playlists --user USER_ID
pdauth call slack.send_message channel=general text="Hello!"

OAuth 授权流程（如何请求访问权限）

当您需要访问用户尚未授权的应用时，请执行以下步骤：

1. 运行：pdauth connect  --user 
2. 从命令输出中获取 OAuth 授权链接
3. 将链接发送给用户：“为完成此操作，我需要访问 。请单击此处进行授权：”
4. 用户点击链接，并通过 Pipedream 完成授权
5. 使用 pdauth status --user  确认授权状态
6. 此后即可调用相关工具！

用户 ID 策略

为每位用户使用一致的标识符：

• Telegram： telegram:5439689035
• 邮箱： pedro@example.com
• 自定义 ID： pedro-mainframe

跨会话使用相同的 user ID 可持续维护该用户的已连接账户。

调用工具

# 格式：pdauth call . [key=value ...]

# 简单参数形式
pdauth call slack.send_message channel=general text="Hello"

# 使用 JSON 参数传递复杂数据
pdauth call notion.create_page --args '{"title": "My Page", "content": "..."}'

# 获取 JSON 格式输出，便于程序化解析
pdauth call spotify.get_my_playlists --json

检查授权状态

# 查看某位用户已连接的应用
pdauth status --user pedro

# 查看所有用户的状态
pdauth status --all

# 输出 JSON 格式，适用于脚本集成
pdauth status --user pedro --json

常用应用列表

完整应用目录请访问：https://mcp.pipedream.com

错误处理

“App not connected”（应用未连接） → 使用 pdauth connect 生成授权链接，并引导用户完成授权

“Tool not found”（工具未找到） → 使用 pdauth tools 查看该应用支持的全部工具列表

“Invalid credentials”（凭据无效） → 运行 pdauth config 配置 Pipedream 凭据

使用提示

1. 调用工具前务必先检查状态：始终优先运行 pdauth status 确认连接就绪
2. 坚持使用一致的 user ID：确保用户授权关系在不同会话间持久有效
3. 优先采用 JSON 输出格式（--json）：更利于程序自动解析返回结果
4. 注意 OAuth 链接有效期：授权链接 4 小时后过期，按需重新生成

示例工作流

用户：“把《Bohemian Rhapsody》加入我的 Spotify 歌单”

Agent：
1. pdauth status --user telegram:5439689035 --json
   → 返回结果显示未连接 Spotify

2. pdauth connect spotify --user telegram:5439689035
   → 获取 OAuth 授权链接

3. 向用户发送消息：“我需要访问你的 Spotify 账户。请点击此处授权：”

4. 用户点击并完成授权

5. pdauth status --user telegram:5439689035
   → 返回结果显示 Spotify ✓ 已连接

6. pdauth call spotify.search_tracks query="Bohemian Rhapsody" --json
   → 获取目标音轨 ID

7. pdauth call spotify.add_to_playlist playlist_id=... track_id=...
   → 操作成功！

8. 回复用户：“已将《Bohemian Rhapsody》添加至你的歌单！🎵”