本页导航

连接桌面应用到爱看相册 MCP

在爱看相册 MCP 页面启动服务,再按下方步骤连接桌面应用。

连接地址: 示例中的 127.0.0.1 指向客户端所在的本机。在局域网其他设备上使用时,可将其替换为运行爱看相册的电脑的局域网 IP,前提是 MCP 服务允许局域网连接且端口可达。

开始前

  1. 打开爱看相册 MCP 页面并启动服务。
  2. 从配置 JSON 复制服务地址和 headers.Authorization 的值。
  3. 按下方对应步骤添加并启用 selfphotos,确认连接成功。

配置示例中的占位符请替换为对应字段值。请勿公开访问令牌;令牌轮换后,更新各客户端。

桌面应用配置

千问办公

打开 连接器 → 添加 → 粘贴 JSON 配置,粘贴并保存。将 Authorization 占位符替换为爱看相册配置 JSON 中 headers.Authorization 的值:

{
  "mcpServers": {
    "selfphotos": {
      "type": "http",
      "url": "http://127.0.0.1:17238/mcp",
      "headers": {
        "Authorization": "<复制爱看相册配置 JSON 中 headers.Authorization 的值>"
      }
    }
  }
}

豆包工作

打开 插件·技能·伙伴 → 添加 → 新建自定义连接器,填写:

  • 名称:selfphotos
  • 类型:HTTP
  • URL:http://127.0.0.1:17238/mcp
  • Authorization:复制爱看相册配置 JSON 中 headers.Authorization 的值

保存并启用连接器。

豆包工作自定义连接器配置示例,访问令牌已隐藏

ChatGPT

在 ChatGPT 桌面端打开 设置 → 插件 → 添加 → 添加 MCP 服务器,填写:

  • 名称:selfphotos
  • 类型:流式 HTTP
  • URL:http://127.0.0.1:17238/mcp
  • 在 标头中添加 Authorization,将爱看相册配置 JSON 中 headers.Authorization 的值填入值栏
  • Bearer 令牌环境变量:留空,不要在此处填写令牌

保存并确认连接。

ChatGPT 自定义 MCP 配置示例,访问令牌已隐藏

官方说明:ChatGPT MCP。

Claude Desktop

  1. 打开 设置 → 开发者 → 编辑配置,打开 claude_desktop_config.json。
  2. 在现有 JSON 中添加以下 selfphotos 条目;如果已有 mcpServers,请合并进去。
  3. 关闭并重新启动 Claude Desktop。
{
  "mcpServers": {
    "selfphotos": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:17238/mcp",
        "--header",
        "Authorization: <复制爱看相册配置 JSON 中 headers.Authorization 的值>"
      ]
    }
  }
}

配置文件:

  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows:%APPDATA%\Claude\claude_desktop_config.json。

官方说明:连接本机 MCP 服务。

WorkBuddy

打开 专家 → 技能 → 连接器 → 自定义连接器 → 添加 MCP,填写以下配置。保存后再次选择 自定义连接器,然后信任并打开:

{
  "mcpServers": {
    "selfphotos": {
      "type": "http",
      "url": "http://127.0.0.1:17238/mcp",
      "headers": {
        "Authorization": "<复制爱看相册配置 JSON 中 headers.Authorization 的值>"
      }
    }
  }
}

配置文件:

  • macOS:~/.workbuddy-ai/mcp.json
  • Windows:%USERPROFILE%\.workbuddy-ai\mcp.json。

官方说明:WorkBuddy 连接器。

Cherry Studio

打开 设置 → MCP → 添加 → 从 JSON 导入,导入配置并启用服务器:

{
  "mcpServers": {
    "selfphotos": {
      "type": "http",
      "url": "http://127.0.0.1:17238/mcp",
      "headers": {
        "Authorization": "<复制爱看相册配置 JSON 中 headers.Authorization 的值>"
      }
    }
  }
}

之后打开 工作 → Agent 菜单 → 编辑 → MCP,为要使用 爱看相册 的 Agent 启用该服务。

官方说明:Cherry Studio MCP。

VS Code (Copilot)

打开 首选项 → 配置文件 → MCP 服务器,填入配置;保存后运行 MCP: List Servers 并启动 selfphotos。

{
  "servers": {
    "selfphotos": {
      "type": "http",
      "url": "http://127.0.0.1:17238/mcp",
      "headers": {
        "Authorization": "<复制爱看相册配置 JSON 中 headers.Authorization 的值>"
      }
    }
  }
}

配置文件:

  • macOS: ~/Library/Application Support/Code/User/mcp.json
  • Windows: %APPDATA%\Code\User\mcp.json

官方说明:VS Code MCP · VS Code

Cursor

在 Code 或 Chat 模式打开 Customize → MCPs → New MCP Server,粘贴配置并保存。

