Notion MCP: cách kết nối Notion với Claude, Cursor, Codex và ChatGPT
Tác giả: Andrei Finogeev, nhà sáng lập Weft ·
Máy chủ MCP chính thức của Notion được lưu trữ tại https://mcp.notion.com/mcp (Streamable HTTP, có phương án dự phòng SSE) và đăng nhập bằng OAuth; workspace Business và Enterprise còn dùng được MCP token. Nó chạy trên mọi gói Notion. Mở thư viện connector hoặc plugin của trợ lý, tìm Notion và đăng nhập — hoặc thêm URL trong Claude Code, Cursor, VS Code hay Codex. Máy chủ cục bộ mã nguồn mở cũ không còn được duy trì.
Tổng quan Notion MCP
| URL máy chủ | https://mcp.notion.com/mcp — dự phòng SSE tại /sse |
|---|---|
| Đăng nhập | OAuth; MCP bearer token trên Business và Enterprise |
| Gói miễn phí | Có — “Notion MCP works on every plan” |
| Giới hạn tần suất | 180 yêu cầu mỗi phút (600 trên Business và Enterprise); truy vấn data source ~3 mỗi giây |
| Xóa | Có — trang và cơ sở dữ liệu vào Trash |
| Gói trả phí | Plus $10/thành viên một tháng khi trả theo năm ($12 theo tháng); Business $20 ($24) |
“Không nêu” nghĩa là Notion không nói. Giá là giá niêm yết bằng đô la Mỹ cho mỗi chỗ; thuế và giá theo khu vực có thể khác.
Cách thiết lập Notion MCP trong từng trợ lý
Claude (web và máy tính)
Customize → Connectors (hoặc “+” → Connectors trong một cuộc chat), chọn Notion từ thư mục và đăng nhập.
Claude Code
Thêm máy chủ, rồi chạy /mcp trong Claude Code và đăng nhập. Notion cũng có một plugin cho Claude Code (makenotion/claude-code-notion-plugin).
claude mcp add --transport http notion https://mcp.notion.com/mcpCursor
Thêm Notion vào .cursor/mcp.json, bật nó và hoàn tất đăng nhập.
{
"mcpServers": {
"notion": { "url": "https://mcp.notion.com/mcp" }
}
}VS Code (Copilot)
Thêm máy chủ vào .vscode/mcp.json với "type": "http", rồi chạy “MCP: List Servers” và khởi động nó.
Codex
Thêm vào ~/.codex/config.toml, rồi đăng nhập.
[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"
# then: codex mcp login notionChatGPT
Tài liệu của Notion không có các bước cho ChatGPT hay danh sách gói. OpenAI có ứng dụng Notion trong ChatGPT; chúng tôi không xác nhận được từ các trang hiện tại của OpenAI rằng nó được ghi những gì.
AI của bạn làm được gì trong Notion
- Tìm và lấy trang; tạo trang (cả từ mẫu cơ sở dữ liệu) và cập nhật nội dung cùng thuộc tính của chúng.
- Dùng cơ sở dữ liệu làm danh sách việc: tạo hàng, cập nhật thuộc tính, truy vấn view đã lưu và data source, tạo view.
- Tạo cơ sở dữ liệu và data source; bình luận và đề xuất chỉnh sửa; di chuyển, nhân bản, xóa và khôi phục trang.
- Tải lên hình ảnh và tệp tới 20 MiB; sự kiện lịch và ghi chú cuộc họp.
Những giới hạn nên biết
- Chỉ thành viên workspace mới kết nối được — khách thì không.
- Giới hạn tần suất áp dụng cho mọi lệnh gọi công cụ: 180 mỗi phút, hoặc 600 trên Business và Enterprise.
- Truy vấn kiểu SQL chỉ không giới hạn trên Business hoặc Enterprise có Notion AI; tìm kiếm qua connector cũng cần như vậy.
- Trang được tạo mà không có nơi đến sẽ thành trang riêng tư.
- Cơ sở dữ liệu Notion là một bảng bạn tự định hình thành danh sách việc; không có sẵn khái niệm agent nhận một công việc hay báo tiến độ.
Notion hay Weft để làm việc với AI?
Chọn Notion nếu công việc của bạn nằm cạnh tài liệu và wiki, và bạn muốn một trợ lý cho cả hai. Máy chủ MCP của nó rộng, do Notion lưu trữ và miễn phí trên mọi gói.
Chọn Weft nếu bạn muốn một bảng công việc do AI vận hành, thay vì một cơ sở dữ liệu bạn phải tự thiết kế. Weft là Scrumban dựng sẵn — backlog, sprint và giới hạn lượng việc đã xong đang chờ bạn duyệt — và công cụ của nó được làm cho trợ lý làm việc: nhận một công việc, báo tiến độ, hỏi bạn một câu hỏi chờ sẵn trong Hộp thư đến, ghi lại quyết định. Nó chạy trong ChatGPT trên mọi gói, kể cả Free.
Thiết lập Weft: Weft trong ChatGPT · Weft trong Claude · Weft trong Claude Code · Weft trong Cursor · Weft trong Codex
Câu hỏi
URL máy chủ Notion MCP là gì?
https://mcp.notion.com/mcp. Chỉ dùng https://mcp.notion.com/sse nếu client của bạn không hỗ trợ Streamable HTTP.
Máy chủ Notion MCP có miễn phí không?
Có. Notion nói Notion MCP chạy trên mọi gói; một số tính năng tìm kiếm cần Business hoặc Enterprise có Notion AI.
Tôi có nên dùng notion-mcp-server mã nguồn mở không?
Notion nói makenotion/notion-mcp-server không còn được duy trì tích cực và khuyên dùng máy chủ lưu trữ sẵn; họ gọi máy chủ cục bộ là phương án cuối cùng.
AI có quản lý công việc trong cơ sở dữ liệu Notion được không?
Được. Qua máy chủ lưu trữ sẵn, nó có thể tạo hàng, cập nhật thuộc tính và truy vấn view đã lưu, nên một cơ sở dữ liệu dùng được như danh sách việc.
Nguồn
Đọc ngày 11 tháng 11, 2026.