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

# 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 集成？

<CardGroup cols={2}>
  <Card title="AI 驱动的编码" icon="wand-magic-sparkles">
    在使用 Cursor 的 AI 助手编码时访问数据提取工具
  </Card>

  <Card title="项目集成" icon="folder-tree">
    为每个项目单独配置 MCP 或为所有工作区全局配置
  </Card>

  <Card title="实时数据" icon="bolt">
    在开发工作流程中直接提取社交媒体数据
  </Card>

  <Card title="开发者友好" icon="code">
    基于 JSON 的配置，易于版本控制和共享
  </Card>
</CardGroup>

## 安装步骤

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

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

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

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

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

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

<Tabs>
  <Tab title="项目配置（推荐）">
    在项目根目录创建 `.cursor/mcp.json` 文件：

    ```json theme={null}
    {
      "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 或重新加载窗口

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

  <Tab title="全局配置">
    为所有 Cursor 项目全局配置 MCP：

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

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

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

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

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

**配置说明：**

* `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 theme={null}
export ANYSITE_API_KEY="your_api_key_here"
```

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

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

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

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

```bash theme={null}
ANYSITE_API_KEY=your_api_key_here
```

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

### 步骤 4：验证安装

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

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

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

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

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

## 管理您的连接

### 更新配置

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

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

### 移除 MCP 服务器

要移除 Anysite MCP 集成：

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

### 多个 MCP 服务器

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

```json theme={null}
{
  "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": {}
    }
  }
}
```

## 故障排除

<AccordionGroup>
  <Accordion title="MCP 服务器无法连接">
    **解决方案：**

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

  <Accordion title="工具未出现在 Cursor AI 中">
    **解决方案：**

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

  <Accordion title="NPX 命令未找到">
    **解决方案：**

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

  <Accordion title="无效的 JSON 语法错误">
    **解决方案：**

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

  <Accordion title="API 密钥无效">
    **解决方案：**

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

  <Accordion title="环境变量未加载">
    **解决方案：**

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

## 安全最佳实践

<CardGroup cols={2}>
  <Card title="环境变量" icon="shield-halved">
    将 API 密钥存储在环境变量中，永远不要在配置文件中硬编码
  </Card>

  <Card title="Git 忽略" icon="ban">
    始终将 `.cursor/mcp.json` 和 `.env` 添加到 `.gitignore`
  </Card>

  <Card title="密钥轮换" icon="rotate">
    定期从 Anysite 仪表板重新生成 API 密钥
  </Card>

  <Card title="审计访问" icon="list-check">
    定期在 Anysite 仪表板中查看 API 使用情况
  </Card>
</CardGroup>

**.gitignore 示例：**

```gitignore theme={null}
# 带有 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`       | 不适用            |

## 下一步

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

## 需要帮助？

<Card title="获取支持" icon="headset" href="mailto:support@anysite.io">
  联系我们的支持团队获取 Cursor MCP 集成帮助
</Card>