mcp
Guide d'installation
Configurez Clarity MCP dans Claude Desktop, Cursor ou tout client compatible MCP en moins de 2 minutes.
Prérequis
- Un compte Clarity avec au moins un projet
- Un client IA compatible MCP (Claude Desktop, Cursor, Windsurf, etc.)
L'assistant de configuration ci-dessous générera un extrait de configuration prêt à coller pour votre client. Il vous suffit de coller votre clé API et de copier la configuration.
1Get your API key
Generate an API key in your Clarity settings. You'll paste it into the config below.
Create API key in Settings2Configure your client
Config file location:
macOS
~/Library/Application Support/Claude/claude_desktop_config.jsonWin
%APPDATA%\Claude\claude_desktop_config.jsonjson
{
"mcpServers": {
"clarity": {
"command": "npx",
"args": [
"-y",
"clarity-mcp@latest"
],
"env": {
"CLARITY_API_KEY": "<your-api-key>",
"CLARITY_API_URL": "https://www.claritynotes.xyz"
}
}
}
}- 1Open Claude Desktop → Settings → Developer → Edit Config
- 2Paste the config below into
claude_desktop_config.json - 3Replace
<your-api-key>with the key you copied - 4Save the file and restart Claude Desktop
3Verify the connection
Ask your AI assistant:
“List my Clarity projects”
If configured correctly, it will call the list_projects tool and return your workspace.
Dépannage
| Problème | Solution |
|---|---|
| "CLARITY_API_KEY is required" | Assurez-vous que le bloc env contient votre clé |
| "API 401: Invalid API key" | Régénérez la clé dans Settings → MCP / API |
| Les outils n'apparaissent pas | Redémarrez votre client IA après avoir modifié la configuration |
Vous pouvez tester la connexion en demandant à votre IA : « Liste mes projets Clarity. » Si elle renvoie votre espace de travail, tout fonctionne.
Cet article vous a-t-il été utile ?
