שרת ה-MCP ל-Dropbox, נספר בריצה חיה על Mac אמיתי.

• כלים

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

• אישורי גישה

  OAuth של אפליקציית Dropbox, חמישה משתנים [4][5]

• ערוץ תקשורת

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

• מתחזק

  מפתח אחד, המאגר המקושר מחזיר 404 [1][3]

• הורדות

  30 בשבוע האחרון [2]

• רישיון

  MIT [1]

אימות

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

השיטה

הרצנו את השרת עם npx על גבי stdio, עם מחרוזות מציין מקום ברורות בחמשת משתני הסביבה שבלעדיהם הוא מסרב לעלות, השלמנו את לחיצת היד של MCP וקראנו ל-tools/list: 25 הכלים למטה הם התשובה הזו, מילה במילה. אחר כך ביצענו קריאת כלי אמיתית אחת, list_files על שורש החשבון, והיא נכשלה, כפי שהיה חייב לקרות. הקטע שמתחת לקריאת הדוגמה הוא השגיאה המדויקת שהיא החזירה: בדיקת האסימון של השרת עצמו, שמודיעה שהאימות לא הושלם. כלומר רשימת הכלים היא מדידה, ושום דבר בעמוד הזה לא מתאר מה מחזירה קריאה מוצלחת ל-Dropbox, כי קריאה מאומתת דורשת אפליקציית Dropbox שאתם יוצרים בעצמכם ותהליך אישור שלא הרצנו. שלוש בדיקות כשל מכוונות רצו באותו יום ומצוטטות במלואן בקטע פתרון התקלות: הפעלה בלי שום אישורי גישה, קריאה עם ארגומנט חסר ועם שם כלי שגוי, וקריאה לנתיב שאינו קיים.

warn: Using default value for DROPBOX_RECYCLE_BIN_PATH: /.recycle_bin {"service":"dropbox-mcp-server","timestamp":"2026-08-03T20:57:12.565Z"}
warn: Using default value for DROPBOX_MAX_DELETES_PER_DAY: 100 {"service":"dropbox-mcp-server","timestamp":"2026-08-03T20:57:12.568Z"}
warn: Using default value for DROPBOX_RETENTION_DAYS: 30 {"service":"dropbox-mcp-server","timestamp":"2026-08-03T20:57:12.569Z"}
warn: Using default value for DROPBOX_ALLOWED_PATHS: / {"service":"dropbox-mcp-server","timestamp":"2026-08-03T20:57:12.569Z"}
warn: Using default value for DROPBOX_BLOCKED_PATHS: /.recycle_bin,/.system {"service":"dropbox-mcp-server","timestamp":"2026-08-03T20:57:12.569Z"}
info: Schema configuration loaded {"documentTypes":4,"path":"/Users/[REDACTED]/code/routines/.marketing-drafts/2026-08-03/mcp-batch-8-receipts/schema-config.json","service":"dropbox-mcp-server","timestamp":"2026-08-03T20:57:12.579Z","version":"1.0.0"}
info: Initializing database schema {"dbPath":"/Users/[REDACTED]/code/routines/.marketing-drafts/2026-08-03/mcp-batch-8-receipts/dbx-db/documents.db","service":"dropbox-mcp-server","timestamp":"2026-08-03T20:57:12.593Z"}
info: Database schema initialized successfully {"service":"dropbox-mcp-server","timestamp":"2026-08-03T20:57:12.610Z"}
info: Connecting to transport... {"service":"dropbox-mcp-server","timestamp":"2026-08-03T20:57:12.610Z"}
info: Dbx MCP server running on stdio {"service":"dropbox-mcp-server","timestamp":"2026-08-03T20:57:12.611Z"}

tools/call list_files {"path": ""}

MCP error -32600: No token data available. Please complete authentication first by visiting the authorization URL.

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

כלים

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

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

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

התקנה

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

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

{
  "mcpServers": {
    "dropbox": {
      "command": "npx",
      "args": [
        "-y",
        "dbx-mcp-server"
      ],
      "env": {
        "DROPBOX_APP_KEY": "YOUR_DROPBOX_APP_KEY",
        "DROPBOX_APP_SECRET": "YOUR_DROPBOX_APP_SECRET",
        "DROPBOX_REDIRECT_URI": "http://localhost:3000/callback",
        "TOKEN_ENCRYPTION_KEY": "YOUR_32_PLUS_CHARACTER_ENCRYPTION_KEY",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY"
      }
    }
  }
}

