> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socialvision.tisyk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Model Context Protocol (MCP) 接入

> 通过官方标准协议将 SocialVision 作为原生工具接入各类 AI Agent

SocialVision 提供了兼容官方规范的 **Streamable HTTP MCP 服务**，接入地址为：
`https://socialvision.tisyk.xyz/api/mcp`

## 支持的客户端与配置方法

### 1. Claude Desktop 接入

在你的电脑上找到 Claude Desktop 配置文件：

* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

在 `mcpServers` 字段中添加配置：

```json theme={null}
{
  "mcpServers": {
    "socialvision": {
      "url": "https://socialvision.tisyk.xyz/api/mcp",
      "headers": {
        "Authorization": "Bearer sv_live_你的API_KEY"
      }
    }
  }
}
```

保存并重启 Claude Desktop，右下角将出现工具锤子图标，包含 3 个原生工具：

* `list_endpoints`: 检索当前支持的所有端点目录
* `inspect_endpoint`: 查看端点的详细入参要求与售价
* `run`: 自动扣费并执行社媒数据提取

### 2. Cursor / WorkBuddy 接入

在 Cursor 设置中搜索 **MCP** -> **Add New MCP Server**：

* **Type**: `HTTP` 或 `Streamable HTTP`
* **Name**: `socialvision`
* **URL**: `https://socialvision.tisyk.xyz/api/mcp`
* **Headers**: `Authorization: Bearer sv_live_你的API_KEY`