# CampKeeper MCP

> Serveur MCP distant read-only exposant les données CampKeeper (campings, hébergements, ménage, réservations, équipes).

CampKeeper MCP est un serveur Model Context Protocol accessible en HTTP (Streamable HTTP).
Il est strictement read-only : aucun tool ne modifie les données backend.

## Connexion

- URL: https://mcp.campkeeper.io/mcp
- Auth: en-tête HTTP `Authorization: Bearer <token>`

## Capacités (tools)

- search: Recherche globale dans les hebergements, equipes et reservations.
- list_campings: Liste les campings accessibles a l'utilisateur.
- get_camping: Recupere les details d'un camping.
- list_accommodations: Liste les hebergements (aussi appeles bungalows, mobil-homes, chalets, emplacements, parcelles, locatifs) avec filtres optionnels. Retourne {total, items}. Si total > nombre d'items, prevenir l'utilisateur qu'il y a plus de resultats. Ne pas filtrer par model sauf si l'utilisateur demande un modele precis (ex: 'Confort 4p', 'Premium 6p').
- get_accommodation: Recupere les details d'un hebergement (bungalow, mobil-home, chalet, etc.).
- list_accommodation_statuses: Liste tous les statuts d'hebergement disponibles.
- list_reservations: Liste les reservations avec filtres optionnels.
- get_reservation_details: Recupere une reservation avec ses relations (hebergement, camping).
- list_cleaning_tasks: Liste les taches de menage avec filtres optionnels.
- get_cleaning_task: Recupere les details d'une tache de menage.
- list_teams: Liste les equipes accessibles.
- get_team_with_members: Recupere une equipe avec la liste de ses membres.
- get_team_members: Liste les membres d'une equipe.
- get_team_tasks: Recupere les taches assignees a une equipe pour une date.
- get_all_teams_tasks_today: Recupere les taches de toutes les equipes pour aujourd'hui.
- get_upcoming_checkouts: Recupere les check-outs a venir pour planifier les menages.
- get_housekeeping_schedule: Recupere le planning des menages.
- get_unified_planning: Planning unifie combinant check-outs et menages planifies. Vue la plus complete.
- get_housekeeping_statistics: Statistiques sur les taches de menage (completees, en cours, etc.).

## Token

- Flask Admin: https://admin.campkeeper.io/settings/ (à venir)
- CLI: `uvx campkeeper-mcp-token` ou `uv run campkeeper-mcp-token`
- Durée de vie: ~30 jours d'inactivité. Expire après 30 jours sans usage ; chaque appel réinitialise le délai.

## Liens

- Documentation: /
- Endpoint MCP: /mcp