# 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](reference-tools.md)).
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](claude-code.md)** — 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](claude-desktop.md)** — stdio, la configuration, le piège de
  l'adresse.
- **[Les jetons et les portées](jetons-et-portees.md)** — lecture / écriture, un jeton par
  client, la révocation, ce qu'un agent ne peut pas faire.
- **[La vue embarquée](vue-embarquee.md)** — `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](reference-tools.md)** — générée depuis
  le serveur lui-même, jamais écrite à la main.
- **[Pour les agents](pour-les-agents.md)** — 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.
