Een MCP-server voor Nextcloud: wat er is, en wat Bee Flow biedt
· Door Bee Flow · 4 min. lezen
Drie manieren om een AI-client op de desktop of in de editor Nextcloud-tools te geven via MCP: de eigen server van Context Agent, een communityproject en het /mcp-endpoint van Bee Flow. Wat elk nodig heeft, en waarom Bee Flow geen losse MCP-server voor Nextcloud is.

Wie zoekt naar een MCP-server voor Nextcloud, wil meestal dat een AI-client op de desktop of in de editor dingen in Nextcloud kan lezen en wijzigen. Claude Desktop, Claude Code, Cursor en veel andere clients spreken het Model Context Protocol. Wat ze nodig hebben, is een server die Nextcloud aanbiedt als MCP-tools. Daar zijn nu drie manieren voor. Bee Flow is er een van, met een kanttekening. Je hebt een Bee Flow-server nodig, en de Nextcloud-tools komen daarmee mee. Een losse MCP-server voor Nextcloud is Bee Flow niet.
Van Nextcloud zelf: Context Agent
Context Agent, de app achter de agentfuncties van de Assistant, biedt zijn tools ook aan als MCP-server. De documentatie noemt als endpoint
https://your-nextcloud-domain.com/index.php/apps/app_api/proxy/context_agent/mcp/
met een app-wachtwoord van Nextcloud als bearer-token. Elke gebruiker verbindt dus met een eigen wachtwoord. Context Agent is een ExApp en vraagt AppAPI 3.1.0 of nieuwer met een deploydaemon. De tools dekken Calendar, Tasks, Contacts, Files, Talk, Mail, Deck, Forms, Share en Tables.
Een server uit de community
nextcloud-mcp-server is een apart project op een persoonlijk GitHub-account, onder AGPL-3.0. Het draait buiten Nextcloud, via uvx, een Docker-image of een Helm-chart, en spreekt streamable HTTP of stdio. De README noemt tools voor Notes, Calendar, Contacts, Files, Deck, Cookbook, Tables, Sharing, News, Mail, Collectives, Talk en Shopping List. Inloggen gaat met app-wachtwoorden, of voor meerdere gebruikers via Login Flow v2 van Nextcloud.
Wat Bee Flow heeft
Bee Flow is in de eerste plaats een MCP-client. Chats en agents kunnen tools gebruiken van elke MCP-server, ook van de twee hierboven, en in MCP-servers koppelen aan een gedeelde werkplek lees je wie er een mag toevoegen. Daarnaast heeft Bee Flow eigen Nextcloud-tools voor Files, Calendar, Contacts, Mail, Talk, Deck, Tasks, Notes, Tables, Forms, Activity, Notifications en de gebruikersstatus, die verschijnen als de app in je Nextcloud staat. Via de connector draaien ze onder het eigen Nextcloud-account van de gebruiker. Zonder connector bereikt Bee Flow Nextcloud per gebruiker met OAuth of een app-wachtwoord. De andere diensten die je kunt koppelen, staan bij koppelingen.
Elke Bee Flow-server is ook zelf een MCP-server, op /mcp. Een externe client verbindt daar met een persoonlijk token, en de lijst met tools is wat die gebruiker in de chat van Bee Flow mag gebruiken: de Nextcloud-tools zodra Nextcloud gekoppeld is, de andere koppelingen van die gebruiker (Google, Microsoft 365 enzovoort), datatabellen en automatiseringen die hij zo heeft gepubliceerd dat een agent ze kan aanroepen. Die lijst wordt bij elke aanroep opnieuw bepaald. Zet je een koppeling voor iemand uit, dan werkt dat meteen.
Een desktopclient krijgt zo wel Nextcloud-tools, maar alleen via een Bee Flow-server. Wil je alleen Nextcloud in je AI-client, dan hoef je met de twee opties hierboven minder te draaien.
| Context Agent | nextcloud-mcp-server | Bee Flow /mcp |
|
|---|---|---|---|
| Draait | Als ExApp in Nextcloud | Naast Nextcloud | In de Bee Flow-server |
| Inloggegevens | App-wachtwoord van Nextcloud | App-wachtwoord of Login Flow v2 | MCP-token van Bee Flow |
| Tools | Nextcloud-apps | Nextcloud-apps | Nextcloud-apps plus de andere Bee Flow-koppelingen van de gebruiker |
| Nodig naast Nextcloud | AppAPI met een deploydaemon | Een host voor de server | Een Bee Flow-stack |
Een client aan Bee Flow koppelen
Open in Bee Flow de Settings en maak een token aan onder MCP tokens. Je geeft het een naam, zet de server Integrations aan op niveau read (alleen tools die niets wijzigen) of write, en kunt het beperken tot bepaalde tools, een lijst IP-bereiken of een vervaldatum. Het token zie je één keer. Daarna biedt de pagina een kant-en-klare opdracht voor Claude Code:
claude mcp add --transport http beeflow https://bee.example.com/mcp \
--header "Authorization: Bearer YOUR_TOKEN"
Elke client die streamable HTTP spreekt, verbindt op dezelfde manier. Het endpoint beantwoordt één POST met JSON-RPC en opent geen SSE-stream. Het ondersteunt initialize, tools/list, tools/call en ping. Elke tool heeft de annotaties readOnlyHint en destructiveHint, uit dezelfde indeling die onze proefruns van automatiseringen gebruiken. Een tool die nog niet is ingedeeld, telt als een tool die gegevens wijzigt. Een client die vraagt voordat hij iets schrijft, vraagt het dan ook.
Beheerders van een organisatie stellen één beleid in voor alle MCP-toegang, onder Organisation → Security → MCP access. Ze kunnen het uitzetten, alleen toestaan vanaf bepaalde IP-bereiken, beperken tot bepaalde rollen of gebruikers, en oudere tokens zonder beperkingen weigeren. Elk token mag 120 verzoeken per minuut doen, en elke gebruiker 300 over al zijn tokens samen. Aanmaken en intrekken van tokens komt in het auditlog. De MCP-documentatie geeft de details, ook over hoe IP-lijsten van de reverse proxy afhangen.
Andersom
Context Agent kan Bee Flow ook gebruiken als een van zijn externe MCP-servers. Dan staan de tools van Bee Flow in de Assistant van Nextcloud. Hoe die twee naast elkaar draaien, lees je in Nextcloud Assistant en Bee Flow. Het token dat je daar invult, geldt voor elke gebruiker, dus die dienst werkt als de persoon die het token heeft aangemaakt. In onze installatiedocumentatie voor Nextcloud staat de configuratie.
Uitproberen
Het endpoint /mcp zit in elke Bee Flow-server, of je die nu zelf host of in onze EU-cloud draait. Op AI voor Nextcloud zie je wat je gebruikers in Nextcloud krijgen, en Bee Flow naast Nextcloud installeren gaat van een lege Docker-host naar een gekoppelde connector. Wil je weten of het past bij de clients die je team gebruikt, neem dan contact op.