claude mcp add dropbox -s user \
  -e DROPBOX_APP_KEY=YOUR_DROPBOX_APP_KEY \
  -e DROPBOX_APP_SECRET=YOUR_DROPBOX_APP_SECRET \
  -e DROPBOX_REDIRECT_URI=http://localhost:3000/callback \
  -e TOKEN_ENCRYPTION_KEY=YOUR_32_PLUS_CHARACTER_ENCRYPTION_KEY \
  -e OPENROUTER_API_KEY=YOUR_OPENROUTER_API_KEY \
  -- npx -y dbx-mcp-server

{
  "mcpServers": {
    "dropbox": {
      "command": "npx",
      "args": [
        "-y",
        "dbx-mcp-server"
      ],
      "env": {
        "DROPBOX_APP_KEY": "YOUR_DROPBOX_APP_KEY",
        "DROPBOX_APP_SECRET": "YOUR_DROPBOX_APP_SECRET",
        "DROPBOX_REDIRECT_URI": "http://localhost:3000/callback",
        "TOKEN_ENCRYPTION_KEY": "YOUR_32_PLUS_CHARACTER_ENCRYPTION_KEY",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_API_KEY"
      }
    }
  }
}

Name        Dropbox
Command     npx
Arguments   -y dbx-mcp-server

Environment Variables
DROPBOX_APP_KEY         YOUR_DROPBOX_APP_KEY
DROPBOX_APP_SECRET      YOUR_DROPBOX_APP_SECRET
DROPBOX_REDIRECT_URI    http://localhost:3000/callback
TOKEN_ENCRYPTION_KEY    YOUR_32_PLUS_CHARACTER_ENCRYPTION_KEY
OPENROUTER_API_KEY      YOUR_OPENROUTER_API_KEY

בלי טרמינל

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

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

1. 01

   התקינו את Routines

   הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.

2. 02

   צרו אפליקציית Dropbox

   היכנסו ל-dropbox.com/developers/apps ולחצו על Create app. בחרו Scoped access, בחרו את רמת הגישה הרצויה ותנו שם. בלשונית Permissions סמנו את ההרשאות שהכלים צריכים, שהן files.metadata.read, files.content.read, files.content.write, sharing.write ו-account_info.read, ואז שלחו. חזרה ב-Settings, הוסיפו את ‎http://localhost:3000/callback כ-redirect URI והעתיקו את ה-App key ואת ה-App secret.

3. 03

   פתחו את הגדרות ה-MCP

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

4. 04

   בחרו Command (stdio)‎

   העבירו את הטופס ל-Command (stdio): השרת הזה הוא פקודה שרצה על ה-Mac שלכם, לא כתובת אינטרנט. קראו לו Dropbox. Command: npx. Arguments: ‎-y dbx-mcp-server, בדיוק שלוש המילים האלה, כי השדה מתפצל לפי רווחים.

5. 05

   מלאו את חמשת ה-Environment Variables

   DROPBOX_APP_KEY ו-DROPBOX_APP_SECRET הם שני המפתחות שהעתקתם. DROPBOX_REDIRECT_URI הוא ‎http://localhost:3000/callback, זהה למה שהוספתם ב-App Console. TOKEN_ENCRYPTION_KEY הוא מחרוזת אקראית ארוכה שאתם ממציאים ושומרים במקום בטוח, לפחות 32 תווים. OPENROUTER_API_KEY הוא ההפתעה: השרת טוען את מודול ניתוח ה-PDF שלו כבר בעליה ומסרב לרוץ בלי המשתנה הזה, אז שימו בו ערך גם אם אין לכם כוונה לנתח PDF.

6. 06

   בדקו, הוסיפו והשלימו את ההתחברות

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

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

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

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

פתרון תקלות

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

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

file:///Users/[REDACTED]/.npm/_npx/05b5b7e5ee941318/node_modules/dbx-mcp-server/build/src/config.js:20
            throw new McpError(ErrorCode.InvalidParams, `Missing required environment variable: ${envVar}`);
                  ^

