Le guide des agents
PalmaPlan expose un serveur MCP complet : 101 tools, 10 resources et 5 prompts (le compte exact, vérifié à chaque construction, est dans la référence générée). Un agent — Claude Code, Claude Desktop, ou tout autre client MCP — s'y branche sans écrire une ligne de code contre l'API : le serveur MCP est l'API, dans les mots du planning plutôt que dans ceux d'un schéma REST.
Cette partie du wiki a deux lecteurs à la fois, et le dit sans détour : un humain qui branche un agent sur son instance, et l'agent lui-même, qui peut la lire brute (sans rendu) pour apprendre à s'en servir sans qu'on la lui explique à la main.
- Brancher Claude Code — la commande, l'autorisation dans le navigateur pas à pas, le jeton nommé qui en sort, ce qu'on vérifie quand ça coince.
- Brancher Claude Desktop — stdio, la configuration, le piège de l'adresse.
- Les jetons et les portées — lecture / écriture, un jeton par client, la révocation, ce qu'un agent ne peut pas faire.
- La vue embarquée —
show_schedule, MCP Apps, et ce qu'un agent qui ne la rend pas reçoit à la place. - La référence des tools, resources et prompts — générée depuis le serveur lui-même, jamais écrite à la main.
- Pour les agents — le chemin machine, sans détour humain : découvrir, s'authentifier, construire un planning, en lire un.
Tout ce qui est décrit ici est vérifié contre le code du serveur MCP (packages/mcp/src/) et l'OAuth de l'API (packages/api/src/http/oauth.ts), ou rejoué en réel sur une instance locale. Là où quelque chose n'a pas encore été rejoué en conditions réelles, la page le dit — plutôt que de le présenter comme acquis.