MCP

SnapAny 提供托管 MCP server（Model Context Protocol，Streamable HTTP）。配好之后，你在 Claude Code、Codex、Cursor 里直接说「帮我提取这个链接里的视频和图片」，AI 就会调用 SnapAny——不需要写代码。与 REST API 使用同一个 key、同一套计费。

端点：https://api.snapany.com/mcp

开始之前

配置前你需要一个 API key，两步：

到 API Keys 创建一个 key，再到控制台领取 50 个免费积分
记下这个 key，形如 sk_snapany_ 开头的一长串

下面所有配置里的 sk_snapany_xxx 都是占位符，必须换成你自己的真实 key。直接复制粘贴不会报错，但之后每次调用都会失败。

key 的轮换与权限说明见鉴权。

Claude Code

claude mcp add --transport http snapany https://api.snapany.com/mcp \
  --header "Authorization: Bearer sk_snapany_xxx"

默认只在执行命令的那个目录生效。想让所有项目都能用，加 -s user。

Codex

# ~/.codex/config.toml
[mcp_servers.snapany]
url = "https://api.snapany.com/mcp"
http_headers = { "Authorization" = "Bearer sk_snapany_xxx" }

~ 指你的用户主目录；文件不存在就自己新建。改完需要重启 Codex。

通用 JSON 配置（Cursor 等）

Cursor 写进 ~/.cursor/mcp.json（全局生效）或项目根目录的 .cursor/mcp.json（仅该项目）。其他客户端参考各自文档的 MCP 配置文件位置。

{
  "mcpServers": {
    "snapany": {
      "url": "https://api.snapany.com/mcp",
      "headers": { "Authorization": "Bearer sk_snapany_xxx" }
    }
  }
}

改完需要重启客户端。

确认连上了

Claude Code 在终端执行：

claude mcp list

看到 snapany 且状态为已连接即成功，也可以在会话里输入 /mcp 查看。其他客户端一般在设置的 MCP 面板里能看到这个 server——列出下面 5 个工具就说明通了。

可用工具

工具	作用
`extract_post`	提取单个帖子的媒体/元数据（1 积分）
`extract_playlist`	提取播放列表/频道一页（2 积分）
`transcribe`	提交转录任务（4 积分/分钟，预扣）
`get_transcription`	轮询转录结果（免费）
`get_docs`	在 Agent 内直接读本文档（免费）

两个提取工具返回的是媒体的直链与元数据，不是文件本身。要真正存到本地，让你的 Agent 拿到链接后再下载一次即可——多数客户端可以直接做到。

积分

新开发者可在控制台领取 50 个免费积分，永久有效、不过期。余额与充值也在那里，逐笔用量在用量。

积分不足时工具会返回 Insufficient credits。完整计费规则见积分与计费。

连不上怎么办

现象	多半是
连接失败 / 401	`sk_snapany_xxx` 没换成真实 key，或漏了 `Bearer` 前缀（`Bearer` 后有一个空格）
配置改了但工具没出现	没重启客户端
429 `RATE_LIMITED`	触发限流（与 REST API 共用配额，1200 次/分钟）

下一步

鉴权 — API key 的创建与轮换
积分与计费 — 计费模型与充值
API 参考 — 完整端点文档（可在线调试）

试试对你的 Agent 说："提取这个 YouTube 视频并带说话人标签转录音频：https://..."