Notion MCP 服务器集成工具

Notion MCP 服务器与 ServiceNow 的集成

概述

本指南将逐步介绍如何在ServiceNow AI Agent中设置并使用模型上下文协议（MCP）工具，以扩展其在ServiceNow平台之外的功能。 按照以下步骤操作，您将学会如何将一个AI代理连接到外部MCP服务器（如smittery.ai），并启用该代理进行上下文推理、调用外部API，并将结构化结果返回到ServiceNow中。

本指南中的示例用例展示了如何构建一个“经验教训AI代理”，该代理能够分析已解决的重大事件，并自动生成关于根本原因、解决方案和预防措施的总结。然后，该AI代理使用MCP工具将这些发现直接发布到Notion数据库中——这展示了ServiceNow AI代理如何利用外部系统实现智能、自动的知识捕获。

完成此设置后，您将拥有一个可以正常工作的MCP（可能是指某种系统或服务的缩写，具体需根据上下文确定）集成，其中：

• ServiceNow AI Agent 调用 MCP 客户端以与您的 MCP 服务器进行通信。
• MCP服务器（例如，smittery.ai）使用大型语言模型（LLM）或API调用来处理请求。
• 结果被返回到ServiceNow，并以清晰、可操作的形式展示给用户。

本README文件包含了所有必需的配置步骤、示例有效载荷以及截图，以便您能够复制并调整集成方案，以适应您自己的AI Agent用例。

先决条件

在开始之前，请确保你已准备好以下物品：

1. ServiceNow 实例访问

您需要访问一个已启用Now Assist for Creator或AI Agent Studio的ServiceNow实例。

• 确保您的用户角色包含创建和配置AI代理及MCP工具的权限。
• 通常，管理员或AI维护员角色就足够了。
• 确认您的实例中已激活AI框架和MCP客户端插件。

2. 集成MCP的Notion账户

• 如果你还没有Notion账户，请创建一个免费账户。
• 在ServiceNow中设置MCP工具时，您将通过OAuth流程使用您的Notion账户进行身份验证。
• 确保您有一个Notion数据库或页面，用于AI代理创建新的“经验教训”条目。

3. 对AI代理配置的基本了解

• 熟悉在Agent Studio中创建AI代理并添加新的MCP工具。
• 了解如何定义输入和输出参数（例如，事件编号、简要描述、经验教训链接），并在代理提示中引用它们。

配置步骤

步骤1：在ServiceNow中配置您的MCP服务器

1. 在开始之前，请在浏览器中登录您的Notion账户
2. 登录到您的ServiceNow实例
3. 进入AI Agent Studio -> 选择“设置”选项卡 -> “托管的MCP服务器”
4. 点击“新建”并添加Notion MCP服务器： https://mcp.notion.com/mcp 并点击“下一步”

5. 确保已选择“动态客户端注册”，并且“授权URL”、“令牌URL”和“令牌撤销URL”已自动填充。点击“添加”

6. 点击“授权”按钮请求OAuth令牌。这将在您的浏览器中链接到Notion的授权页面。

7. 通过点击“我确认此可信URL”复选框并点击继续来授权Notion MCP服务器

构建一个示例代理

“经验教训”AI代理通过将ServiceNow中已解决的重大事件的关键细节转化为结构化摘要，并直接发布到Notion中，实现了事后审查过程的自动化。该代理无需人工编写回顾性文档，而是智能地分析事件记录，提取相关信息（如简要描述、工作笔记、解决详情、分配组历史记录和根本原因），并利用AI生成一份简洁的“经验教训”报告。这使团队能够专注于预防和改进，同时确保每个重大事件都能得到一致且全面的记录和组织内部的共享。

当用户通过聊天命令或主要事件记录中的按钮调用代理时，ServiceNow AI代理会从事件中收集上下文数据，并安全地将其发送到连接至Notion MCP服务器的MCP客户端。MCP服务器使用嵌入式语言模型或外部大型语言模型（如OpenAI或本地模型）处理这些数据，以解释事件经过、总结影响和解决方案，并提出预防建议。处理结果将以Markdown格式的结构化文本返回，准备发布。

接下来，MCP服务器对Notion API进行身份验证调用，在指定的“ - “经验教训”笔记。页面标题包含事件编号（例如，“INC0012345 – 经验教训”），内容会自动填充事件摘要、根本原因、解决方案、预防措施和关键收获等部分。一旦成功创建，MCP服务器会将Notion页面的URL返回给ServiceNow，完成整个往返过程。

最后，AI代理向用户确认摘要已发布，并提供一个链接以便在Notion中查看文档。这通过将ServiceNow中的操作数据与Notion中的协作文档相连接，完成了整个流程的闭环。其结果是一个无缝的工作流程，能够捕捉机构知识，提高透明度，并使团队能够在每次重大事件后不断学习，而无需手动操作或丢失上下文信息。

代理设置

经验教训收集者/学习代理

AI代理描述

将解决的重大事件记录转化为简洁、可操作的“经验教训”总结。利用人工智能分析事件数据，生成Markdown报告，并直接发布到Notion以供组织学习。专为寻求简化回顾性文档编制并高效分享见解的IT运维团队设计。

AI代理角色

在ServiceNow中，通过提取、分析和总结已解决重大事件的关键细节，自动化事件后评审流程。生成结构化的“经验教训”报告，并将其发布到Notion，确保跨团队的一致文档记录和知识共享。作为运营数据与协作文档之间的桥梁，促进透明度和持续改进。

步骤列表

1. 使用事件编号从ServiceNow中获取已解决的重大事件的详细信息。
2. 从事件记录中提取关键字段，包括简短描述、工作备注、解决详情、分配组历史以及根本原因。
3. 使用人工智能语言模型分析提取的数据，以解读事件、总结影响并确定解决步骤。
4. 生成一个结构化的“经验教训”报告，采用Markdown格式，并包含以下部分：事件概述、根本原因、解决方案、预防措施和关键收获。
5. 在指定的Notion数据库中创建一个新页面，以事件编号为标题，以生成的报告为内容。
6. 将Notion页面URL返回给ServiceNow，并向用户显示确认信息。

访问

• 谁可以访问： 任何已认证用户
• 代理将以以下方式运行： 动态用户

工具

获取事件详情

• 类型： 记录操作
• 工具描述： 这个工具将提取包含事件详情的事件记录以供分析。
• 输入：
  • 名称：事件编号
  • 描述：事件编号
• 表格： 事件
• 选择操作： 查询记录
• 条件：
  • 如果状态是“已解决”或“已关闭”之一
  • 并且编号 - “包含” - {{事件编号}}
• 麦克斯唱片： 一
• 返回的字段：
  • 数字
  • 简短描述
  • 描述
  • 工作笔记列表
  • 决议备注
  • 由变化引起
• 排序依据： 数字
• 排序类型： 从头到尾；全方位
• 执行模式： 自主的
• 显示输出： 不
• 处理消息： “获取事件详情”
• 输出转换策略： 冗长的；啰嗦的

创建Notion页面

• 类型： MCP服务器工具
• MCP 工具： Notion创建页面
• 工具描述： 这个工具会在Notion中创建一个新页面，命名为“[事件编号] - 经验教训”。这个页面将用于发布针对特定事件的所有经验教训。
• 执行模式： 自主的
• 显示输出： 不
• 处理消息： “创建Notion页面”
• 输出转换策略： 无

测试

[待添加测试说明]

故障排除