【企业建站】文章 MCP 接入指南-开放文档

2026-09-24

来源：雨科网建站

适用对象：网站管理员、负责系统接入的技术人员或AI助手

一、产品介绍

雨科网建站平台文章 MCP 为 AI 工具和业务系统提供文章查询、分类查询、新增文章及修改发布时间的能力。您可以在网站后台申请使用，开启 AI 接口开放后，通过支持远程 MCP 的客户端或自建程序接入。

例如，接入后可以向 AI 工具提出以下请求：

“查找标题中包含‘新品’的文章。”
“查看这个网站有哪些文章分类。”
“将我提供的内容新增为一篇网站文章。”
“修改指定文章的发布时间。”

实际执行前，客户端需要根据工具参数补齐相应信息。新增文章和修改发布时间会改变站点内容，建议在客户端设置执行前确认。

二、能力范围

工具名称	功能
getNewsInfo	按文章标题模糊查询文章列表，获取摘要、详情及元数据
getNewsGroupList	获取当前站点文章分类列表，包括未分类（id=0）
addNews	新增文章，支持封面外链、分类、来源、作者、自定义地址、SEO 信息及发布时间
updateNewsDate	修改已有文章的发布时间

当前工具列表未提供文章删除或已有文章标题、正文编辑工具。请以实际 tools/list 返回结果为准。

三、开通与准备

登录雨科网建站后台，在网站后台开启接口能力，并获取您的 API Key。（注册后台搭建和查看）
准备支持远程 MCP 接入的客户端，或由技术人员实现 MCP 客户端。
按下文填写服务地址，验证连接并获取工具列表。

注意：API Key 用于接口鉴权。请将其作为敏感凭证保管，不要放入公开文档、前端页面、代码仓库或公开截图。分享连接配置及排查日志前，应隐藏 URL 中的 key 值。

四、服务地址与鉴权

4.1 MCP 接入地址

https://jzmcp.webportal.top/mcp?key=<YOUR_API_KEY>

将 <YOUR_API_KEY> 替换为您在后台获取的 API Key。key 通过 URL 查询参数传入；自行拼接 URL 时，应对参数值进行 URL 编码。

4.2 查询mcp能力说明

GET https://jzmcp.webportal.top/capabilities

该接口无需 API Key，可用于了解服务用途、鉴权方式和工具概要。它不返回完整的工具参数定义，也不代表您已获得站点操作权限。

获取完整工具定义（tools/list）和执行业务工具（tools/call）均需鉴权，且站点需开启 AI 接口开放。

五、在 AI 客户端中接入

在客户端的 MCP 服务配置中，新增远程服务，并填写上述包含 API Key 的完整接入地址。各客户端的入口名称及配置格式可能不同，请参考您使用的客户端说明。

接入后，建议依次完成以下验证：

建立 MCP 连接，确认初始化成功。直接发送mcp地址给您的Agent，委托ai为您构建链接即可；
跟随agent客户端的指引配置APIkey，基于安全考虑，不建议直接发送秘钥给ai。
获取工具列表，确认能识别本文列出的 4 个工具。
调用 getNewsGroupList，确认可以读取当前站点分类。
使用一个已知文章标题调用 getNewsInfo，验证查询结果。

初次验证建议先使用查询工具。需要新增文章或修改发布时间时，再提供完整参数并确认执行。

六、技术接入流程

以下内容供自建智能体客户端的技术人员参考。

6.1 请求地址与请求头

以下请求均发送至：

POST https://jzmcp.webportal.top/mcp?key=<YOUR_API_KEY>
Content-Type: application/json
Accept: application/json, text/event-stream

服务可能通过 JSON 或 SSE（text/event-stream）返回数据。客户端应根据实际响应类型解析，不能假定每个响应都可以直接作为单个 JSON 对象读取。

6.2 初始化

请求体：

{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2024-11-05",
"capabilities": {},
"clientInfo": {
"name": "your-mcp-client",
"version": "1.0.0"
}
}
}

