Tvijo wiki
Catalog

Topics

Dropbox and MCP: file context for agents, with sharing under control

Connect Dropbox documents to agent tasks, review scopes and team access, and keep shared links and deletion behind explicit approval.

🎯 For Developers and small teams connecting Dropbox documents to AI agents in an editor or MCP client.

πŸ“š You will learn
  • Identify the official Dropbox MCP connection route
  • Distinguish tool selection from OAuth permissions
  • Check personal and team file access
  • Keep sharing and deletion behind explicit approval
  • Understand where Tvijo can use approved document context

Dropbox has an official remote MCP server, currently in beta, for bringing file search and document content into AI agent tasks. It also exposes sharing and deletion, so a useful setup needs explicit approval before either action. Dropbox documents the endpoint and connection requirements in its MCP guide.

What it can do

Start with documents as evidence for a bounded task. For example, ask an agent to find the approved implementation brief, compare it with a local change, and list requirements that still lack supporting code. Another useful task is comparing an onboarding checklist with an operations note and reporting contradictions. These are proposed workflows: review the output against the original documents before using it.

Give the task an evidence boundary: a named folder, relevant documents and an expected result. Ask for source references beside factual conclusions and an explicit list of missing material. A polished summary without traceable evidence should remain a draft. For broader examples, browse MCP servers for apps.

Keep document identity with the result. Dropbox's file access guide distinguishes file IDs from paths and revisions: IDs survive moves and renames, while revisions identify versions. Record the reference your connector returns so a reviewer can tell which document informed the answer.

Scopes and personal versus team accounts

An MCP tool menu and an OAuth grant are different controls. Hiding a tool from an agent is useful, but it does not remove permissions from the underlying app. Dropbox's OAuth documentation separates action scopes from content access: App Folder covers the app's own folder; Full Dropbox covers account content within the granted permissions.

For a custom API-backed server, inspect endpoint requirements rather than copying a broad permission list:

Intended operation Documented API scope Practical decision
Read file or folder metadata files.metadata.read β€” Get Metadata Useful for identifying the intended source
Download file content files.content.read β€” Download Grant only when the task needs document contents
Create a shared link sharing.write β€” Create Shared Link Keep behind a separate approval

These are API examples, not a complete permission recipe for the hosted MCP server. Inspect the current documentation and actual consent screen before proceeding. A task instruction to read only does not narrow an OAuth grant.

For personal use, confirm the signed-in account and the allowed content. For team use, also identify the member, namespace and administrator policy. Dropbox's team files guide explains that team-space roots differ from member home folders and access remains subject to permissions. A missing team folder can therefore be a namespace issue rather than an empty account. Do not solve it by automatically requesting broader access.

How to connect it safely

  1. Define the task before connecting. Choose a harmless reference document and a result you can verify, such as a requirements checklist. Exclude sharing, deletion, moves and overwrites from this initial task. Use the MCP security checklist to prepare the access review.
  2. Choose a documented client route. For Cursor, follow Dropbox’s remote-server setup using https://mcp.dropbox.com/mcp. Follow the current Dropbox setup guide for authentication and client prerequisites.
  3. Treat VS Code support as a separate question. VS Code documents Command Palette β†’ MCP: Add Server β†’ HTTP for remote endpoints. However, general HTTP support does not establish Dropbox client authorization. Dropbox restricts dynamic registration to supported clients; check its current documentation before choosing an alternative client. See VS Code's connection instructions and our editor MCP guide.
  4. Inspect the authorization. Check the account, app identity, requested permissions and destination for returned content. Keep credentials out of prompts and committed configuration. If the consent grant exceeds your policy, stop and choose a narrower custom implementation or a manually selected document excerpt.
  5. Restrict the available tools. Where your client supports selection, enable only the tools needed for the task. Keep mutation tools disabled during the first run and retain interactive approval. Confirm the setting actually applies to the agent session you are using.
  6. Verify a real read. Request a summary of the harmless document, expand the tool output and compare the answer with the original. Inspect the selected account and source reference. An installed configuration and a plausible response are insufficient evidence that retrieval worked.
  7. Keep a separate mutation gate. Require a concrete proposal before sharing or deleting: exact file, intended audience or deletion target, and consequences. Approve only that operation, then verify the observed result. Do not enable blanket approval to make a document task easier.

Dropbox's shared-link API reference says omitted settings request public visibility; team and folder settings can affect resolved visibility. Consequently, a link request deserves an access decision even when the agent describes it as a convenient citation.