McpError: MCP error -32602: Missing required environment variable: DROPBOX_APP_KEY
    at validateConfig (file:///Users/[REDACTED]/.npm/_npx/05b5b7e5ee941318/node_modules/dbx-mcp-server/build/src/config.js:20:19)
    at file:///Users/[REDACTED]/.npm/_npx/05b5b7e5ee941318/node_modules/dbx-mcp-server/build/src/config.js:27:5
    at ModuleJob.run (node:internal/modules/esm/module_job:439:25)
    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:643:26)
    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:101:5) {
  code: -32602,
  data: undefined
}

Node.js v24.18.0

MCP error -32600: No token data available. Please complete authentication first by visiting the authorization URL.

MCP error -32600: No token data available. Please complete authentication first by visiting the authorization URL.

שאלות נפוצות

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

מקורות

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

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

1. [1]

   npm registry: dbx-mcp-serverנקרא בתאריך 2026-08-03

   Latest version 1.3.2. All eight versions, 1.0.0 through 1.3.2, were published on 2025-06-15 between 18:08:45Z and 20:55:56Z. License MIT, author Olivier Debeuf De Rijcker, repository git+https://github.com/olivierdebeuf/dbx-mcp-server.git.

2. [2]

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

   30 downloads for the week 2026-07-27 to 2026-08-02.

3. [3]

   GitHub API: olivierdebeuf/dbx-mcp-serverנקרא בתאריך 2026-08-03

   Returns {"message":"Not Found"}, as does https://api.github.com/users/olivierdebeuf. The repository the npm package declares does not resolve, so no stars, push date or issue tracker can be reported for it.

4. [4]

   dbx-mcp-server README, bundled in the npm tarballנקרא בתאריך 2026-08-03

   Read by running npm pack dbx-mcp-server and extracting the tarball, because the linked GitHub repository is gone. Documents the claude mcp add usage and lists five required environment variables, DROPBOX_APP_KEY, DROPBOX_APP_SECRET, DROPBOX_REDIRECT_URI, TOKEN_ENCRYPTION_KEY with a 32 character minimum, and OPENROUTER_API_KEY for the AI analysis, which it also covers in its own setup step.

5. [5]

   Dropbox App Consoleנקרא בתאריך 2026-08-03

   Where the Scoped access app, its permissions and the http://localhost:3000/callback redirect URI are created, and where the App key and App secret are read.

6. [6]

   modelcontextprotocol/servers: reference server listנקרא בתאריך 2026-08-03

   No Dropbox server among the project's own reference servers. It says nothing about what Dropbox itself publishes.

7. [7]

   Dropbox Help Center: How to connect the Dropbox remote MCP serverנקרא בתאריך 2026-08-04

   Dropbox's own remote MCP server, at https://mcp.dropbox.com/mcp, described as in open beta and connected over HTTP with Dropbox OAuth, with Dynamic Client Registration for a listed set of clients. Article updated 2026-03-18. It documents the server's tools, among them ListFolder, GetFileMetadata, GetFileContent, GetUsageAndQuota, Search, CreateFile, CreateSharedLink, Copy, Move, Delete, GetTranscript and GetMarkdown. Not run for this page.

8. [8]

   Dropbox Help Center: How to connect the Dropbox Dash remote MCP serverנקרא בתאריך 2026-08-04

   A second, separate Dropbox remote MCP server, for Dropbox Dash, at https://mcp.dropbox.com/dash, also over HTTP with OAuth. Article updated 2026-06-11. Not run for this page.

9. [9]

   npm registry: other Dropbox MCP packagesנקרא בתאריך 2026-08-04

   dropbox-analytics-mcp-server 0.4.7, MIT, published 2026-07-08, describes itself as reading public shared links without auth or browsing a private Dropbox with an OAuth refresh token. dropbox-mcp-server 2.2.2, published 2026-07-21, carries no license field. Both declare a bin and can be started with npx. Neither was run for this page.

10. [10]

    GitHub API: amgadabdelhafez/dbx-mcp-serverנקרא בתאריך 2026-08-03

    A separate project sharing the same name: 29 stars, 21 forks, 1 open issue, MIT, not archived, last push 2025-07-16. Installs by git clone and build, is not published to npm, and was not the package verified on this page.

11. [11]

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

    The claude_desktop_config.json shape and where the file lives.

12. [12]

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

    The claude mcp add syntax for local stdio servers, including the -e flag for environment variables.

13. [13]

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

    The mcp.json shape, the env block and the file locations.

14. [14]

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

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

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