Connect a client
You need two things: an administrator has turned connected apps on, and you are on the Connect apps list. Without the second, the sign-in page says “Your account isn’t allowed to connect apps yet. Ask your administrator.”
What you need from the assistant
Section titled “What you need from the assistant”Any assistant that can use a remote MCP server over HTTPS and sign in with OAuth can connect. Foldr supports two protocol versions, 2025-06-18 and 2025-03-26. It answers in JSON, and does not stream.
The assistant does not need a client ID from you in most cases: it finds Foldr’s sign-in details from the server address and registers itself. If yours asks for a client ID, ask your administrator to add the app.
- In your assistant, add a remote MCP server (some assistants call it a custom connector). Give it the address
https://<your Foldr address>/mcp. Use the same address you open Foldr at. - The assistant sends you to a Foldr page titled Sign in to connect an app. Sign in as you normally do. Whatever signs you in to Foldr, including two-step checks, applies here.
- Foldr may ask you to confirm it is you, as it does before other sensitive changes. Do so.
- Foldr shows (App) wants to access your Foldr account, with the list It will be able to:. Read it. An app that registered itself shows Unverified app: that is normal for an assistant you connect yourself. Only continue if you started this from an assistant you trust.
- Click Allow. To refuse, click Deny.
- Foldr says “You can close this tab and return to the app.” Close the tab.
- In the assistant, ask something that needs Foldr, such as “List my shares in Foldr.”
You are emailed that the app was connected. If you connect the app again and it asks for more than before, you are emailed that it was given more access.
What the list on the consent page means
Section titled “What the list on the consent page means”The list shows exactly what the app was granted, in plain words, for example “Read files and search, as you”. An assistant often asks for more than an administrator allowed. Foldr drops what the policy does not allow, and the page shows what is left. An assistant that asked for everything connects read-only if that is all its policy allows.
Shares you may not see
Section titled “Shares you may not see”An assistant sees the shares you can open in Foldr, with one exception. A share that opens using your own sign-in on the storage (for example an SMB or WebDAV share that asks for your password) cannot be opened by a connected app, because the app does not hold your password. Shares that Foldr opens with a service account work as they do on the web.
Which clients
Section titled “Which clients”The server follows the MCP standard, so it should work with assistants that follow it. These pages do not yet list assistants that Foldr has been tested with.