# MCP

> 在 Claude Code、Codex 等 AI Agent 中使用 SnapAny

来源: https://platform.snapany.com/zh/docs/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，两步：

1. 到 [API Keys](https://platform.snapany.com/zh/console/keys) 创建一个 key，再到[控制台](https://platform.snapany.com/zh/console)**领取 50 个免费积分**
2. 记下这个 key，形如 `sk_snapany_` 开头的一长串

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

key 的轮换与权限说明见[鉴权](https://platform.snapany.com/zh/docs/authentication)。

## Claude Code

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

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

## Codex

```toml
# ~/.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 配置文件位置。

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

改完需要**重启客户端**。

## 确认连上了

Claude Code 在终端执行：

```bash
claude mcp list
```

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

## 可用工具

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

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

## 积分

新开发者可在[控制台](https://platform.snapany.com/zh/console)领取 50 个免费积分，**永久有效、不过期**。余额与充值也在那里，逐笔用量在[用量](https://platform.snapany.com/zh/console/usage)。

积分不足时工具会返回 `Insufficient credits`。完整计费规则见[积分与计费](https://platform.snapany.com/zh/docs/credits)。

## 连不上怎么办

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

## 下一步

- [鉴权](https://platform.snapany.com/zh/docs/authentication) — API key 的创建与轮换
- [积分与计费](https://platform.snapany.com/zh/docs/credits) — 计费模型与充值
- [API 参考](https://platform.snapany.com/zh/docs/api) — 完整端点文档（可在线调试）

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