---
name: fhk-ssl
description: 通过 FHK-SSL证书签发平台 申请、续签、吊销与管理 TLS 证书，配置宝塔面板自动部署，维护 DNS 凭据与站内通知，并可对任意公网域名做 TLS 体检。
---

# FHK-SSL证书签发平台 MCP

- Endpoint: `https://https.fohok.xin/mcp`
- Protocol: Streamable HTTP + JSON-RPC 2.0（无状态；initialize 建议 `2025-06-18`）
- Auth: `Authorization: Bearer fhk_live_…`，令牌在 https://https.fohok.xin/account/mcp 自助签发
- 令牌可设置 IP / CIDR 白名单；写操作必须带 `confirm: true`；私钥导出还需要 `certs:secret` 权限

## Client config

```json
{
  "mcpServers": {
    "fhk-ssl": {
      "type": "http",
      "url": "https://https.fohok.xin/mcp",
      "headers": { "Authorization": "Bearer fhk_live_xxx" }
    }
  }
}
```

## Tools

以下为普通账号可用的工具；管理端工具仅管理员令牌可见，不在本文档列出。

### `platform_info` — 平台概况

返回站点信息、可用 CA、验证方式、配额策略与可检测端口，适合作为首次调用的能力探测。

- 权限：`platform:read`
- 参数：无

### `platform_quota` — 配额用量

当前账号的证书配额、已用数量、按状态分布与进行中的签发任务数。

- 权限：`platform:read`
- 参数：无

### `ssl_examine` — SSL 在线体检

对外部域名或公网 IP 发起真实 TLS 握手，返回协议、套件、证书链、到期剩余天数与风险项。

- 权限：`tools:examine`
- 参数：`target`（string，必填）、`port`（integer）

### `task_list` — 异步任务列表

查看当前账号最近的后台任务（证书申请、任务推进、宝塔部署、站内信邮件）及结果。

- 权限：`platform:read`
- 参数：`limit`（integer）

### `task_get` — 异步任务详情

按任务 ID 查看后台任务的状态、结果和错误信息。

- 权限：`platform:read`
- 参数：`task_id`（integer，必填）

### `cert_list` — 证书列表

分页列出当前账号名下未删除的证书，可按状态过滤或按域名搜索。

- 权限：`certs:read`
- 参数：`status`（string）、`q`（string）、`page`（integer）、`per_page`（integer）

### `cert_get` — 证书详情

按 ID 查看单张证书的完整信息、标识列表、最近任务与验证记录（不含私钥）。

- 权限：`certs:read`
- 参数：`certificate_id`（integer，必填）

### `cert_status` — 证书进度

轮询单张证书的状态与最近一次任务进度，适合签发后等待结果。

- 权限：`certs:read`
- 参数：`certificate_id`（integer，必填）

### `cert_create` — 申请证书

创建签发任务并转入后台异步执行。identifiers 支持域名、通配符与公网 IP（IP 仅 Let's Encrypt）；method 可选 cname / dns / edge / http，edge 需在 dns_account_id 传 ESA / EdgeOne 账号。可同时指定宝塔面板部署目标（bt_panel_id / bt_sites / bt_all_sites），用 task_get 查询进度。

- 权限：`certs:write`
- 参数：`identifiers`（array，必填）、`provider`（string）、`method`（string）、`dns_account_id`（integer）、`key_type`（string）、`auto_renew`（boolean）、`bt_panel_id`（integer）、`bt_sites`（array）、`bt_all_sites`（boolean）、`bt_auto_deploy`（boolean）、`bt_force_https`（boolean）

### `cert_verify` — 重新验证

对等待验证的证书重新发起验证流程。

- 权限：`certs:write`
- 参数：`certificate_id`（integer，必填）

### `cert_renew` — 续签证书

为现有证书创建续签任务，保留原标识与验证方式。

- 权限：`certs:write`
- 参数：`certificate_id`（integer，必填）

### `cert_revoke` — 吊销证书

向 CA 提交吊销；吊销成功后证书记录会自动删除并释放配额。操作不可撤销，需传 confirm=true。

- 权限：`certs:write`；需要 `confirm=true`
- 参数：`certificate_id`（integer，必填）、`reason`（integer）、`confirm`（boolean）

### `cert_delete` — 删除证书

软删除证书记录并释放配额，私钥与 PEM 一并清理。需传 confirm=true。

- 权限：`certs:write`；需要 `confirm=true`
- 参数：`certificate_id`（integer，必填）、`confirm`（boolean）

### `cert_auto_renew` — 自动续签开关

开启或关闭某张证书的到期自动续签。

- 权限：`certs:write`
- 参数：`certificate_id`（integer，必填）、`enabled`（boolean）

### `cert_export` — 导出证书