{
  "mcpServers": {
    "selfphotos": {
      "url": "http://127.0.0.1:17238/mcp",
      "headers": {
        "Authorization": "<复制爱看相册配置 JSON 中 headers.Authorization 的值>"
      }
    }
  }
}

配置文件:

  • macOS: ~/.cursor/mcp.json
  • Windows: %USERPROFILE%\.cursor\mcp.json

官方说明:Cursor MCP

OpenCode

打开 主页 → 设置 → 扩展 → MCP → 在 opencode.json 中管理,将配置合并到现有的 mcp 对象,保存后确认连接。

如果无法点击 在 opencode.json 中管理,请按下方配置文件路径直接打开并编辑文件。

OpenCode MCP 设置中的“在 opencode.json 中管理”入口

{
  "mcp": {
    "selfphotos": {
      "type": "remote",
      "url": "http://127.0.0.1:17238/mcp",
      "headers": {
        "Authorization": "<复制爱看相册配置 JSON 中 headers.Authorization 的值>"
      },
      "oauth": false
    }
  }
}

配置文件:

  • macOS: ~/.config/opencode/opencode.json
  • Windows: %USERPROFILE%\.config\opencode\opencode.json

官方说明:OpenCode MCP

TRAE / TRAE CN

打开 插件市场 → 管理 → MCP → 添加 → 手动添加,粘贴配置并启用服务器。

{
  "mcpServers": {
    "selfphotos": {
      "url": "http://127.0.0.1:17238/mcp",
      "headers": {
        "Authorization": "<复制爱看相册配置 JSON 中 headers.Authorization 的值>"
      }
    }
  }
}

官方说明:TRAE · TRAE CN

CodeBuddy

打开右侧侧栏 设置 → MCP → 配置 MCP,粘贴配置并启用 selfphotos。

{
  "mcpServers": {
    "selfphotos": {
      "type": "http",
      "url": "http://127.0.0.1:17238/mcp",
      "headers": {
        "Authorization": "<复制爱看相册配置 JSON 中 headers.Authorization 的值>"
      }
    }
  }
}

配置文件:

  • macOS: ~/.codebuddy/mcp.json
  • Windows: %USERPROFILE%\.codebuddy\mcp.json

官方说明:CodeBuddy MCP

Qoder

打开 设置 → 扩展管理 → 连接器 → + → JSON,添加配置;如出现信任提示,确认并打开连接器。

{
  "mcpServers": {
    "selfphotos": {
      "type": "http",
      "url": "http://127.0.0.1:17238/mcp",
      "headers": {
        "Authorization": "<复制爱看相册配置 JSON 中 headers.Authorization 的值>"
      }
    }
  }
}

配置文件:

  • macOS: ~/.qoder/settings.json
  • Windows: %USERPROFILE%\.qoder\settings.json

官方说明:Qoder MCP · Qoder

Devin Desktop (旧版 Cascade)

在旧版 Cascade 中打开 Customize → MCPs → + → New MCP → Import JSON,导入配置。此配置适用于 Cascade;Devin Local 使用不同的配置方式。

{
  "mcpServers": {
    "selfphotos": {
      "type": "http",
      "url": "http://127.0.0.1:17238/mcp",
      "headers": {
        "Authorization": "<复制爱看相册配置 JSON 中 headers.Authorization 的值>"
      }
    }
  }
}

配置文件:

  • macOS: ~/.config/devin/mcp_config.json
  • Windows: %APPDATA%\devin\mcp_config.json

官方说明:Cascade MCP

ZCode

打开 设置 → MCP 服务器 → 新建 → JSON,粘贴配置并保存。

{
  "selfphotos": {
    "type": "http",
    "url": "http://127.0.0.1:17238/mcp",
    "headers": {
      "Authorization": "<复制爱看相册配置 JSON 中 headers.Authorization 的值>"
    }
  }
}

配置文件:

  • macOS: ~/.zcode/cli/config.json
  • Windows: %USERPROFILE%\.zcode\cli\config.json

官方说明:ZCode MCP

常见问题

服务无法连接

确认爱看相册 MCP 服务已启动,并核对地址、端口和 /mcp 路径。在其他设备上连接时,使用爱看相册所在电脑的局域网 IP,并检查服务监听地址、防火墙和网络连通性。容器、远程工作区或云端 Agent 中的 127.0.0.1 指向其自身运行环境,应使用该环境能访问的服务地址。

鉴权失败

从爱看相册当前配置 JSON 重新复制 headers.Authorization 的完整值,填入客户端的 Authorization 标头,替换示例占位符后保存并重连。ChatGPT 中请填写到标头值栏,“Bearer 令牌环境变量”留空。

令牌轮换后无法连接

用新配置 JSON 中的 headers.Authorization 值更新所有已连接的客户端,保存并重连;如果仍使用旧配置,请重新加载配置或重启客户端。