You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> Les installations Homebrew et WinGet **ne se mettent pas à jour automatiquement**. Utiliser`brew upgrade claude-code`ou`winget upgrade Anthropic.ClaudeCode`pour les mises à jour manuelles.
63
+
> Homebrew and WinGet installations **do not update automatically**. Use`brew upgrade claude-code`or`winget upgrade Anthropic.ClaudeCode`for manual updates.
64
64
65
65
---
66
66
67
-
## 2. Vérifier l'installation
67
+
## 2. Verify the installation
68
68
69
69
```bash
70
70
claude --version
71
71
claude doctor
72
72
```
73
73
74
-
`claude doctor`vérifie la version de Node.js, la configuration, l'authentification et la connectivité réseau.
74
+
`claude doctor`checks the Node.js version, configuration, authentication, and network connectivity.
75
75
76
76
---
77
77
78
-
## 3. Premier lancement et authentification Anthropic
78
+
## 3. First launch and Anthropic authentication
79
79
80
-
Lancer Claude Code dans le répertoire de travail :
80
+
Launch Claude Code in the working directory:
81
81
82
82
```bash
83
83
claude
84
84
```
85
85
86
-
À l'invite, sélectionner**Sign in with Claude.ai**et suivre les instructions dans le navigateur. Claude Code nécessite un plan Pro, Max, Teams, Enterprise ou un compte Console API.
86
+
At the prompt, select**Sign in with Claude.ai**and follow the instructions in the browser. Claude Code requires a Pro, Max, Teams, Enterprise plan or a Console API account.
87
87
88
88
---
89
89
90
-
## 4. Configurer mcp-dataverse
90
+
## 4. Configure mcp-dataverse
91
91
92
-
### Méthode rapide — commande `mcp add`
92
+
### Quick method — `mcp add` command
93
93
94
-
Enregistrer le serveur avec la variable d'environnement intégrée et en portée globale (`--scope user`) pour que l'outil soit disponible dans tous les projets :
94
+
Register the server with the built-in environment variable and global scope (`--scope user`) so that the tool is available in all projects:
95
95
96
96
**macOS / Linux / WSL**
97
97
```bash
@@ -109,23 +109,23 @@ claude mcp add --transport stdio --scope user `
109
109
-- cmd /c npx -y mcp-dataverse
110
110
```
111
111
112
-
> **Windows natif** : le wrapper `cmd /c`est obligatoire — sans lui, `npx`ne peut pas être exécuté directement et retourne une erreur "Connection closed".
112
+
> **Native Windows**: the `cmd /c`wrapper is mandatory — without it, `npx`cannot be executed directly and returns a "Connection closed" error.
113
113
114
-
> **Ordre des arguments** : le nom du serveur (`mcp-dataverse`) doit impérativement être placé **avant**le flag `-e`/`--env`. En raison du comportement variadic de `-e <env...>`, placer le nom après la variable d'environnement provoque l'erreur`Invalid environment variable format: mcp-dataverse`.
114
+
> **Argument order**: the server name (`mcp-dataverse`) must be placed **before**the `-e`/`--env` flag. Due to the variadic behaviour of `-e <env...>`, placing the name after the environment variable causes the error`Invalid environment variable format: mcp-dataverse`.
115
115
116
-
Cette commande écrit l'entrée dans `~/.claude.json`automatiquement.
116
+
This command writes the entry to `~/.claude.json`automatically.
|`project`|All project members |`.mcp.json`at the root|
124
+
|`user`|All your projects (recommended) |`~/.claude.json`|
125
125
126
-
### Méthode manuelle — édition de`~/.claude.json`
126
+
### Manual method — editing`~/.claude.json`
127
127
128
-
Ouvrir (ou créer) `~/.claude.json`et ajouter la clé `mcpServers` :
128
+
Open (or create) `~/.claude.json`and add the `mcpServers`key:
129
129
130
130
```json
131
131
{
@@ -141,9 +141,9 @@ Ouvrir (ou créer) `~/.claude.json` et ajouter la clé `mcpServers` :
141
141
}
142
142
```
143
143
144
-
### Portée workspace (projet spécifique)
144
+
### Workspace scope (project-specific)
145
145
146
-
Pour limiter le serveur à un seul projet, créer`.mcp.json`à la racine du projet :
146
+
To restrict the server to a single project, create`.mcp.json`at the project root:
147
147
148
148
```json
149
149
{
@@ -161,31 +161,31 @@ Pour limiter le serveur à un seul projet, créer `.mcp.json` à la racine du pr
161
161
162
162
---
163
163
164
-
## 5. Authentification Dataverse
164
+
## 5. Dataverse authentication
165
165
166
-
Au premier appel d'un outil MCP, le serveur lance un flux Device Code :
166
+
On the first call of an MCP tool, the server initiates a Device Code flow:
167
167
168
-
1.Le code et l'URL s'affichent **directement dans le terminal**Claude Code
169
-
2.Ouvrir l'URL dans un navigateur, entrer le code, se connecter avec le compte Microsoft 365 ayant accès à Dataverse
170
-
3.Le token est stocké localement — pas besoin de répéter cette étape
168
+
1.The code and URL are displayed **directly in the Claude Code terminal**
169
+
2.Open the URL in a browser, enter the code, and sign in with the Microsoft 365 account that has access to Dataverse
170
+
3.The token is stored locally — there is no need to repeat this step
171
171
172
-
> Le code expire après 5 minutes. En cas d'expiration, relancer la commande pour en générer un nouveau.
172
+
> The code expires after 5 minutes. If it expires, re-run the command to generate a new one.
173
173
174
174
---
175
175
176
-
## 6. Vérifier l'intégration
176
+
## 6. Verify the integration
177
177
178
-
Depuis la session Claude Code, poser la question :
178
+
From the Claude Code session, ask:
179
179
180
180
> **"Who am I in Dataverse?"**
181
181
182
-
Claude appellera `dataverse_whoami`. Une réponse indiquant le nom de l'utilisateur confirme que tout fonctionne.
182
+
Claude will call `dataverse_whoami`. A response showing the user's name confirms that everything is working.
183
183
184
184
---
185
185
186
-
## Plusieurs environnements Dataverse
186
+
## Multiple Dataverse environments
187
187
188
-
Pour travailler avec plusieurs organisations, définir des entrées distinctes :
188
+
To work with multiple organisations, define separate entries:
189
189
190
190
```json
191
191
{
@@ -206,20 +206,20 @@ Pour travailler avec plusieurs organisations, définir des entrées distinctes :
206
206
207
207
---
208
208
209
-
## Dépannage rapide
209
+
## Quick troubleshooting
210
210
211
-
|Symptôme|Cause probable| Solution |
211
+
|Symptom|Probable cause| Solution |
212
212
|----------|---------------|---------|
213
-
|`ENOENT npx`| Node.js absent du PATH |Installer Node.js 20+ |
214
-
|Code de périphérique non affiché | Variable d'environnement non définie avant le lancement | Définir`DATAVERSE_ENV_URL`dans le shell avant de lancer`claude`|
215
-
|Supprimer un serveur MCP | — |`claude mcp remove mcp-dataverse`|
216
-
|Lister les serveurs MCP configurés| — |`claude mcp list`|
217
-
|Migrer depuis npm vers l'installation native | npm deprecated |`curl -fsSL https://claude.ai/install.sh \| bash`puis`npm uninstall -g @anthropic-ai/claude-code`|
213
+
|`ENOENT npx`| Node.js absent from PATH |Install Node.js 20+ |
214
+
|Device code not displayed | Environment variable not defined before launch | Set`DATAVERSE_ENV_URL`in the shell before launching`claude`|
215
+
|Remove an MCP server| — |`claude mcp remove mcp-dataverse`|
0 commit comments