Submitator

Submitator MCP 服务

可从 Claude、ChatGPT、Cursor 或 VS Code 启动客户的产品，每次最多提交到 100 个目录。

此 MCP 服务面向使用 Submitator 白标计划的代理机构。助手会根据 URL 创建客户项目，展示计划提交的目录；经你确认后启动项目，并跟踪各目录上线情况。徽章、报告和客户页面均采用代理机构的品牌。它使用代理机构密钥调用 Submitator API，且不会执行 API 不支持的操作。

所需条件

• 代理机构账户：app.submitator.com/agency/start。
• 从代理机构控制台的 Developers 获取 API 密钥。使用 claude.ai 或 ChatGPT 时，登录会创建密钥（见远程服务）。
  • sbm_test_ 密钥从创建代理机构当天起即可免费使用。它会以测试模式运行：项目和目录均为测试数据，不会提交任何内容，测试启动也不会计入已购买的启动次数。
  • sbm_live_ 密钥随首次购买一起提供。每次调用 launch_project 都会消耗一次启动次数。

安装

此软件包通过 npx 在你的计算机上运行（需要 Node.js 20 或更高版本）。请将密钥保存在用户级配置中，切勿放在仓库内的文件中。

Claude Code（用户范围，密钥不会写入项目的 .mcp.json）

claude mcp add --scope user submitator --env SUBMITATOR_API_KEY=sbm_test_... -- npx -y submitator-mcp

Cursor（~/.cursor/mcp.json，用户级文件）

{
  "mcpServers": {
    "submitator": {
      "command": "npx",
      "args": ["-y", "submitator-mcp"],
      "env": { "SUBMITATOR_API_KEY": "sbm_test_..." }
    }
  }
}

VS Code（.vscode/mcp.json）：VS Code 会提示输入密钥，并将其保留在文件之外。

{
  "inputs": [
    { "type": "promptString", "id": "submitator-key", "description": "Submitator API key", "password": true }
  ],
  "servers": {
    "submitator": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "submitator-mcp"],
      "env": { "SUBMITATOR_API_KEY": "${input:submitator-key}" }
    }
  }
}

Claude Desktop（claude_desktop_config.json）：使用与 Cursor 相同的代码块，放在 mcpServers 下。Claude Desktop 会在磁盘根目录中启动服务，因此如果要上传本地图片，请在 env 中添加 "SUBMITATOR_FILES_DIR": "/path/to/client/images"。

Devin Desktop（原 Windsurf）、Cline 和其他 MCP 客户端：在环境中设置 SUBMITATOR_API_KEY，然后运行 npx -y submitator-mcp，或使用下方的远程服务。

远程服务

远程服务地址为 https://mcp.submitator.com/mcp，无需安装。可通过两种方式连接： claude.ai 和 ChatGPT 登录 Submitator，其他客户端则在请求头中发送代理机构密钥。

claude.ai：登录

1. 在 claude.ai 中，打开 Customize > Connectors，点击 + Add，然后点击 Add custom connector。
2. 输入名称 Submitator 和 URL https://mcp.submitator.com/mcp，然后点击 Continue。 检查找到的设置，再次点击 Continue。
3. 在 Authentication 下选择 Sign in now，将 Use Claude's published identity (Recommended) 保留为 OAuth 客户端，不填写 Request headers，然后点击 Add。
4. 系统会打开 Submitator 登录页面：登录代理机构控制台。授权页面会显示客户端及其主机（Claude、claude.ai）。 选择 Test 或 Live，以及 Full 或 Read only，然后点击 Allow Claude。
5. 在聊天中打开 +，然后点击 Connectors，并启用 Submitator。

此链接 会打开第 1 步中的对话框，并自动填入名称和 URL。

登录会在控制台的 Developers 页面创建一个标记为 MCP: Claude 的密钥。要断开连接，请在该页面撤销密钥：下次调用时会要求重新登录。Live 模式要求代理机构已购买启动次数，因此新建代理机构只能使用 Test 模式，且测试模式不会提交任何内容。

在 Team 和 Enterprise 计划中，Owner 需先在 Organization settings > Connectors 下添加连接器：依次点击 Add、Custom、Web。随后，成员点击 Customize > Connectors 下的 Connect，并各自登录。

ChatGPT：登录

1. 在网页版 ChatGPT 中，打开 Plugins（chatgpt.com/plugins），点击加号按钮，然后选择 Add custom MCP server。
2. 输入名称 Submitator，并在 Connection 下填写 Server URL https://mcp.submitator.com/mcp。
3. 身份验证方式选择 OAuth，并使用 Client ID Metadata Document（CIMD）；不要填写客户端 ID 或密钥：Submitator 的登录流程会读取 ChatGPT 发布的客户端文档，无需注册客户端。
4. 查看风险警告，选择 I understand and want to continue，然后选择 Create as a plugin。
5. 安装插件，然后在聊天中输入 @ 并选择它。

当 ChatGPT 将你带到 Submitator 登录页面时，登录代理机构控制台，在授权页面选择 Test 或 Live，以及 Full 或 Read only，然后允许 ChatGPT 访问。与 claude.ai 一样，登录会在控制台的 Developers 页面创建一个标签以 MCP: 开头的密钥（可在此处撤销以断开连接）；新建的代理机构只能使用 Test 模式。

