> ## Agent Instructions
>
> Base URL: https://api.anysite.io
> Authentication: send the `access-token` header. Do NOT use `Authorization: Bearer`.
> Full endpoint catalog: https://app.anysite.io/docs
# Cursor MCP 工具安装

使用 JSON 配置将 Anysite MCP 服务器连接到 Cursor IDE

## 概述

Anysite MCP 工具用于 Cursor，通过模型上下文协议（MCP）在 Cursor IDE 和 Anysite API 之间提供无缝集成。这允许您在 Cursor AI 编码会话中直接访问 LinkedIn、Instagram、Reddit 和其他社交媒体数据提取工具。

## 前提条件

- 已安装 Cursor IDE（[在此下载](https://cursor.com)）
- 已安装 Node.js 和 npm（用于 NPX 方法）
- 拥有有效订阅的 Anysite API 账户
- 基本熟悉 JSON 配置

## 为什么选择 Cursor 集成？

  
#### AI 驱动的编码

    在使用 Cursor 的 AI 助手编码时访问数据提取工具
  

  
#### 项目集成

    为每个项目单独配置 MCP 或为所有工作区全局配置
  

  
#### 实时数据

    在开发工作流程中直接提取社交媒体数据
  

  
#### 开发者友好

    基于 JSON 的配置，易于版本控制和共享
  

## 安装步骤

### 步骤 1：获取您的 API 密钥

首先，从 Anysite 仪表板获取您的 API 密钥：

1. 访问 [app.anysite.io](https://app.anysite.io) 并登录您的账户
2. 导航到 **MCP 服务器集成** 部分
3. 从仪表板复制您的 API 密钥

> 
确保您的 API 密钥安全 - 永远不要公开分享或提交到版本控制。

### 步骤 2：在 Cursor 中配置 MCP

在 Cursor 中配置 MCP 有两种方式：

  
#### 项目配置（推荐）

    在项目根目录创建 `.cursor/mcp.json` 文件：

    ```json
    {
      "mcpServers": {
        "anysite": {
          "command": "npx",
          "args": ["-y", "@anysiteio/mcp"],
          "env": {
            "ANYSITE_API_KEY": "YOUR_API_KEY",
            "ANYSITE_ACCOUNT_ID": ""
          }
        }
      }
    }
    ```

    **步骤：**
    1. 在 Cursor 中打开您的项目
    2. 在项目根目录创建 `.cursor` 目录（如果不存在）
    3. 在 `.cursor` 目录内创建 `mcp.json` 文件
    4. 粘贴上述配置
    5. 将 `YOUR_API_KEY` 替换为您的实际 API 密钥
    6. 重新启动 Cursor 或重新加载窗口

    
> 
    项目特定配置非常适合团队协作。如果您的 API 密钥直接包含在内，请将 `.cursor/mcp.json` 添加到 `.gitignore`。
    
  

  
#### 全局配置

    为所有 Cursor 项目全局配置 MCP：

    **对于 macOS：**
    编辑 `~/.cursor/mcp.json`：

    **对于 Windows：**
    编辑 `%USERPROFILE%\.cursor\mcp.json`：

    **对于 Linux：**
    编辑 `~/.cursor/mcp.json`：

    ```json
    {
      "mcpServers": {
        "anysite": {
          "command": "npx",
          "args": ["-y", "@anysiteio/mcp"],
          "env": {
            "ANYSITE_API_KEY": "YOUR_API_KEY",
            "ANYSITE_ACCOUNT_ID": ""
          }
        }
      }
    }
    ```

    
> 
    全局配置使 Anysite 工具在您所有的 Cursor 项目中都可用，无需每个项目单独设置。
    
  

**配置说明：**
- `command: "npx"` - 使用 npx 运行 MCP 包
- `args: ["-y", "@anysiteio/mcp"]` - 自动确认并运行 Anysite MCP 包
- `ANYSITE_API_KEY` - 您从 Anysite 仪表板获取的 API 密钥
- `ANYSITE_ACCOUNT_ID` - 可选的账户 ID（如果不需要则留空）

### 步骤 3：使用环境变量（安全方法）

为了更好的安全性，使用环境变量而不是硬编码 API 密钥：

**选项 1：Shell 环境**

添加到您的 shell 配置文件（`~/.zshrc`、`~/.bashrc`）：

```bash
export ANYSITE_API_KEY="your_api_key_here"
```

然后更新您的 `mcp.json`：

```json
{
  "mcpServers": {
    "anysite": {
      "command": "npx",
      "args": ["-y", "@anysiteio/mcp"],
      "env": {
        "ANYSITE_API_KEY": "${ANYSITE_API_KEY}",
        "ANYSITE_ACCOUNT_ID": ""
      }
    }
  }
}
```

**选项 2：.env 文件**

在项目根目录创建 `.env` 文件：

```bash
ANYSITE_API_KEY=your_api_key_here
```

> 
始终将 `.env` 添加到您的 `.gitignore` 以防止意外提交敏感数据。

### 步骤 4：验证安装

配置完成后，验证 MCP 服务器是否正常工作：

1. **重新启动 Cursor** 或重新加载窗口（Cmd/Ctrl + Shift + P → "Reload Window"）

2. **打开 Cursor AI 聊天** 并询问：
   ```
   你有哪些 MCP 工具可用？
   ```

3. **用简单请求测试：**
   ```
   获取此 LinkedIn 个人资料的信息：linkedin.com/in/username
   ```

> 
如果一切正常工作，Cursor AI 将列出可用的 Anysite 工具，并能够执行数据提取请求。

## 管理您的连接

### 更新配置

要更新您的 API 密钥或其他设置：

1. 编辑 `mcp.json` 文件
2. 保存更改
3. 重新启动 Cursor 或重新加载窗口

### 移除 MCP 服务器

要移除 Anysite MCP 集成：

1. 从您的 `mcp.json` 文件中删除 `anysite` 条目
2. 或者如果不使用其他 MCP 服务器，删除整个 `mcp.json` 文件
3. 重新启动 Cursor

### 多个 MCP 服务器

您可以在同一文件中配置多个 MCP 服务器：

```json
{
  "mcpServers": {
    "anysite": {
      "command": "npx",
      "args": ["-y", "@anysiteio/mcp"],
      "env": {
        "ANYSITE_API_KEY": "YOUR_API_KEY",
        "ANYSITE_ACCOUNT_ID": ""
      }
    },
    "other-server": {
      "command": "npx",
      "args": ["-y", "other-mcp-package"],
      "env": {}
    }
  }
}
```

## 故障排除

  
#### MCP 服务器无法连接

    **解决方案：**
    - 确保 Node.js 和 npm 已安装并在 PATH 中
    - 验证 API 密钥是否有效且活跃
    - 检查互联网连接
    - 完全重新启动 Cursor
    - 检查 Cursor 日志中的错误消息
  

  
#### 工具未出现在 Cursor AI 中

    **解决方案：**
    - 重新加载 Cursor 窗口（Cmd/Ctrl + Shift + P → "Reload Window"）
    - 验证 `mcp.json` 文件语法正确（有效的 JSON）
    - 检查文件是否在正确的位置
    - 确保您的 Anysite 订阅是活跃的
  

  
#### NPX 命令未找到

    **解决方案：**
    - 从 [nodejs.org](https://nodejs.org) 安装 Node.js
    - 确保 npm 在系统 PATH 中
    - 尝试在终端中运行 `npx --version` 验证
    - 在 Windows 上，安装 Node.js 后可能需要重新启动
  

  
#### 无效的 JSON 语法错误

    **解决方案：**
    - 在 [jsonlint.com](https://jsonlint.com) 验证您的 JSON
    - 检查缺少的逗号、括号或引号
    - 确保对象/数组的最后一项后没有尾随逗号
    - 在编辑器中使用 JSON 格式化扩展
  

  
#### API 密钥无效

    **解决方案：**
    - 验证 API 密钥正确（没有多余空格）
    - 检查您的 Anysite 订阅是否活跃
    - 尝试从仪表板生成新的 API 密钥
    - 确保密钥具有必要的权限
  

  
#### 环境变量未加载

    **解决方案：**
    - 添加环境变量后重新启动终端/shell
    - 从终端启动 Cursor：`cursor .`
    - 在 macOS 上，GUI 应用可能不会继承 shell 环境变量
    - 尝试使用直接 API 密钥方法进行测试
  

## 安全最佳实践

  
#### 环境变量

    将 API 密钥存储在环境变量中，永远不要在配置文件中硬编码
  

  
#### Git 忽略

    始终将 `.cursor/mcp.json` 和 `.env` 添加到 `.gitignore`
  

  
#### 密钥轮换

    定期从 Anysite 仪表板重新生成 API 密钥
  

  
#### 审计访问

    定期在 Anysite 仪表板中查看 API 使用情况
  

**.gitignore 示例：**

```gitignore
# 带有 API 密钥的 MCP 配置
.cursor/mcp.json

# 环境文件
.env
.env.local
.env.*.local
```

## 比较：Cursor 与其他集成

| 功能 | Cursor | Claude Code (CLI) | Claude Desktop |
|---------|--------|-------------------|----------------|
| **界面** | IDE 集成 | 命令行 | 桌面应用 |
| **设置** | JSON 配置 | 终端命令 | OAuth GUI |
| **最适合** | AI 辅助编码 | 开发者、自动化 | 一般用户 |
| **项目范围** | 每个项目配置 | 多个范围 | 仅全局 |
| **版本控制** | `.cursor/mcp.json` | `.mcp.json` | 不适用 |

## 下一步

- [探索使用示例](/docs/mcp-server/cursor-tool/examples?lang=zh)
- [查看所有可用工具](/docs/mcp-server/tools?lang=zh)
- [与 Claude Code 比较](/docs/mcp-server/claude-code-tool/installation?lang=zh)
- [尝试 Claude Desktop](/docs/mcp-server/claude-desktop-tool/installation?lang=zh)

## 需要帮助？

#### 获取支持

  联系我们的支持团队获取 Cursor MCP 集成帮助