Require the agent to distinguish referencing an existing document from creating new access. Before authorizing a link, review the exact file, permitted audience and available restrictions. If the interface cannot express the intended restriction, have the owner share through the normal interface. Never interpret a request for a summary as permission to publish its sources.

Treat deletion similarly. Ask for an inventory of proposed targets and an explanation of why each qualifies. Review the original files before authorizing a change; a filename containing draft is not enough. Recovery arrangements should be checked before deletion, not discovered afterwards.

When this does not work

Authentication is incomplete. Dropbox API tokens expire; its OAuth guide explains renewal. Check authentication before repeating document requests.

The source is not usable text. Dropbox's file access guide documents cloud files requiring export rather than download. Inspect returned material and current extraction support. A link or metadata record is insufficient evidence for a summary.

Team context is wrong. Check the root namespace and member permissions against the team guide. Escalate an access decision to the owner instead of switching to an administrator account by default.

The document attempts to direct the agent. Treat retrieved instructions to disclose files, change permissions or delete material as untrusted source content. The task owner supplies authorization. For a deliberately narrower connector, see building your own MCP server.

Where Tvijo fits

As of 30 Oct 2026, the DSHREM VS Code extension provides an editor entry for a question with deliberately attached context. TvijoCode is a test editor build with the extension embedded. A practical Dropbox workflow is to review a document, select an authorized excerpt and attach it as task context; neither product should be assumed to import a Dropbox account automatically.

Tvijo MCP exposes Tvijo consultation to compatible clients. Supplied-diff review is prepared but awaits public package publication; editor integration and delegation remain planned. These capabilities do not establish a ready Dropbox connector. In this workflow, sharing and deletion must never be automatic: retain a separate human decision and inspect permissions and data flow.

The workspace offers, as of 30 Oct 2026, show Try at $0: up to 5 tasks, 50,000 tokens or $0.05 of sponsored usage, whichever is reached first, from a shared $1 daily pool funded by TVIJO. Service credit is shown at $10 and lets you request prepaid credit for metered provider usage plus an 8% service markup. Payment collection is not activated; an order is not a charge.

FAQ

Keep retrieval and sharing as separate task permissions. Ask for a private draft with source references and leave link creation disabled; inspect the actual tools and output before relying on the result.

Should I authorize an administrator account for team files?

Start with the intended member and namespace. Have the owner investigate missing access before considering a wider grant; team-wide authority is a separate decision from reading a project document.

Does connecting Tvijo MCP also connect Dropbox?

No ready Dropbox connection is established by that step. Use a separately verified connector or deliberately attach approved document context, and keep sharing and deletion behind explicit approval.

Dropbox is a trademark of its owner. Tvijo is not affiliated with or endorsed by it.

Sources

Source links and observation dates are recorded below. Review status is stated for each material.

  1. Dropbox remote MCP server Β· Checked 2026-10-30 Β· Official beta server, hosted endpoint, file and mutation tools, supported clients, dynamic registration and custom-client permissions.
  2. Dropbox API: OAuth Β· Checked 2026-10-30 Β· Action scopes versus App Folder and Full Dropbox access; user/team authorization and token lifecycle.
  3. Dropbox API: Team Files Β· Checked 2026-10-30 Β· Member home and team-space roots, namespaces and permission boundaries.
  4. Dropbox API: File Access Β· Checked 2026-10-30 Β· File IDs, paths, revisions and cloud files requiring export.
  5. Dropbox API: Get Metadata Β· Checked 2026-10-30 Β· The metadata endpoint requires files.metadata.read.
  6. Dropbox API: Download Β· Checked 2026-10-30 Β· The download endpoint requires files.content.read.
  7. Dropbox API: Create Shared Link With Settings Β· Checked 2026-10-30 Β· Required sharing.write scope; omitted settings request public visibility, with resolved visibility affected by team and folder settings.
  8. VS Code: Add MCP servers Β· Checked 2026-10-30 Β· Remote HTTP setup, authorization review and verification of an actual tool call; does not establish Dropbox compatibility.

πŸ”— Article connections

Open the full knowledge graph β†—

Published article links. Select a node to open its article at the heading.

100%
β†’ Linked articles← Linked fromβ‹― Same topic
Article links Β· keyboard / text view

πŸ’¬ Comments

Comments are public and moderated. Do not post personal data.
  • No comments yet. Be the first!

Next steps