前言
Notion作为一款功能强大的信息管理工具,被广泛用于项目跟踪、知识库构建和数据整理。然而,随着数据量的增长,我们常常会发现自己陷入了重复和繁琐的操作中。比如,为了找到符合特定条件的几条数据,需要在庞大的数据库中手动设置多个过滤器;或者,需要根据数据状态的变化,逐一修改条目的格式,如高亮显示或添加标记。这些手动操作不仅效率低下,而且在处理复杂需求时极易出错,成为了许多Notion深度用户在提升效率时遇到的一个明显痛点。
本文旨在解决这一难题,将提供一个详细的实战指南,向你展示如何将AI智能体通过蓝耘MCP平台以及trae智能体接入你的Notion工作空间。我们将一步步完成所有配置,最终实现一个核心目标:让你能够直接通过自然语言对话,来命令AI完成对Notion数据库的复杂查询、数据提取、乃至内容修改。这套流程将彻底改变你与Notion的交互方式,将重复性劳动交给AI,让你专注于更有价值的工作。
Notion-mcp的获取
打开蓝耘进行账号的注册,输入简单的信息就能登录进去
在上方导航栏点击MCP广场
打开蓝耘MCP广场搜索notion
选择框出来的这个mcp
点击进mcp的详细介绍是有很详细的介绍的
从介绍中不难得出我们需要进行notion api密钥的创建以及获取
在这款mcp的介绍中得到了notion-mcp-server-github的地址,点击进去可以看到具体的代码介绍,如果你感兴趣也是可以去看下子的
进行Notion集成的配置
我们打开notion,我这里以本地端进行测试,如果你内存不够的话是可以进行网页端的测试的。
如果你想下载的话直接去notion
官网进行查看就行了
点击免费获取就ok了
下载好了效果如下:
点击左侧的齿轮图标进入到设置界面
来到连接界面,点击开发或管理集成
进行notion内部应用的创建
然后会跳转到应用创建的页面了,点击New integration
进行集成的创建
自定义你的集成名称,然后选择工作的空间,然后点击右下角的Save
进行保存即可
如果是下方的样子说明你已经成功创建了一个集成了
点击Configure integration settings
进行集成的配置操作
这里我们需要先勾选下方的读写权限,不然是不能对工作空间内的文件进行操作的,然后就可以将我们的api-keys进行复制即可,点击show
就可以展现api密钥
他的密钥是这种格式的,以ntn开头的
ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
完成上面两个操作点击右下角的Save
即可
如果设置成功是会出现一个弹窗的
将mcp集成到trae中并进行测试
打开trae选中右上角齿轮进入到设置界面
切到MCP界面点击手动添加
{"mcpServers": {"notionApi": {"command": "npx","args": ["-y", "@notionhq/notion-mcp-server"],"env": {"OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"}}}
}
将我们上面获取到的api-key粘贴进去即可
其他的我们就不用管了,点击确定就可以进行notion mcp-server
的链接操作了
如果你链接成功的话就是这个样子的,出现了一个绿色的对号
我来解释下这里显示的功能
### 用户 (Users)* **API-get-user (检索用户):** 此功能用于检索有关特定 Notion 用户的信息。您需要提供用户的 ID 才能获取其详细信息,例如姓名、头像和电子邮箱地址。
* **API-get-users (列出所有用户):** 使用此功能可以获取 Notion 工作区中所有用户的列表。
* **API-get-self (检索您令牌的机器人用户):** 此功能用于检索与您正在使用的 API 令牌相关联的机器人用户的信息。### 搜索 (Search)* **API-post-search (按标题搜索):** 此功能允许您在 Notion 工作区中按标题搜索页面和数据库。### 数据库 (Databases)* **API-post-database-query (查询数据库):** 这是一个非常强大的功能,允许您查询数据库中的条目。您可以根据各种属性(例如文本、数字、日期、选择等)进行筛选和排序。
* **API-create-a-database (创建数据库):** 使用此功能可以在指定的页面下创建一个新的数据库。
* **API-update-a-database (更新数据库):** 此功能用于更新现有数据库的属性,例如标题和属性模板。
* **API-retrieve-a-database (检索数据库):** 此功能用于获取有关特定数据库的详细信息,包括其所有属性。### 页面 (Pages)* **API-retrieve-a-page (检索页面):** 此功能用于获取特定页面的详细信息,但不包括页面内容。
* **API-patch-page (更新页面属性):** 使用此功能可以更新现有页面的属性,例如标题、封面图片和图标。
* **API-post-page (创建页面):** 此功能允许您在 Notion 工作区中创建一个新页面。您可以将其创建为独立页面,也可以作为另一个页面的子页面。
* **API-retrieve-a-page-property (检索页面属性项目):** 此功能用于检索页面中特定属性项目的值。### 块 (Blocks)块是 Notion 中内容的基本单位,可以是文本、标题、待办事项列表、图片等。* **API-get-block-children (检索块的子级):** 此功能用于获取特定块的所有子块。
* **API-patch-block-children (附加块的子级):** 使用此功能可以将新的块附加到现有块的末尾。
* **API-retrieve-a-block (检索块):** 此功能用于获取有关特定块的详细信息。
* **API-update-a-block (更新块):** 此功能用于更新现有块的内容。
* **API-delete-a-block (删除块):** 使用此功能可以删除一个块。### 评论 (Comments)* **API-retrieve-a-comment (检索评论):** 此功能用于获取特定评论的详细信息。
* **API-create-a-comment (创建评论):** 此功能允许您在页面或块上添加评论。总之,Notion API 提供了一套全面的工具,让开发人员能够以编程方式与 Notion 工作区进行交互,从而实现各种自定义集成和自动化。
各位可以根据上方的功能实现不同的需求与操作
mcp链接好后我们需要进行智能体的创建进行mcp的精准管控,来到智能体界面点击创建
勾选上我们对应的mcp然后自定义智能体姓名以及提示词即可,然后点击左下角创建即可
点击立即使用
当配置好了之后我们不要着急,我们还得进行notion应用端的配置操作
来到notion应用端,我们需要将我们上面创建的应用与页面进行绑定操作,不然我们的这里的智能体是不能识别到对应的文件以及页面的
点击右上角三个点,点击集成,在左侧栏中就可以看得到我们上面创建的集成了,我们点击MCP Demo
这个集成
点击确认即可
你想让这个集成对哪个文件进行操作,你就进行集成的配置即可
我们这里使用notion内置ai生成了一份公司工资表格进行测试
同样,我们需要将应用集成到这个页面的内容中
然后我们就可以进行智能体的使用了,打开trae进行与ai的对话操作
我对ai说:
帮我查询下当前工资表中的最高工资的5位同事的数据
并且最后还给我进行了数据的保存,保存到了一个md格式的文件下
效果如下:
好的,这是根据图片内容整理的表格:
公司最高工资前5名员工信息
排名 | 员工姓名 | 职位 | 部门 | 工资级别 | 基本工资 | 绩效奖金 | 补贴 | 扣除项 | 实发工资 | 入职日期 |
---|---|---|---|---|---|---|---|---|---|---|
1 | 赵伟 | 技术总监 | 技术部 | P6 | ¥18,000 | ¥6,000 | ¥2,000 | ¥3,500 | ¥22,500 | 2018-06-12 |
2 | 周鑫 | 行政总监 | 行政部 | P7 | ¥15,000 | ¥4,500 | ¥2,500 | ¥3,000 | ¥19,000 | 2017-03-01 |
3 | 吴佳 | 高级开发工程师 | 技术部 | P4 | ¥13,000 | ¥3,200 | ¥1,100 | ¥2,300 | ¥15,000 | 2020-09-18 |
4 | 张明 | 产品经理 | 技术部 | P4 | ¥12,000 | ¥3,500 | ¥1,200 | ¥2,100 | ¥14,600 | 2020-03-15 |
5 | 王强 | 销售经理 | 销售部 | P5 | ¥10,000 | ¥5,000 | ¥1,500 | ¥2,300 | ¥14,200 | 2019-04-20 |
除了进行内容数据的查询,我们还能进行针对特定的数据对表格进行修改操作
我们这里让ai找到扣除项最多的那个人和实发工资最少的那个打上勾并且用红色背景进行标记
这里同样是先进行查询操作
然后就是对特定的数据进行做标记操作
来到Notion的界面就可以看到数据的实时改动
总结
通过本文的完整演示,我们不仅成功地让AI智能体查询了Notion数据库中的信息,还进一步实现了对数据库内容的直接修改,整个过程完全由对话驱动。
Notion MCP的核心优势在于其强大的“翻译”和“赋能”能力。 它将原本需要编写代码才能调用的Notion官方API,封装成了一系列AI能够直接理解和执行的功能模块(如查询数据库、更新页面、删除块等)。AI不再需要处理复杂的API请求和数据结构,而是可以直接调用这些被赋予的能力,从而精确地执行我们的指令。这极大地降低了技术门槛,让非开发人员也能搭建出强大的自动化流程。
如果你也想体验的话不妨来试试MCP广场