Skip to content

Commit 89fa486

Browse files
author
Dev Agent Amelia
committed
docs: fix index.md accuracy + remove unimplemented AUTH_MODE pac
1 parent 0b129a5 commit 89fa486

3 files changed

Lines changed: 301 additions & 35 deletions

File tree

‎docs/client-guides/claude-desktop.md‎

Lines changed: 158 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,158 @@
1+
---
2+
layout: default
3+
title: Claude Desktop
4+
parent: Multi-Client Setup
5+
nav_order: 2
6+
---
7+
8+
# Guide : mcp-dataverse sur Claude Desktop
9+
10+
Ce guide couvre l'installation de Claude Desktop depuis zéro jusqu'à un premier appel MCP Dataverse fonctionnel.
11+
12+
---
13+
14+
## Prérequis
15+
16+
| Élément | Version minimale | Remarque |
17+
|---------|-----------------|----------|
18+
| Node.js | 20+ | [nodejs.org](https://nodejs.org) — npx doit être disponible dans le PATH |
19+
| Compte Anthropic | Plan payant (Pro, Max, Team ou Enterprise) | Le plan gratuit ne suffit pas |
20+
| URL Dataverse | `https://yourorg.crm.dynamics.com` | Votre organisation Power Platform |
21+
22+
---
23+
24+
## 1. Installer Claude Desktop
25+
26+
### Windows
27+
28+
1. Télécharger l'installateur depuis **[claude.ai/download](https://claude.ai/download)**
29+
2. Lancer `ClaudeSetup.exe` et suivre l'assistant (installation silencieuse possible avec `/S`)
30+
3. Démarrer Claude Desktop et se connecter avec son compte Anthropic
31+
32+
> Une version arm64 est aussi disponible sur la même page pour les machines Windows ARM.
33+
34+
### macOS
35+
36+
1. Télécharger le fichier `.dmg` depuis **[claude.ai/download](https://claude.ai/download)**
37+
2. Glisser l'icône **Claude** dans le dossier Applications
38+
3. Lancer Claude depuis le Launchpad ou Spotlight et se connecter
39+
40+
---
41+
42+
## 2. Localiser le fichier de configuration
43+
44+
Claude Desktop lit sa configuration MCP dans un fichier JSON dont l'emplacement dépend de l'OS :
45+
46+
| OS | Chemin |
47+
|----|--------|
48+
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
49+
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
50+
51+
Si le fichier n'existe pas encore, le créer (le répertoire parent existe après la première installation).
52+
53+
---
54+
55+
## 3. Configurer mcp-dataverse
56+
57+
Ouvrir `claude_desktop_config.json` dans un éditeur de texte et ajouter (ou fusionner) la clé `mcpServers` :
58+
59+
```json
60+
{
61+
"mcpServers": {
62+
"mcp-dataverse": {
63+
"command": "npx",
64+
"args": ["-y", "mcp-dataverse"],
65+
"env": {
66+
"DATAVERSE_ENV_URL": "https://yourorg.crm.dynamics.com"
67+
}
68+
}
69+
}
70+
}
71+
```
72+
73+
Remplacer `https://yourorg.crm.dynamics.com` par l'URL réelle de votre organisation Dataverse.
74+
75+
76+
### Utiliser un fichier de config à la place d'une variable d'environnement
77+
78+
Si vous préférez stocker l'URL dans `~/.mcp-dataverse/config.json` (créé par `npx mcp-dataverse install`), utiliser `MCP_CONFIG_PATH` :
79+
80+
```json
81+
{
82+
"mcpServers": {
83+
"mcp-dataverse": {
84+
"command": "npx",
85+
"args": ["-y", "mcp-dataverse"],
86+
"env": {
87+
"MCP_CONFIG_PATH": "C:\\Users\\VotreNom\\.mcp-dataverse\\config.json"
88+
}
89+
}
90+
}
91+
}
92+
```
93+
94+
### Installation globale (optionnelle)
95+
96+
Si `mcp-dataverse` est installé globalement (`npm install -g mcp-dataverse`), remplacer `npx` par l'exécutable direct :
97+
98+
```json
99+
{
100+
"command": "mcp-dataverse",
101+
"env": {
102+
"DATAVERSE_ENV_URL": "https://yourorg.crm.dynamics.com"
103+
}
104+
}
105+
```
106+
107+
---
108+
109+
## 4. Redémarrer Claude Desktop
110+
111+
> **Important** — Claude Desktop doit être **entièrement fermé puis relancé** après chaque modification du fichier de configuration. Un simple rechargement d'onglet ne suffit pas.
112+
113+
Sur Windows : clic-droit sur l'icône dans la barre système → **Quitter**, puis relancer.
114+
Sur macOS : `Cmd+Q`, puis relancer depuis le Launchpad.
115+
116+
---
117+
118+
## 5. Authentification Dataverse
119+
120+
Au premier appel d'un outil MCP, le serveur lance un flux d'authentification par code de périphérique (Device Code Flow) :
121+
122+
1. Dans Claude Desktop, cliquer sur l'**icône MCP** (marteau 🔨) dans le coin inférieur droit de la zone de saisie
123+
2. Ouvrir les **journaux du serveur** pour voir l'URL et le code de connexion
124+
3. Ouvrir l'URL dans un navigateur, entrer le code, puis se connecter avec le compte Microsoft 365 qui a accès à Dataverse
125+
4. Une fois authentifié, le serveur stocke le token localement — pas besoin de répéter cette étape
126+
127+
> Le code de périphérique expire après 5 minutes. Si la fenêtre de connexion n'est pas ouverte à temps, relancer l'outil depuis Claude Desktop pour générer un nouveau code.
128+
129+
---
130+
131+
## 6. Vérifier l'installation
132+
133+
Dans la zone de saisie de Claude Desktop, envoyer ce message :
134+
135+
> **"Who am I in Dataverse?"**
136+
137+
Claude appellera `dataverse_whoami` et retournera le nom et l'ID de l'utilisateur authentifié. Une réponse valide confirme que l'intégration fonctionne.
138+
139+
---
140+
141+
## Dépannage rapide
142+
143+
| Symptôme | Cause probable | Solution |
144+
|----------|---------------|---------|
145+
| Le serveur n'apparaît pas dans Claude | Config non sauvegardée ou Claude non redémarré | Vérifier le JSON, relancer complètement Claude |
146+
| Le code de périphérique n'apparaît pas | Journaux MCP non visibles | Cliquer sur l'icône MCP → Server logs |
147+
| `ENOENT npx` | Node.js absent du PATH | Installer Node.js 20+ et relancer Claude |
148+
| Erreur d'URL invalide | Format incorrect | L'URL doit commencer par `https://` et se terminer par `.dynamics.com` |
149+
| Token expiré après 90+ jours inactifs | Refresh token révoqué | Relancer : `npx mcp-dataverse-auth https://yourorg.crm.dynamics.com` |
150+
151+
---
152+
153+
## Ressources
154+
155+
- [Connexion d'un serveur MCP local à Claude Desktop](https://modelcontextprotocol.io/docs/develop/connect-local-servers)
156+
- [Référence complète multi-client](https://codeurali.github.io/mcp-dataverse/multi-client-setup)
157+
- [Démarrage et authentification](https://codeurali.github.io/mcp-dataverse/getting-started)
158+
- [Diagnostic CLI](https://codeurali.github.io/mcp-dataverse/getting-started#diagnostic-cli) : `npx mcp-dataverse doctor`

‎docs/multi-client-setup/claude-desktop.md‎

Lines changed: 0 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -72,15 +72,6 @@ Open `claude_desktop_config.json` in a text editor and add (or merge) the `mcpSe
7272

7373
Replace `https://yourorg.crm.dynamics.com` with the actual URL of your Dataverse organisation.
7474

75-
> **Power Platform CLI (`pac`) users** — If you are already authenticated via `pac auth select`, you can delegate authentication to pac instead of the Device Code Flow by adding `"AUTH_MODE": "pac"` to `env`:
76-
>
77-
> ```json
78-
> "env": {
79-
> "DATAVERSE_ENV_URL": "https://yourorg.crm.dynamics.com",
80-
> "AUTH_MODE": "pac"
81-
> }
82-
> ```
83-
8475
### Using a config file instead of an environment variable
8576

8677
If you prefer to store the URL in `~/.mcp-dataverse/config.json` (created by `npx mcp-dataverse install`), use `MCP_CONFIG_PATH`:

0 commit comments

Comments
 (0)