2025/12/06

MyBacklinks MCP 入门指南：让 AI 管理你的外链

学习如何使用 MCP（模型上下文协议）将 Claude Code、Cursor 等 AI 助手连接到 MyBacklinks，实现自动化的项目和外链管理。

MyBacklinks MCP 入门指南

MyBacklinks MCP（模型上下文协议）服务器让你能够直接从 AI 开发工具（如 Claude Code、Cursor 和 OpenAI Codex）管理项目、外链和数据分析。本指南将介绍设置、OAuth 认证和可用工具的使用方法。

什么是 MCP？

模型上下文协议（MCP）是由 Anthropic 开发的开放标准，允许 AI 助手安全地连接到外部数据源和工具。MyBacklinks MCP 服务器实现了该协议，使用 OAuth 2.0 动态客户端注册进行安全认证。

功能特点

🔐 安全的 OAuth 2.0 认证 - 支持动态客户端注册和 PKCE 流程
🚀 零配置设置 - 只需添加 URL，认证自动完成
🛠️ 9 个强大工具 - 管理项目、外链、资源和数据分析
🔄 自动令牌刷新 - 无缝的会话管理
🎯 多平台支持 - Claude Code、Cursor、Codex 等

快速开始

支持的客户端

客户端	传输协议	OAuth
Claude Code	Streamable HTTP	✅ 内置
Cursor	Streamable HTTP	✅ 内置
OpenAI Codex	Streamable HTTP	✅ 内置
移动端应用	Streamable HTTP	✅ OAuth 或 API Key

配置

只需将 MCP 服务器 URL 添加到客户端配置中：

Claude Code 配置

方式一：命令行（推荐）

# 添加到用户范围（所有项目可用）
claude mcp add --transport http --scope user mybacklinks https://mybacklinks.app/mcp

# 或仅添加到当前项目
claude mcp add --transport http mybacklinks https://mybacklinks.app/mcp

# 验证是否添加成功
claude mcp list

方式二：配置文件 (~/.claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "mybacklinks": {
      "url": "https://mybacklinks.app/mcp"
    }
  }
}

Cursor 配置

在项目中添加 .cursor/mcp.json：

{
  "mcpServers": {
    "mybacklinks": {
      "url": "https://mybacklinks.app/mcp"
    }
  }
}

OpenAI Codex 配置

命令行：

codex mcp add mybacklinks --url https://mybacklinks.app/mcp

或配置文件 (~/.codex/mcp.toml)：

[[mcp_servers]]
name = "mybacklinks"
url = "https://mybacklinks.app/mcp"

移动端配置

想要随时随地管理你的外链？移动端 MCP 客户端支持两种认证方式：

方式一：OAuth 认证（推荐）

如果你的移动端 MCP 客户端支持 OAuth：

添加新服务器，URL 填写：https://mybacklinks.app/mcp
点击「连接」- 应用会自动处理 OAuth 认证
在手机浏览器中完成登录
返回应用，开始使用 MCP 工具！

方式二：API Key + 自定义 Header

如果你的移动端 MCP 客户端不支持 OAuth，可以使用 API Key 认证：

前往 MyBacklinks API Keys 页面
点击「创建 API Key」并复制生成的密钥
在移动端 MCP 客户端中，添加新服务器，URL 填写：https://mybacklinks.app/mcp
配置自定义 Header：
- Header 名称：Authorization
- Header 值：Bearer YOUR_API_KEY
保存并连接 - 即可开始使用 MCP 工具！

API Key 配置示例：

服务器 URL: https://mybacklinks.app/mcp
自定义 Headers:
  Authorization: Bearer mbk_xxxxxxxxxxxxxxxxxxxx

移动端使用场景：

通勤时查看项目状态
发现外链机会时快速添加
随时随地查看分析报告
实时响应外链状态变化

提示： OAuth 更安全，令牌可自动刷新和撤销。API Key 配置更简单，但请妥善保管，切勿公开分享。

首次认证

首次连接时，你的 AI 客户端会自动：

从 /.well-known/oauth-authorization-server 发现 OAuth 元数据
注册为动态客户端（RFC 7591）
打开浏览器让你登录
安全存储令牌供后续请求使用

无需手动设置——只需配置 URL 即可开始使用！

可用的 MCP 工具

连接后，你的 AI 助手可以使用以下 9 个工具：

项目管理

`listProjects`

列出所有项目及其元数据。

参数：

cursor（可选）：分页游标
limit（可选）：返回最大数量（1-50）

示例提示：

显示我的所有项目

返回内容：

项目 ID、名称、域名
状态（active/archived）
创建和更新时间

`getProjectDetail`

获取特定项目的详细信息。

参数：

projectId（必需）：项目 ID

示例：

获取我的 LoveMoney 项目详情

返回内容：

项目元数据
各状态的外链数量（待提交、已提交、已收录、已拒绝）
资源数量
最后分析同步日期

外链管理

`listProjectBacklinks`

列出特定项目的所有外链。

参数：

projectId（必需）：项目 ID
status（可选）：按状态过滤（pending、submitted、indexed、rejected、removed）
cursor（可选）：分页游标
limit（可选）：最大数量（1-50）
fields（可选）：选择特定字段以减少响应大小

示例：

显示我项目的所有已收录外链

`getProjectBacklinkDetail`

获取特定项目外链的详细信息。

参数：

backlinkId（必需）：项目外链 ID

示例：

显示外链 abc123 的详情

`upsertProjectBacklink`

创建或更新项目外链。

参数：

