mcpField
N
Notion

Notion

精选远程服务
文档

关于 Notion

页面、数据库、评论、工作区搜索

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://mcp.notion.com/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttps://mcp.notion.com/mcp
SSEhttps://mcp.notion.com/sse

工具

28
参数类型必填说明
querystring是在整个 Notion 工作区和已连接的数据源(Slack、Google Drive、Github、Jira、Microsoft Teams、Sharepoint、OneDrive 或 Linear)中进行语义搜索。为获得最佳结果,每次工具调用请只提供一个问题。每项搜索都应单独调用 "search" 工具。 或者,查询也可以是子字符串或关键词,用于按姓名或电子邮件地址匹配查找用户。例如:"john" 或 "[email protected]"
query_typeenum否将查询类型指定为 "internal" 或 "user"。执行 "user" 搜索时,始终包含此输入。internal | user
content_search_modeenum否选择搜索后端:"workspace_search"(更快,仅搜索工作区)或 "ai_search"(语义搜索,包含 Slack/Linear 等)。若省略,则在可用时使用 AI search。仅适用于内容搜索。workspace_search | ai_search
data_source_urlstring否可选:提供要搜索的数据源 URL。这将在该数据源中的页面上执行语义搜索。注意:必须是数据源,而非数据库。<data-source> 标签属于 Notion 风格的 Markdown 格式,由 fetch 等工具返回。完整规范请参阅 create-pages 工具说明。
page_urlstring否可选:提供要在其中搜索的页面 URL 或 ID。这将在指定页面及其下级页面的内容中执行语义搜索。可接受完整页面 URL(例如 https://notion.so/workspace/Page-Title-1234567890),也可仅提供页面 ID(UUIDv4),可带或不带连字符。
teamspace_idstring否可选:提供团队空间 ID,将搜索结果限制在该团队空间内。此时只会搜索指定团队空间中的内容。可接受带或不带连字符的团队空间 ID(UUIDv4)。
filtersobject否可选:提供要应用于搜索结果的筛选条件。仅当 query_type 为 'internal' 时有效。
filters.created_date_rangeobject否可选筛选条件:仅返回在指定日期范围内创建的搜索结果。
filters.created_date_range.start_datestring否日期范围的开始日期(如有),格式为 ISO 8601 日期字符串。
filters.created_date_range.end_datestring否日期范围的结束日期(如有),格式为 ISO 8601 日期字符串。
filters.created_by_user_idsarray否可选筛选条件:仅返回由指定 Notion 用户 ID 对应用户创建的搜索结果。
page_sizeinteger否要返回的结果数量上限(默认值为 10)。较小的值可减少响应大小。
max_highlight_lengthinteger否结果摘要的最大字符长度(默认值为 200)。设为 0 可完全省略摘要。

详细介绍

维护者还没有提供详细介绍,可以先查看代码仓库中的 README。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。