返回 PEM 内容；默认不含私钥，传 include_private_key=true 需要令牌具备 certs:secret。

- 权限：`certs:read`
- 参数：`certificate_id`（integer，必填）、`format`（string）、`include_private_key`（boolean）

### `order_list` — 任务列表

当前账号的签发任务队列，可按进行中过滤。

- 权限：`orders:read`
- 参数：`active_only`（boolean）、`page`（integer）、`per_page`（integer）

### `order_cancel` — 取消任务

取消进行中的签发任务并清理已写入的 DNS 记录。需传 confirm=true。

- 权限：`orders:write`；需要 `confirm=true`
- 参数：`order_id`（integer，必填）、`confirm`（boolean）

### `bt_panel_list` — 宝塔面板列表

列出当前账号已连接的宝塔面板、站点数量、连通状态与关联证书数；接口密钥永不返回。

- 权限：`bt:read`
- 参数：无

### `bt_panel_sites` — 宝塔站点列表

读取指定面板已同步的站点列表（名称、路径、备注），用于选择证书部署目标。

- 权限：`bt:read`
- 参数：`panel_id`（integer，必填）

### `bt_panel_ssl_info` — 宝塔站点证书

读取指定站点当前生效的 SSL 证书信息（到期时间、签发者、强制 HTTPS 与面板证书类型），用于排查部署后是否真正切换。

- 权限：`bt:read`
- 参数：`panel_id`（integer，必填）、`site_name`（string，必填）

### `bt_panel_cert_store` — 宝塔证书夹

读取面板证书夹的证书记录，用于核对面板对证书来源、品牌和分类的显示。

- 权限：`bt:read`
- 参数：`panel_id`（integer，必填）

### `bt_panel_create` — 连接宝塔面板

保存一个宝塔面板连接（API 密钥加密存储），并立即同步站点。需要 bt:write 与 confirm=true。

- 权限：`bt:write`；需要 `confirm=true`
- 参数：`name`（string）、`remark`（string）、`base_url`（string，必填）、`api_key`（string，必填）、`verify_tls`（boolean）、`allow_http`（boolean）、`confirm`（boolean）

### `bt_panel_update` — 编辑宝塔面板

修改面板名称、备注、地址或 API 密钥；连接参数变化时会先测试并同步站点。需要 confirm=true。

- 权限：`bt:write`；需要 `confirm=true`
- 参数：`panel_id`（integer，必填）、`name`（string）、`remark`（string）、`base_url`（string）、`api_key`（string）、`verify_tls`（boolean）、`allow_http`（boolean）、`confirm`（boolean）

### `bt_panel_test` — 测试并同步站点

用已保存的凭据连接面板，刷新站点缓存与连通状态。

- 权限：`bt:write`
- 参数：`panel_id`（integer，必填）

### `bt_panel_delete` — 删除宝塔面板

删除面板连接并解除关联证书的自动部署，证书本身不受影响。需要 confirm=true。

- 权限：`bt:write`；需要 `confirm=true`
- 参数：`panel_id`（integer，必填）、`confirm`（boolean）

### `cert_bt_bind` — 绑定宝塔部署

为证书设置宝塔面板与目标站点，或多选站点；panel_id=0 表示解除绑定。通配符证书可传 all_sites=true 选择全部站点。需要 confirm=true。

- 权限：`certs:write`；需要 `confirm=true`
- 参数：`certificate_id`（integer，必填）、`panel_id`（integer）、`sites`（array）、`all_sites`（boolean）、`auto_deploy`（boolean）、`force_https`（boolean）、`confirm`（boolean）

### `cert_bt_deploy` — 立即部署到宝塔

把证书部署提交为后台异步任务，并按设置开启强制 HTTPS；返回 async_task_id，可用 task_get 查询结果。需要 confirm=true。

- 权限：`certs:write`；需要 `confirm=true`
- 参数：`certificate_id`（integer，必填）、`confirm`（boolean）

### `dns_account_list` — DNS 账号列表

列出已绑定的 DNS 服务商账号与最近一次连通状态，密钥永不返回。

- 权限：`dns:read`
- 参数：无

### `dns_account_create` — 新增 DNS 账号

保存一份阿里云或腾讯云 DNS 凭据（加密存储），供 DNS 验证自动写入使用。

- 权限：`dns:write`
- 参数：`provider`（string，必填）、`label`（string）、`access_key`（string，必填）、`access_secret`（string，必填）

### `dns_account_test` — 测试 DNS 账号

调用服务商接口验证凭据是否可用，并记录最近状态。

- 权限：`dns:write`
- 参数：`dns_account_id`（integer，必填）

### `dns_account_delete` — 删除 DNS 账号

删除凭据；若仍有证书引用该账号会被拒绝。需传 confirm=true。