projectId（必需）：项目 ID
backlinkId（可选）：更新时的外链 ID
resourceId（可选）：外链资源 ID（会自动从资源填充 backlinkUrl）
targetUrl（创建时必需）：目标 URL（你想要获取外链的页面）
backlinkUrl（可选）：外链所在的 URL
anchor（可选）：锚文本
status（可选）：外链状态
notes（可选）：备注

示例：

为我的项目添加一个新外链：
- 目标 URL: https://myapp.com
- 外链 URL: https://producthunt.com/posts/myapp
- 锚文本: "AI 驱动的工具"
- 状态: submitted

资源管理

`listBacklinkResources`

列出可用的外链资源（目录、论坛等），你可以在这些网站提交你的项目。

参数：

cursor（可选）：分页游标
limit（可选）：最大数量（1-50）
filter（可选）：过滤条件对象：
- type：资源类型（如 "guest_post"、"directory"）
- payment：付费类型（如 "free"、"paid"）
- drMin：最低域名评级
- drMax：最高域名评级

示例：

找一些高 DR（> 50）的免费外链提交网站

`listAvailableResources`

列出项目尚未使用的外链资源。用于发现可以提交新外链的资源。

参数：

projectId（必需）：要检查的项目 ID
cursor（可选）：分页游标
limit（可选）：最大数量（1-50）
filter（可选）：与 listBacklinkResources 相同的过滤条件

示例：

显示我 SaaS 项目还没有使用过的资源

`addBacklinkResource`

新增外链资源到个人数据库。如果已存在相同域名的资源，将拒绝添加。

参数：

domain（必需）：资源域名（如 "example.com"）。协议前缀和路径会被自动移除
type（必需）：资源类型（blog、directory、forum、social、other）
submissionUrl（可选）：提交外链的完整 URL
paymentType（可选）：付费类型（free、paid、freemium）。默认：free
submissionMethod（可选）：提交方式（如 "comment"、"guest post"、"profile link"）
howToSubmit（可选）：AI Agent 提交外链的自然语言指引
dr（可选）：域名评级（0-100）
traffic（可选）：预估月流量
notes（可选）：关于此资源的备注

示例：

添加一个新的外链资源：
- 域名: indiehackers.com
- 类型: forum
- 付费: free
- DR: 70
- 备注: SaaS 创始人的好社区

错误处理： 如果域名已存在于你的数据库中，工具将返回错误码 duplicate_domain，并包含已存在资源的 ID。

数据分析

`getProjectAnalytics`

获取项目的分析数据。

参数：

projectId（必需）：项目 ID
range（可选）：时间范围（30d 或 90d）

示例：

显示我项目过去 30 天的 SEO 分析数据

使用场景

日常 SEO 工作流

问你的 AI 助手：

生成所有项目的状态报告，包含外链数量

外链审计

检查我 SaaS 项目的所有待处理外链，列出需要关注的

发现机会

找一些 DR 在 40-60 之间的网站，我可以在那里发客座文章

批量操作

为我的项目添加这些外链：
1. https://reddit.com/r/startups/my-post - 锚文本: "startup tools"
2. https://hackernews.com/item/123 - 锚文本: "new SaaS tool"

构建资源库

添加这些外链资源到我的数据库：
1. indiehackers.com - 论坛类型, DR 70, 免费
2. producthunt.com - 目录类型, DR 90, 免费
3. betalist.com - 目录类型, DR 60, 免费增值

OAuth 2.0 架构

MyBacklinks MCP 服务器实现了以下 OAuth 2.0 特性：

标准合规

OAuth 2.1 配合 PKCE 增强安全性
RFC 8414 授权服务器元数据发现
RFC 7591 动态客户端注册
RFC 8707 资源指示器

OAuth 端点

端点	用途
`/.well-known/oauth-authorization-server`	元数据发现
`/.well-known/oauth-protected-resource`	资源元数据
`/api/oauth/register`	动态客户端注册
`/api/oauth/authorize`	授权端点
`/api/oauth/token`	令牌交换

安全特性

PKCE (S256)：防止授权码拦截
动态注册：无需预共享客户端密钥
令牌轮换：刷新令牌使用后轮换
受限作用域：仅请求 mcp 作用域

故障排除

认证失败

如果看到 "Incompatible auth server" 错误：

确保使用最新版本的 AI 客户端
检查 MCP URL 是否正确：https://mybacklinks.app/mcp
尝试移除并重新添加 MCP 服务器

令牌过期

你的 AI 客户端应该自动处理令牌刷新。如果问题持续：

从客户端移除 MCP 服务器
重新添加并完成 OAuth 流程

连接问题

验证服务器是否可访问：

curl https://mybacklinks.app/.well-known/oauth-authorization-server

你应该看到包含 authorization_endpoint 和 token_endpoint 的 JSON 元数据。

API 速率限制

MyBacklinks MCP 根据你的订阅级别有以下速率限制：

免费版：100 请求/小时
专业版：1,000 请求/小时
企业版：自定义限制

最佳实践

使用分页：对于大数据集，使用 cursor 和 limit 参数
选择字段：在 listProjectBacklinks 中使用 fields 参数减少响应大小
批量操作：在一次对话中组合相关的外链更新
检查状态：在操作前验证外链状态

下一步

在 mybacklinks.app 创建账户
设置你的第一个项目
使用上述配置连接你的 AI 助手
开始自动化你的外链管理！

支持

需要帮助？通过以下方式联系：

GitHub Issues：github.com/hekmon8/mybacklinks-tools/issues
邮箱：support@mybacklinks.app

祝自动化愉快！🚀

全部文章

MyBacklinks MCP 入门指南：让 AI 管理你的外链

分类

更多文章

滚雪球外链策略：如何系统化构建你的链接帝国

MyBacklinks.app - 独立开发者的项目管理与增长追踪平台