MCP · SKILL

把证书平台
接进你的 Agent。

本站提供标准的 MCP(Model Context Protocol)服务:申请与续签证书、配置宝塔面板自动部署、管理 DNS 凭据、发起 SSL 体检、读取站内消息, 都能被 Cursor、Claude、Cherry Studio 或自建 Agent 直接调用。下方指南与 SKILL.md 保持同步更新。

  • Streamable HTTP · JSON-RPC 2.0
  • Bearer 令牌 + scope 授权
  • 45 个公开工具
  • 写操作强制 confirm
ENDPOINT

端点与鉴权

在线
端点
https://https.fohok.xin/mcp
传输
Streamable HTTP(浏览器打开本页是文档,POST 到同一路径才是 JSON-RPC)
鉴权
Authorization: Bearer fhk_live_xxx
协议版本
2025-06-18(兼容 2025-03-26 / 2024-11-05)
{
  "mcpServers": {
    "fhk-ssl": {
      "type": "http",
      "url": "https://https.fohok.xin/mcp",
      "headers": { "Authorization": "Bearer fhk_live_xxx" }
    }
  }
}
QUICK START

三步接入

01
签发令牌登录后在「MCP 接入」页创建令牌,按需勾选权限;明文只显示一次。
02
填入客户端把端点和 Bearer 令牌写进客户端配置,或直接使用上方 JSON 片段。
03
开始调用先调 platform_info 探测能力,再按需申请证书、部署宝塔或体检。
TOOLS

可用工具

45 个

工具按令牌 scope 返回;管理端工具仅管理员令牌可见,未在下方列出。

平台

platform_info

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

平台概况

platform_quota

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

配额用量

ssl_examine

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

SSL 在线体检

task_list

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

异步任务列表

task_get

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

异步任务详情

证书

cert_list

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

证书列表

cert_get

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

证书详情

cert_status

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

证书进度

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 查询进度。

申请证书

cert_verify

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

重新验证

cert_renew

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

续签证书

cert_revoke

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

吊销证书 · 需确认

cert_delete

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

删除证书 · 需确认

cert_auto_renew

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

自动续签开关

cert_export

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

导出证书

cert_bt_bind

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

绑定宝塔部署 · 需确认

cert_bt_deploy

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

立即部署到宝塔 · 需确认

sync_target_list

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

同步目标列表

sync_target_create

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

添加同步目标 · 需确认

sync_target_test

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

测试同步目标

sync_target_delete

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

删除同步目标 · 需确认

cert_sync_list

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

证书同步状态

cert_sync_bind

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

绑定证书同步 · 需确认

cert_sync_run

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

立即同步证书 · 需确认

cert_sync_unbind

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

解除证书同步 · 需确认

任务

order_list

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

任务列表

order_cancel

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

取消任务 · 需确认

宝塔

bt_panel_list

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

宝塔面板列表

bt_panel_sites

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

宝塔站点列表

bt_panel_ssl_info

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

宝塔站点证书

bt_panel_cert_store

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

宝塔证书夹

bt_panel_create

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

连接宝塔面板 · 需确认

bt_panel_update

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

编辑宝塔面板 · 需确认

bt_panel_test

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

测试并同步站点

bt_panel_delete

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

删除宝塔面板 · 需确认

DNS

dns_account_list

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

DNS 账号列表

dns_account_create

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

新增 DNS 账号

dns_account_test

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

测试 DNS 账号

dns_account_delete

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

删除 DNS 账号 · 需确认

账号

account_get

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

账号信息

account_update

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

更新账号资料 · 需确认

消息

notice_announcements

读取已发布的平台公告。

公告列表

notice_messages

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

站内信列表

notice_read

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

标记已读

notice_read_all

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

全部已读
SCOPES

权限范围

令牌权限不会超过账号自身;高危权限需要显式勾选。

平台信息 · platform:read SSL 检测 · tools:examine 证书读取 · certs:read 证书操作 · certs:write 导出私钥 · certs:secret 任务读取 · orders:read 任务操作 · orders:write DNS 账号读取 · dns:read DNS 账号写入 · dns:write 宝塔读取 · bt:read 宝塔写入 · bt:write 账号读取 · account:read 账号写入 · account:write 公告读取 · notices:read 消息已读 · notices:write

请确认操作

请检查下面的操作说明,确认后才会执行。