- 权限：`dns:write`；需要 `confirm=true`
- 参数：`dns_account_id`（integer，必填）、`confirm`（boolean）

### `sync_target_list` — 同步目标列表

列出宝塔 / 阿里云 ESA / 腾讯云 EdgeOne 同步目标与最近连通状态；密钥永不返回。

- 权限：`certs:read`
- 参数：无

### `sync_target_create` — 添加同步目标

保存 ESA 或 EdgeOne 凭据（加密存储）并验证；凭据会同时登记为边缘平台验证账号。需要 confirm=true。

- 权限：`certs:write`；需要 `confirm=true`
- 参数：`channel`（string，必填）、`name`（string）、`access_key`（string，必填）、`access_secret`（string，必填）、`scope_id`（string）、`confirm`（boolean）

### `sync_target_test` — 测试同步目标

用已保存的凭据连接 ESA / EdgeOne 并刷新状态。

- 权限：`certs:write`
- 参数：`target_id`（integer，必填）

### `sync_target_delete` — 删除同步目标

删除同步目标并解除所有证书绑定，证书本身不受影响。需要 confirm=true。

- 权限：`certs:write`；需要 `confirm=true`
- 参数：`target_id`（integer，必填）、`confirm`（boolean）

### `cert_sync_list` — 证书同步状态

查看某张证书已绑定的同步目标、主机名、自动同步开关与最近同步结果。

- 权限：`certs:read`
- 参数：`certificate_id`（integer，必填）

### `cert_sync_bind` — 绑定证书同步

把证书绑定到同步目标；hosts 为宝塔站点名或 EdgeOne 加速域名（ESA 可留空）。需要 confirm=true。

- 权限：`certs:write`；需要 `confirm=true`
- 参数：`certificate_id`（integer，必填）、`target_id`（integer，必填）、`hosts`（array）、`auto_sync`（boolean）、`confirm`（boolean）

### `cert_sync_run` — 立即同步证书

把证书推送到指定同步绑定；可用 binding_id 或 target_id 指定。需要 confirm=true。

- 权限：`certs:write`；需要 `confirm=true`
- 参数：`certificate_id`（integer，必填）、`binding_id`（integer）、`target_id`（integer）、`confirm`（boolean）

### `cert_sync_unbind` — 解除证书同步

解除证书与同步目标的绑定，不删除目标配置。需要 confirm=true。

- 权限：`certs:write`；需要 `confirm=true`
- 参数：`certificate_id`（integer，必填）、`binding_id`（integer，必填）、`confirm`（boolean）

### `account_get` — 账号信息

当前令牌所属用户的资料、通知开关、登录方式与配额。

- 权限：`account:read`
- 参数：无

### `account_update` — 更新账号资料

修改昵称与邮件通知开关；不提供密码修改。需传 confirm=true。

- 权限：`account:write`；需要 `confirm=true`
- 参数：`name`（string）、`notify_email`（boolean）、`confirm`（boolean）

### `notice_announcements` — 公告列表

读取已发布的平台公告。

- 权限：`notices:read`
- 参数：`limit`（integer）

### `notice_messages` — 站内信列表

读取当前账号的站内信与未读数。

- 权限：`notices:read`
- 参数：`limit`（integer）

### `notice_read` — 标记已读

把指定站内信标记为已读。

- 权限：`notices:write`
- 参数：`message_id`（integer，必填）

### `notice_read_all` — 全部已读

把当前账号所有站内信标记为已读。

- 权限：`notices:write`
- 参数：无

## Rules

1. 先调用 `platform_info` 了解可用 CA 与限制，再用 `cert_list` / `platform_quota` 查看现状。
2. 申请前确认域名未被其他账号占用：平台会拒绝对已归属其他账号的域名重复签发。
3. 签发、检测推进与宝塔部署是异步的：`cert_create` / `cert_verify` / `cert_renew` / `cert_bt_deploy` 返回 `async_task_id`，用 `task_get` 查询结果，或继续用 `cert_status` / `order_list` 查看证书进度。
4. 私钥仅在 `certs:secret` 且 `include_private_key=true` 时返回，不要写进日志或提交到仓库。
5. 证书创建后 1 小时仍未完成验证会被自动删除，需重新发起。
6. 宝塔部署：先用 `bt_panel_list` / `bt_panel_sites` 找到面板和站点，再调用 `cert_bt_bind` 绑定目标，调用 `cert_bt_deploy` 立即部署；`cert_create` 也支持直接传 `bt_panel_id` 与 `bt_sites`。
7. 通配符证书绑定部署时可传 `all_sites=true` 选择全部站点，单张证书最多 50 个站点；面板连接的新增、编辑与删除需要 `bt:write` 权限。
