שרת ה-MCP של Notion, רשימת הכלים שלו נלכדה חיה על Mac אמיתי.

• כלים

  24, נספרו בריצה חיה

• אישורי גישה

  סוד אינטגרציה של Notion [5]

• ערוץ תקשורת

  stdio, רץ על ה-Mac שלכם [5]

• מתחזק

  Notion Labs (makenotion)‎ [1][3]

• הורדות

  209 אלף בשבוע האחרון [2]

• רישיון

  MIT [4]

אימות

איך שרת ה-MCP הזה אומת.

השיטה

הרצנו את השרת עם npx על גבי stdio בלי שום משתני סביבה: בלי NOTION_TOKEN ובלי OPENAPI_MCP_HEADERS. הוא עלה בכל זאת, השלים את לחיצת היד של MCP וענה ל-tools/list עם 24 כלים. טבלת הכלים למטה היא הלכידה הזו, מילה במילה. אחר כך הרצנו קריאה אחת שאינה משנה דבר, API-post-search, והשרת העביר אותה ל-Notion והחזיר את התשובה האמיתית: שגיאת 401 שאומרת שטוקן ה-API אינו תקף, והיא מודפסת למטה בדיוק כפי שחזרה. קריאת כלי שמגיעה בפועל לסביבת עבודה עדיין ממתינה לאישור גישה, ולכן העמוד הזה נושא את תג הספירה ולא את תג האימות המלא. השרת אינו מדפיס דבר ל-stderr בעליה, ולכן הבאנר למטה הוא תגובת ה-initialize הגולמית שהוא כתב על החיבור.

{"result":{"protocolVersion":"2025-06-18","capabilities":{"tools":{}},"serverInfo":{"name":"Notion API","version":"1.0.0"}},"jsonrpc":"2.0","id":1}

tools/call API-post-search {"query": "Getting started", "page_size": 1}

{"status":401,"object":"error","code":"unauthorized","message":"API token is invalid.","request_id":"ede4937b-fa79-4222-8515-b404299d6f82"}

שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.

כלים

הכלים, כפי שנספרו מהשרת הרץ.

השרת ענה ל-tools/list עם 24 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.

פרמטרים המסומנים ב-* הם חובה.

התקנה

הגדרות שעובדות, אחת לכל אפליקציה.

העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "ntn_your_integration_secret"
      }
    }
  }
}

claude mcp add --env NOTION_TOKEN=ntn_your_integration_secret --transport stdio notion -- npx -y @notionhq/notion-mcp-server

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "ntn_your_integration_secret"
      }
    }
  }
}

Name                   Notion
Command                npx
Arguments              -y @notionhq/notion-mcp-server
Environment Variables  NOTION_TOKEN = ntn_your_integration_secret

בלי טרמינל

איך מגדירים את שרת ה-MCP‏ Notion בלי טרמינל.

אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים ארבעה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות. ההכנה היחידה מתבצעת בתוך Notion, והיא לוקחת בערך שתי דקות.

1. 01

   צרו את האינטגרציה ב-Notion

   היכנסו ל-notion.so/profile/integrations וצרו אינטגרציה פנימית חדשה. העתיקו את הסוד שהיא מציגה: הוא מתחיל ב-ntn_‎. בלשונית Configuration אפשר לסמן רק Read content, וכך תקבלו טוקן שיכול להסתכל אך לעולם לא לכתוב.

2. 02

   שתפו את העמודים שתרצו שיראה

   אינטגרציה מתחילה בלי גישה לשום דבר. בהגדרות האינטגרציה פתחו את הלשונית Access ובחרו את העמודים ומסדי הנתונים שמותר לה להשתמש בהם. כל מה שלא תשתפו נשאר בלתי נראה לשרת.

3. 03

   התקינו את Routines ופתחו את הגדרות ה-MCP

   הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו. לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.

4. 04

   בחרו Command (stdio)‎

   הטופס נפתח במצב URL (SSE/HTTP)‎. העבירו אותו ל-Command (stdio): השרת הזה הוא פקודה, לא כתובת אינטרנט. Name: Notion. Command: npx. Arguments: ‎-y @notionhq/notion-mcp-server, בלי שום דבר אחריו.

5. 05

   הדביקו את הסוד כמשתנה סביבה

   בשדה Environment Variables הוסיפו רשומה אחת, NOTION_TOKEN, והערך שלה הוא הסוד שמתחיל ב-ntn_‎. אל תכניסו אותו ל-Arguments: השדה הזה מתפצל לפי רווחים ואינו המקום לאישור גישה.

6. 06

   בדקו, הוסיפו, ואז השתמשו

   לחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, עשרים וארבעה עבור השרת הזה. אחר כך לחצו Add Server. הכלים עובדים בצ׳אט מיד. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.

רעיונות לשגרות

שגרות ששווה לתזמן.

אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.

פתרון תקלות

השגיאות שנתקלנו בהן, ומה פתר אותן.

שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.

{"status":401,"object":"error","code":"unauthorized","message":"API token is invalid.","request_id":"ede4937b-fa79-4222-8515-b404299d6f82"}

Failed to parse OPENAPI_MCP_HEADERS environment variable: SyntaxError: Expected property name or '}' in JSON at position 1 (line 1 column 2)

{"error":"invalid_token","error_description":"Missing or invalid access token"}

שאלות נפוצות

שאלות שאנשים שואלים.

מקורות

כל טענה חיצונית, עם קבלה.

כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.

1. [1]

   npm registry: @notionhq/notion-mcp-serverנקרא בתאריך 2026-08-03

   Latest version 2.5.1, published 2026-07-25; described as the official MCP server for the Notion API; every publishing maintainer is a Notion address.

2. [2]

   npm downloads API: last weekנקרא בתאריך 2026-08-03

   209,337 downloads for the week ending 2026-08-01.

3. [3]

   GitHub: makenotion/notion-mcp-serverנקרא בתאריך 2026-08-03

   4,566 stars and a push dated 2026-07-25 at access time, per the GitHub API; owned by the makenotion organisation.

4. [4]

   makenotion/notion-mcp-server LICENSE fileנקרא בתאריך 2026-08-03

   We read the file: it is the MIT License text, copyright 2025 Notion Labs, Inc.

5. [5]

   Notion MCP Server READMEנקרא בתאריך 2026-08-03

   The NOTION_TOKEN and OPENAPI_MCP_HEADERS contract, stdio as the default transport, the integration and Access tab steps, and the 22-tool figure from the 2.0.0 notes.

6. [6]

   Notion developers: Connecting to Notion MCPנקרא בתאריך 2026-08-03

   The hosted server at https://mcp.notion.com/mcp, its OAuth flow, per-client config, and the note that the open-source server is no longer actively maintained.

7. [7]

   modelcontextprotocol.io: Connect to local MCP serversנקרא בתאריך 2026-08-03

   The claude_desktop_config.json location and shape for a local stdio server.

8. [8]

   Claude Code docs: MCPנקרא בתאריך 2026-08-03

   The claude mcp add syntax for stdio servers with --env, and for remote servers with --transport http.

9. [9]

   Cursor docs: Model Context Protocolנקרא בתאריך 2026-08-03

   The mcp.json shape and file locations.

10. [10]

    Routines: Connectorsנקרא בתאריך 2026-08-03

    How Routines runs one-click OAuth connectors and any MCP server.

העמוד הזה מתאר את Notion כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.