Connecteur Nextcloud
Nextcloud est une plateforme de fichiers et de collaboration sous licence AGPL-3.0. Le connecteur appelle ses interfaces WebDAV et OCS (REST).
Mesuré le 2026-10-03 dans connectors/nextcloud.yaml : 167 outils.
| Méthode HTTP | Outils |
|---|---|
| GET | 89 |
| POST | 40 |
| DELETE | 21 |
| PUT | 16 |
| PATCH | 1 |
Ce que déclare le fichier
| Propriété | Valeur |
|---|---|
| Fichier | connectors/nextcloud.yaml |
| Protocole | WebDAV (/remote.php/dav/…) et OCS (/ocs/v2.php/…) |
| Authentification | HTTP Basic : identifiant dans NEXTCLOUD_API_USER, secret dans NEXTCLOUD_API_KEY |
| Adresse de l'instance | variable NEXTCLOUD_URL |
| En-têtes fixes | OCS-APIRequest: true, Accept: application/json |
| Licence déclarée | AGPL-3.0 |
| Résidence déclarée | auto-hébergé |
L'en-tête Accept est nécessaire : sans lui, OCS répond en XML étiqueté JSON (remarque consignée dans le fichier).
Outils
Tous les noms commencent par nc_. Répartition par famille, pour les principales :
| Famille | Outils | Exemples réels |
|---|---|---|
nc_share | 15 | nc_share_create, nc_share_list, nc_share_get_shared_with_me, nc_share_accept |
nc_cloud | 15 | nc_cloud_capabilities_list |
nc_apps | 14 | (interfaces des applications Nextcloud) |
nc_core | 14 | nc_core_preview_list |
nc_user | 12 | nc_user_create, nc_user_set_quota, nc_user_add_to_group |
nc_deck | 10 | nc_deck_list_boards, nc_deck_create_card |
nc_taskprocessing | 9 | nc_taskprocessing_schedule_create |
nc_group, nc_app | 6 chacune | nc_group_create, nc_app_install |
Les 66 autres outils se répartissent en petites familles (notifications, activité, références, traduction, texte vers image, étiquettes, avatars, entre autres).
Fichiers : quatre outils seulement, nc_file_get, nc_file_upload, nc_file_download, nc_file_delete, tous sur le chemin WebDAV /remote.php/dav/files/{username}{path}. Aucun outil déclaré ne crée un dossier ni ne liste le contenu d'un dossier, parce que le fichier n'utilise que les méthodes GET, POST, PUT, PATCH et DELETE.
Contacts : trois outils (nc_contact_get, nc_contact_create, nc_contact_update) sur CardDAV. Agenda : un seul outil, nc_calendar_delete. Il n'existe pas d'outil pour lire ou créer des événements de calendrier.
Le connecteur gère aussi les comptes (nc_user_*, nc_group_*) et les applications (nc_app_install, nc_app_remove). Une identité d'administrateur lui donne ces pouvoirs ; préférez un compte restreint.
Configuration
| Variable | Rôle |
|---|---|
NEXTCLOUD_URL | Adresse de l'instance Nextcloud |
NEXTCLOUD_API_USER | Nom d'utilisateur |
NEXTCLOUD_API_KEY | Secret associé à l'identifiant (Basic) |
Dans l'application : page Identifiants (/credentials), fiche Nextcloud, champs « URL du serveur », « Username » (qui alimente NEXTCLOUD_API_USER) et « App Password (revocable) » (qui alimente NEXTCLOUD_API_KEY). Générez ce mot de passe d'application dans les réglages de sécurité de Nextcloud : ce n'est pas votre mot de passe principal.
Les variables NEXTCLOUD_USERNAME et NEXTCLOUD_PASSWORD ne sont lues par aucun connecteur.
Déploiement
Ni podman-compose.vps2.yml ni podman-compose.yml ne déploient Nextcloud. Le connecteur vise une instance que vous fournissez. L'entrée du catalogue métier a le statut available.
Fichier source
connectors/nextcloud.yaml
Voir aussi
- Vue d'ensemble — chiffres mesurés, chargement et règles communes aux douze connecteurs
- Créer votre premier connecteur MCP — forme d'un fichier YAML et ajout d'un connecteur à la passerelle
- Routes MCP — ouvrir une session et appeler un outil par JSON-RPC
- Tarification — nombre de connecteurs métier inclus dans chaque offre
- Limites — la plateforme ne stocke pas de fichiers, ils restent dans l'outil connecté