使用 MCP 创建自定义项目

BLSFlow MCP 可以让 Codex 等支持 MCP 的 AI 工具，在完成网页登录授权后，协助你收集项目资料并创建自定义项目、矿池和运行脚本。

如果你希望完全手工创建项目或需要深入修改 Shell 脚本，请同时阅读创建自定义项目。

MCP 适合做什么

你只需描述币种和矿工软件，AI 可以帮助整理官网、代码仓库、矿池参数、Linux 矿工下载地址和启动参数，并通过 MCP 写入你的 BLSFlow 私有项目。

使用前准备

开始前需要满足：

• 已注册并可以登录 BLSFlow 控制台。
• 已安装支持远程 MCP 和 OAuth 的 Codex。
• 已确认项目官网、官方代码仓库或可信的矿工软件下载来源。
• 已准备矿池地址以及钱包、worker、密码等运行参数的格式。

敏感信息

不要让 AI 猜测钱包地址、密码或密钥，也不要把这些用户专属信息写死在运行脚本中。它们应作为矿池运行参数，在创建运行配置时由用户填写。

在 Codex 中添加 BLSFlow MCP

在 ~/.codex/config.toml 中加入：

[mcp_servers.blsflow]
url = "https://mcp.blsflow.com/mcp"
auth = "oauth"
default_tools_approval_mode = "writes"

也可以使用 Codex MCP 管理命令添加服务器；无论采用哪种方式，最终地址都应为：

https://mcp.blsflow.com/mcp

检查配置是否已被识别：

codex mcp list

登录并授权

执行：

codex mcp login blsflow

Codex 会打开 BLSFlow 控制台授权页。未登录时，先在 https://console.blsflow.com/login 登录，然后返回授权页确认以下权限：

创建自定义项目、矿池和私有运行脚本。

授权完成后，浏览器会跳转到 Codex 在本机启动的回调地址。回到终端，确认登录命令成功结束。

无需复制登录 Token

OAuth 授权成功后，Codex 使用短期 MCP access token 调用工具。你不需要把控制台登录 token 粘贴到聊天内容或 Codex 配置中。

让 AI 创建项目

在 Codex 中说明你要创建的项目，并尽量提供可靠来源。例如：

请通过 BLSFlow MCP 创建一个自定义项目：

- 项目名称：Example Coin
- 项目符号：example
- 算法：randomx
- 官网：https://example.org
- GitHub：https://github.com/example/example
- 支持系统：Ubuntu 22.04+、Ubuntu 24.04+
- 矿池：stratum+tcp://pool.example.org:3333
- Linux 矿工下载地址：https://example.org/releases/miner-linux.tar.gz
- 可执行文件：example-miner
- 启动参数：-o 矿池地址、-u 钱包地址.worker、-p x

钱包地址不要写死，请定义为必填运行参数。创建前先向我确认缺少的信息。

如果只知道币种名称，可以先要求 AI 查找资料，但创建前应核对来源：

请先查找 Example Coin 的官方网站、官方代码仓库、Linux CPU 矿工、矿池连接格式和启动参数。
不要立即创建，先列出来源和待我确认的信息。

AI 应向你确认的信息

一次完整创建至少包含以下内容：

类别	必要信息	注意事项
项目	名称、项目符号、官网、GitHub、支持系统	项目符号建议使用小写字母、数字和短横线
挖矿	算法、官方 Linux 矿工下载地址、可执行文件名	优先使用项目官方发布地址
矿池	矿池名称和连接地址	确认协议、主机和端口完整
参数	钱包、worker、密码等参数定义	钱包和密钥不得由 AI 猜测
启动	矿工启动参数及顺序	明确每个参数对应的占位符
算力	日志中的算力格式	特殊日志格式可能需要自定义解析脚本

当资料不足时，应让 AI 继续询问，而不是使用演示地址或伪造参数。

MCP 会创建什么

确认写入后，AI 通常调用 create_custom_project，一次创建：

1. 当前账号的私有自定义项目。
2. 至少一个项目矿池。
3. 矿池需要的钱包、worker 等参数定义。
4. 与矿池对应的私有运行脚本。

推荐让 AI 提交结构化的 managed_miner 配置。MCP 会生成安装矿工、创建 systemd 服务、切换项目和解析通用算力的完整脚本。如果矿工已经安装且目标可执行文件存在，安装函数会直接复用，不重复下载。

只有以下情况通常需要提供完整 script_content：

• 下载包需要特殊解压或编译流程。
• 矿工依赖额外系统组件。
• 启动前需要生成复杂配置文件。
• 日志格式无法使用通用算力解析规则。

这时请参考创建自定义项目中的脚本契约，不要修改 BLSFlow 通用切换流程。

为已有项目补充矿池

如果项目已经创建，但缺少矿池或运行脚本，可以告诉 Codex：

请通过 BLSFlow MCP 给项目 example 补充矿池和运行脚本。
矿池地址是 stratum+tcp://pool.example.org:3333。
钱包作为必填参数，worker 自动使用设备标识。提交前先展示启动参数让我确认。

AI 会使用 add_project_pool，不会重复创建项目主记录。

创建后验收

先在 BLSFlow 控制台确认：

• [ ] 项目名称、项目符号、算法和支持系统正确。
• [ ] 矿池名称、协议、主机和端口正确。
• [ ] 钱包等用户配置被定义为参数，没有写死在脚本中。
• [ ] 运行脚本属于当前用户的私有模板。
• [ ] 矿工下载地址和可执行文件名来自可信来源。

然后创建该项目的运行配置，只在一台测试设备上执行切换。登录设备检查：

systemctl status blsflow-miner-example.service --no-pager
journalctl -u blsflow-miner-example.service -n 100 --no-pager
bash /opt/blsflow/run/example/hashrate.sh

确认矿工正常连接、钱包和 worker 正确，并且 hashrate.sh 输出单位为 kH/s 的数值后，再用于更多设备或智能调度。

常见问题

No authorization support detected

Codex 没有发现 OAuth 元数据。依次检查：

curl https://mcp.blsflow.com/.well-known/oauth-protected-resource/mcp
curl https://mcp.blsflow.com/.well-known/oauth-authorization-server

两个地址都应返回 JSON。如果返回 Nginx 404，说明 MCP 域名只代理了 /mcp，还需要把 /.well-known/* 和 /oauth/* 转发到 MCP 服务。

授权页提示 login_required

先确认控制台会话没有过期，可以正常打开控制台页面。如果平台管理员正在排查部署，还应确认 MCP 配置中的 API 地址为：

{
  "blsflow": {
    "api_base_url": "https://api.blsflow.com"
  }
}

修改配置后需要重启 MCP 服务。不要把该地址配置成 https://console.blsflow.com，后者是门户页面域名。

AI 没有调用 BLSFlow 工具

执行 codex mcp list 检查 blsflow 是否启用，并重启 Codex CLI、桌面端或 IDE 扩展。进入 Codex 后也可以查看 MCP 工具列表，确认存在 create_custom_project 和 add_project_pool。

创建成功但无法启动矿工

优先检查矿工下载地址、压缩包结构、可执行文件名和启动参数。如果项目需要特殊安装或算力解析，请按照创建自定义项目手工完善脚本，并先在单台设备验证。

安全建议

• 只授权你信任的 Codex 客户端和本机回调地址。
• 不要在聊天、脚本或项目介绍中写入钱包私钥、交易所密钥或控制台 token。
• 软件地址优先采用项目官网或官方 GitHub Release。
• AI 创建前先确认资料，创建后再由人工核对控制台记录。
• 新项目始终先在单台测试设备验收，再扩大使用范围。