> ## 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
# Claude Code MCP 工具安装

使用 CLI 命令将 Anysite MCP 服务器连接到 Claude Code

## 概述

Claude Code 的 Anysite MCP 工具通过模型上下文协议（MCP）提供基于 CLI 的 Claude Code 和 Anysite API 之间的无缝集成。这允许您使用终端命令直接在 Claude Code 会话中访问 LinkedIn、Instagram、Reddit 和其他社交媒体数据提取工具。

## 先决条件

- 已安装 Claude Code（[在此下载](https://claude.ai/download)）
- 终端/命令行访问
- 具有活跃订阅的 Anysite API 账户
- 基本熟悉命令行界面

## 为什么选择 Claude Code 集成？

  
#### CLI 控制

    为开发者和高级用户提供完整的命令行控制
  

  
#### 作用域管理

    通过灵活的作用域配置每个项目、每个用户或本地
  

  
#### CI/CD 就绪

    非常适合自动化、脚本和持续集成管道
  

  
#### 版本控制

    项目作用域配置可以通过 `.mcp.json` 提交和共享
  

## 安装步骤

### 步骤 1：获取连接 URL

首先，从 Anysite 仪表板获取您的连接 URL：

1. 访问 [anysite.io](https://app.anysite.io/register) 并登录您的账户
2. 导航到 **MCP 服务器集成** 部分
3. 您将看到两个连接选项：
   - **OAuth URL**：`https://mcp.anysite.io/mcp`（用于 GUI 客户端）
   - **直接 URL**：直接包含 API 密钥（推荐用于 Claude Code）

<img src="/images/claude_code_cred.png" alt="Anysite MCP 服务器集成 - 获取连接 URL" />

4. 在"或添加到您的客户端"部分，选择 **Claude Code**
5. "自动"选项卡将显示完整的终端命令

> 
对于 Claude Code，使用包含连接字符串中 API 密钥的 **直接 URL**。

> 
保持您的连接 URL 安全 - 它包含您的 API 密钥。切勿公开分享或提交到版本控制。

### 步骤 2：通过终端安装

有两种安装方法可用：

  
#### CLI 命令（推荐）

    在终端中复制并运行命令：

    ```bash
    claude mcp add --transport http anysite "https://mcp.anysite.io/mcp?api_key=YOUR_API_KEY"
    ```

    **命令说明：**
    - `claude mcp add` - 添加新的 MCP 服务器
    - `--transport http` - 使用 HTTP 传输（可流式传输）
    - `anysite` - 此服务器的名称（可自定义）
    - `"URL"` - 您的带有 API 密钥的 MCP URL

    **可选参数：**

    ```bash
    # 添加特定作用域
    claude mcp add --transport http --scope user anysite "https://mcp.anysite.io/mcp?api_key=YOUR_API_KEY"

    # 使用环境变量添加（更安全）
    export ANYSITE_API_KEY="your_key_here"
    claude mcp add --transport http anysite "https://mcp.anysite.io/mcp?api_key=$ANYSITE_API_KEY"
    ```
  

  
#### NPX 配置

    或者，您可以通过 JSON 配置文件配置 MCP。

    **对于 macOS：**
    编辑 `~/.claude.json` 或项目根目录中的 `.mcp.json`：

    **对于 Windows：**
    编辑 `%APPDATA%\Claude\claude_desktop_config.json`

    添加以下配置：

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

    
> 
    NPX 方法会自动下载并运行最新的 Anysite MCP 包。它需要系统上安装 Node.js 和 npm。
    

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

**理解作用域：**

  
#### local（默认）

    **特定于项目，私有**

    - 配置存储在当前目录
    - 不共享或版本控制
    - 最适合：个人 API 密钥、临时设置

    ```bash
    claude mcp add --scope local anysite "URL"
    ```
  

  
#### project

    **通过版本控制共享**

    - 存储在项目根目录的 `.mcp.json` 中
    - 可以提交到 git
    - 团队成员获得相同的配置
    - 最适合：共享资源、团队项目

    ```bash
    claude mcp add --scope project anysite "URL"
    ```

    
> 
    不要提交 API 密钥！在项目作用域中使用环境变量。
    
  

  
#### user

    **跨项目，个人**

    - 存储在 `~/.claude.json`
    - 在所有项目中可用
    - 最适合：个人工具、全局工具

    ```bash
    claude mcp add --scope user anysite "URL"
    ```
  

### 步骤 3：验证安装

安装后，验证 MCP 服务器是否正常工作：

**列出所有配置的服务器：**
```bash
claude mcp list
```

预期输出：
```
anysite (http)
  ✔ connected
  https://mcp.anysite.io/mcp?api_key=***
```

**测试特定服务器：**
```bash
claude mcp get anysite
```

此命令：
- 测试与 Anysite MCP 服务器的连接
- 显示可用工具
- 显示服务器状态和配置

**在 Claude Code 对话中检查：**

在 Claude Code 会话期间，使用：
```
/mcp
```

这将显示实时 MCP 服务器状态和可用工具。

> 
如果您看到"✔ connected"状态，安装成功！

## 管理您的连接

### 查看已安装的服务器

```bash
# 列出所有 MCP 服务器
claude mcp list

# 获取特定服务器的详细信息
claude mcp get anysite
```

### 更新服务器配置

要更新服务器 URL 或配置：

1. 删除现有服务器：
   ```bash
   claude mcp remove anysite
   ```

2. 使用新配置重新添加：
   ```bash
   claude mcp add --transport http anysite "https://mcp.anysite.io/mcp?api_key=YOUR_API_KEY"
   ```

### 删除服务器

```bash
claude mcp remove anysite
```

> 
**已知问题**：`claude mcp remove` 可能无法正确删除项目作用域的服务器。如果发生这种情况，请手动编辑：
- macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows：`%APPDATA%\Claude\claude_desktop_config.json`

### 调试模式

用于排除连接问题：

```bash
claude --mcp-debug
```

这将使用详细的 MCP 调试输出运行 Claude Code，显示：
- 连接尝试
- 工具发现
- 错误消息
- 传输详情

## 故障排除

  
#### 服务器显示已添加但无法连接

    **解决方案：**
    - 完全重启 Claude Code
    - 验证 API 密钥是否有效且处于活跃状态
    - 检查互联网连接
    - 在浏览器中测试 URL（应返回 JSON）
    - 使用调试模式：`claude --mcp-debug`
    - 在 Anysite 仪表板中检查 API 配额
  

  
#### 安装后工具未出现

    **解决方案：**
    - 重启 Claude Code 应用程序
    - 运行 `claude mcp get anysite` 测试连接
    - 验证订阅是否包含您需要的工具
    - 删除并重新添加服务器：
      ```bash
      claude mcp remove anysite
      claude mcp add --transport http anysite "https://mcp.anysite.io/mcp?api_key=YOUR_API_KEY"
      ```
    - 检查 API 密钥是否已过期
  

  
#### 错误：'claude' 命令未找到

    **解决方案：**
    - 确保 Claude Code 已正确安装
    - 将 Claude Code 添加到 PATH：
      - macOS：添加到 `~/.zshrc` 或 `~/.bashrc`
      - Windows：添加到系统环境变量
    - 安装后重启终端
    - 尝试完整路径：`/Applications/Claude.app/Contents/MacOS/claude`（macOS）
  

  
#### 连接超时或响应缓慢

    **解决方案：**
    - 检查您的互联网连接速度
    - 使用环境变量增加超时：
      ```bash
      MCP_TIMEOUT=30000 claude  # 30 秒
      ```
    - 尝试在非高峰时段使用
    - 如果问题持续，请联系 Anysite 支持
  

  
#### 作用域之间的配置冲突

    **问题：** 在多个作用域配置了同一服务器

    **解决方案：**
    - 列出所有服务器以识别重复项：
      ```bash
      claude mcp list
      ```
    - 从特定作用域删除：
      ```bash
      # 从 local 删除
      rm ./.claude-local.json

      # 从 project 删除
      rm ./.mcp.json

      # 从 user 删除
      claude mcp remove anysite
      ```
    - 仅使用所需作用域重新添加
  

  
#### API 密钥安全顾虑

    **最佳实践：**

    1. **使用环境变量：**
       ```bash
       export ANYSITE_API_KEY="your_key"
       claude mcp add --transport http anysite "https://mcp.anysite.io/mcp?api_key=$ANYSITE_API_KEY"
       ```

    2. **切勿将密钥提交到 git：**
       ```bash
       # 添加到 .gitignore
       echo ".claude-local.json" >> .gitignore
       echo ".mcp.json" >> .gitignore
       ```

    3. **使用带环境变量的项目作用域：**
       ```bash
       # 团队可以共享配置，但不共享密钥
       claude mcp add --scope project --transport http anysite "https://mcp.anysite.io/mcp?api_key=$ANYSITE_API_KEY"
       ```

    4. **定期轮换密钥**（从 Anysite 仪表板）
  

## 安全最佳实践

  
#### 环境变量

    将 API 密钥存储在环境变量中，切勿在命令中硬编码
  

  
#### 作用域选择

    对敏感密钥使用 `local` 作用域，对共享配置使用 `project`
  

  
#### Git 忽略

    始终将 `.claude-local.json` 和 `.mcp.json` 添加到 `.gitignore`
  

  
#### 密钥轮换

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

  
#### 审计访问

    使用 `claude mcp list` 定期审查配置的服务器
  

  
#### 删除未使用的

    清理旧的服务器配置以减少安全风险
  

## 后续步骤

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

## 需要帮助？

#### 获取支持

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