文档目录

MCP 接入说明

功能说明

Submify 提供 MCP(Model Context Protocol)服务。接入后,可以直接在 Codex、Claude Code、Cursor 等支持 MCP 的 AI 工具里用对话完成:

  1. 创建网站、更新网站资料。
  2. 按标签、推荐包或分类,把外链加入网站提交队列。
  3. 按 URL 或外链 ID 批量添加外链。
  4. 生成网站的 Codex 自动提交提示词。
  5. 查看单个网站的提交进度。
  6. 查看账户下所有网站的外链提交情况。

开始前准备

  1. 进入 API Key 管理,创建并启用一个 API Key(以 sk_ 开头)。
  2. 一个支持远程 MCP(Streamable HTTP)的 AI 工具,如 Codex、Claude Code、Cursor。

MCP 地址:

https://submify.app/api/mcp

所有请求都需要携带请求头 Authorization: Bearer <你的 API Key>。API Key 是账号凭证,不要公开分享;怀疑泄露时立即停用并重新创建。

一、接入 Codex

在 ~/.codex/config.toml 中添加:

[mcp_servers.submify]
url = "https://submify.app/api/mcp"
bearer_token_env_var = "SUBMIFY_API_KEY"

然后在启动 Codex 的终端中设置环境变量:

export SUBMIFY_API_KEY="sk_xxx"

二、接入 Claude Code

在终端执行:

claude mcp add --transport http submify https://submify.app/api/mcp \
  --header "Authorization: Bearer sk_xxx"

三、接入 Cursor 等其他工具

在工具的 MCP 配置文件(如 Cursor 的 ~/.cursor/mcp.json)中添加:

{
  "mcpServers": {
    "submify": {
      "url": "https://submify.app/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_xxx"
      }
    }
  }
}

配置完成后重启工具,在 MCP 列表中看到 submify 和下方的工具即表示接入成功。

四、可用工具

工具用途
list_websites列出账户下所有网站和网站数量配额
get_website查看网站完整资料和资料检查结果
create_website创建网站,product_name、product_url 必填
update_website更新网站资料,只传需要修改的字段
add_backlinks_by_tags按外链标签、推荐包或分类添加外链到网站
batch_add_backlinks按外链 URL 或外链 ID 批量添加,单次最多 3000 条
get_codex_submission_prompt生成 Codex 自动提交提示词,附带接口文档
get_website_submission_progress查看网站的提交状态统计和提交记录
get_account_backlink_overview查看所有网站的外链总数、进行中、已完成、失败数

添加外链时,已存在于网站的外链会自动跳过,无效 URL 会在结果中列出。

五、对话示例

帮我创建网站 https://example.com,名称 Example,简介是“一款 AI 写作工具”。
把标签 startup 和分类 directory 的外链都加到 Example 网站。
生成 Example 网站的 Codex 提交提示词,只提交导航站,最多 20 个。
看看 Example 网站的提交进度,列出需要我处理的记录。
汇总一下我所有网站的外链提交情况。

注意事项

  1. 网站缺少名称、网址或简短介绍时,无法生成 Codex 提交提示词,请先补全资料。
  2. 使用 API Key 接入时,生成的提示词会带上当前 API Key,可直接交给 Codex 执行;不要把提示词公开分享。
  3. 网站数量和外链权益与网页端一致,按当前会员方案计算。
  4. 更多 Codex 提交流程见 Codex 自动发外链。