OpenAI 的文档说明，ChatGPT 默认会在执行写入操作前请求确认，并将没有 readOnlyHint 的工具视为写入工具。此处仅用于读取的工具带有 readOnlyHint: true，其他工具均为 false。在工作区中，添加和使用自定义 MCP 服务时，需遵守工作区的权限和安全设置。

Claude Code、Cursor、VS Code 和其他客户端：在标头中使用密钥

URL:    https://mcp.submitator.com/mcp
Header: Authorization: Bearer <your key>   (X-API-Key: <your key> works too)

Claude Code

claude mcp add --transport http submitator https://mcp.submitator.com/mcp \
  --header "Authorization: Bearer $SUBMITATOR_API_KEY"

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "submitator": {
      "url": "https://mcp.submitator.com/mcp",
      "headers": { "Authorization": "Bearer sbm_test_..." }
    }
  }
}

VS Code（.vscode/mcp.json）：VS Code 会要求输入密钥，并将其保存在文件之外。

{
  "inputs": [
    { "type": "promptString", "id": "submitator-key", "description": "Submitator API key", "password": true }
  ],
  "servers": {
    "submitator": {
      "type": "http",
      "url": "https://mcp.submitator.com/mcp",
      "headers": { "Authorization": "Bearer ${input:submitator-key}" }
    }
  }
}

其他通过 HTTP 连接的客户端使用相同的 URL 和标头。

远程服务不会在请求之间保留任何内容：它会将标头中的密钥或登录流程的访问令牌转发给 Submitator API，然后将其丢弃。服务无法读取或保存文件，因此 save_report_file 和本地图片路径仅适用于 npx 软件包。

工具

工具	功能
whoami	查看密钥所属的代理机构和模式、权限、剩余发布次数及每小时预算
list_projects, get_project	查找客户项目；完整读取单个项目
create_project, update_project, delete_draft	根据 URL 创建项目、更改项目字段、删除草稿
set_logo, add_screenshot, remove_image	使用公开 URL 或 npx 软件包指定的本地文件处理图片
preview_launch	免费试运行发布或添加操作，参数与实际操作相同：显示目录数量、缺失项、费用，以及自动选择目录的最高和中位 DR
find_directories, project_directories	搜索目录目录；查看某个项目的目录选项
launch_project	开始提交。会消耗一次发布次数；除非 confirm_selected 等于针对相同参数的 preview_launch 所显示的数量，否则不会执行
add_directories	使用已发布项目的免费额度，将项目添加到更多目录；同样需要通过数量检查
list_listings, list_events	跟踪收录情况和指定时间以来的变更
get_badge, verify_badge	获取客户网站的徽章安装代码，并检查徽章是否已安装
create_report, get_report, save_report_file	生成 PDF 或 XLSX 报告；使用 npx 软件包将报告保存到磁盘
get_share_link, create_share_link, delete_share_link	客户进度页面（仅适用于 Live 密钥）
advance_test_listing, set_test_launches	Test 模式辅助工具（仅适用于 Test 密钥）

提示词：launch_client_project 会逐步引导你完成发布；client_progress_update 会为客户起草一条不提及 Submitator 的说明。

密钥与安全

• 对 launch_project、add_directories 和 update_project 保持客户端的批准提示开启，不要将它们设为始终允许：启动项目会产生费用。这三种工具与所有会覆盖或删除数据，或提交到目录的工具一样，都带有 destructiveHint: true，因此会读取该提示的客户端会在每次调用前询问。仅添加或检查内容的工具，例如 create_project、add_screenshot 和 verify_badge，则带有 false。使用有效密钥时，支持向用户提问的客户端（MCP elicitation）也会在启动项目或添加内容前询问你，答案绝不会经过模型。远程服务不会保留会话，因此只有使用 MCP 协议 2026-07-28 的客户端会收到此问题。
• npx 软件包会从环境中读取密钥，并且只将其发送到 https://api.submitator.com。
• 本地图片只会从 SUBMITATOR_FILES_DIR（或客户端启动服务时所在的文件夹）读取，只接受真实的 PNG、JPEG、GIF 或 WebP 文件，绝不会通过链接读取。报告默认保存到 Downloads，且不会覆盖现有文件；包含登录凭据的报告不会保存在这里。
• 只检查状态的助手可以使用只读密钥：项目、列表、事件和现有报告。创建报告或客户端页面链接需要拥有完整权限的密钥。
• 登录凭据及其密码不会通过此服务公开。请在代理机构控制台中查看。
• 每次调用都会显示在 Developers, Request log 中，并附有以 mcp- 开头的请求 ID。你可以随时在那里撤销密钥。
• 请通过电子邮件向 [email protected] 报告漏洞，不要在公开 issue 中报告 （SECURITY.md）。

开发

npm install
npm test               # unit, contract and protocol tests
npm run build
npm run sync:openapi   # refresh openapi/v1.json and src/v1.d.ts from the public contract
npm run check:pack     # pack, install in an empty folder, run the stdio handshake

当 API 发布新版本时，运行 npm run sync:openapi 和 npm test，即可查看哪些新操作需要添加工具或添加到 EXCLUDED（src/tools/index.ts）。

许可证

MIT