初始化成功后，发送初始化完成通知。通知不包含 id：

{
"jsonrpc": "2.0",
"method": "notifications/initialized"
}

本次接入验证中，初始化返回 HTTP 200，初始化完成通知返回 HTTP 202。若服务在初始化响应中返回 Mcp-Session-Id，后续请求应携带该会话标识。

6.3 获取工具定义

{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}

工具定义位于 JSON-RPC 响应的 result.tools 中。每个工具提供 name、description 和 inputSchema。请使用 inputSchema 校验参数，并以服务实际返回的定义为准。

6.4 调用工具

调用方法统一为 tools/call，使用 params.name 指定工具，使用 params.arguments 提供业务参数。

以下示例查询文章分类，不传入任何业务参数：

{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "getNewsGroupList",
"arguments": {}
}
}

客户端应同时处理 HTTP 错误、JSON-RPC error，以及工具结果中可能出现的 isError。HTTP 200 本身不等于业务操作成功。

七、工具参数参考

以下参数定义依据当前服务实际返回的 tools/list 整理。所有工具均设置 additionalProperties: false，请勿提交定义以外的参数。

7.1 查询文章：getNewsInfo

按文章标题模糊查询文章列表，返回文章标题、摘要、详情及元数据。

参数	类型	必填	说明
title	string	是	用于匹配文章标题的查询文本

调用示例：

{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "getNewsInfo",
"arguments": {
"title": "新品"
}
}
}

当前工具参数未提供分页、排序或按文章 ID 查询选项。

7.2 查询文章分类：getNewsGroupList

获取当前站点文章分类列表，包含未分类（id=0）。该工具无业务参数，arguments 传入空对象 {}，完整示例见第 6.4 节。

新增文章前，可先使用此工具获取分类信息。

7.3 新增文章：addNews

向站点新增一篇文章。

参数	类型	必填	说明
title	string	是	文章标题
content	string	是	文章正文
summary	string	是	文章摘要
coverUrl	string	是	封面图片外链
groupIds	string	是	文章分类 ID 参数
source	string	是	文章来源
author	string	是	文章作者
cusUrl	string	是	自定义地址
browserTitle	string	是	SEO 页面标题
seoKeyword	string	是	SEO 关键词
seoDesc	string	是	SEO 描述
date	string	是	文章发布时间

当前 Schema 将以上 12 个字段全部列为必填，客户端应完整提交。字段必填表示不可省略，并不表示空字符串一定会被接受。

以下为参数结构模板，包含的占位符须按平台支持的业务规则替换，不能直接执行：

{
"jsonrpc": "2.0",
"id": 5,
"method": "tools/call",
"params": {
"name": "addNews",
"arguments": {
"title": "新品发布介绍",
"content": "<文章正文>",
"summary": "介绍本次新品的主要特点。",
"coverUrl": "<可访问的封面图片URL>",
"groupIds": "<按支持格式填写的分类ID>",
"source": "企业官网",
"author": "内容团队",
"cusUrl": "<符合平台规则的自定义地址>",
"browserTitle": "新品发布介绍",
"seoKeyword": "新品",
"seoDesc": "了解本次新品的主要特点。",
"date": "<按支持格式填写的发布时间>"
}
}
}

7.4 修改发布时间：updateNewsDate

修改已有文章的发布时间。

参数	类型	必填	说明
newsId	integer	是	待修改文章的 ID
date	string	是	新的发布时间

以下为参数结构模板。12345 仅为示例文章 ID，执行前须替换为目标站点的实际文章 ID，并替换日期占位符：

{
"jsonrpc": "2.0",
"id": 6,
"method": "tools/call",
"params": {
"name": "updateNewsDate",
"arguments": {
"newsId": 12345,
"date": "<按支持格式填写的发布时间>"
}
}
}

该工具用于修改发布时间。不能仅根据工具名称推断其支持定时发布、下架或发布状态切换。