Serveur MCP Sandtime.io

Ouvrez le fichier de configuration

Claude Desktop l’ouvre pour vous via Settings > Developer > Edit Config. Si ce menu est absent ou si le fichier ne s’ouvre pas, le chemin direct vers le fichier se trouve ci-dessous.

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

Ajoutez le serveur

Ce fichier contient aussi le reste de vos réglages Claude Desktop, complétez-le donc plutôt que de le remplacer. L’extrait dont vous avez besoin dépend de la présence ou non d’un bloc mcpServers dans le fichier.

S’il n’y a pas encore de bloc mcpServers, ajoutez ceci comme une nouvelle clé à côté de vos autres réglages, avec une virgule entre les deux.

"mcpServers": {
  "sandtime": {
    "command": "npx",
    "args": [
      "mcp-remote",
      "https://mcp.sandtime.io/mcp",
      "--header",
      "Authorization:${AUTH}"
    ],
    "env": { "AUTH": "Bearer YOUR_API_KEY" }
  }
}

Si le bloc mcpServers existe déjà, collez ceci à l’intérieur, avec une virgule avant tout serveur déjà présent.

"sandtime": {
  "command": "npx",
  "args": [
    "mcp-remote",
    "https://mcp.sandtime.io/mcp",
    "--header",
    "Authorization:${AUTH}"
  ],
  "env": { "AUTH": "Bearer YOUR_API_KEY" }
}

Un piège sous Windows

Sous Windows, vérifiez la ligne Authorization:${AUTH} ci-dessus pour un espace superflu. Un espace après les deux-points casse la connexion, et Claude Desktop renvoie alors une erreur d’authentification (401) sans indice sur la cause.

Redémarrez, puis vérifiez

Les serveurs MCP ne se chargent qu’au démarrage de l’application et ne sont plus jamais vérifiés ensuite, donc le nouveau ne fonctionnera pas tant que vous n’aurez pas quitté l’application complètement et rouvert, pas seulement fermé la fenêtre. Demandez-lui ensuite quelque chose de simple sur l’application, par exemple vos projets ou vos heures suivies. Une réponse sensée signifie que la clé, l’URL et l’en-tête sont tous corrects.

Par utilisateur

Écrit la configuration dans ~/.claude.json (~ correspond à %USERPROFILE% sous Windows), le serveur vous attend donc dans chaque projet ouvert sur cette machine.

claude mcp add --transport http --scope user sandtime https://mcp.sandtime.io/mcp --header "Authorization: Bearer YOUR_API_KEY"

Par projet

La même commande avec --scope project, qui écrit .mcp.json dans le répertoire courant : Claude Code ne le trouve donc que dans ce projet. Ce fichier est destiné à être commité. Préférez la portée par utilisateur si vous voulez plutôt que le serveur soit disponible partout.

claude mcp add --transport http --scope project sandtime https://mcp.sandtime.io/mcp --header "Authorization: Bearer YOUR_API_KEY"

Installation manuelle

L’entrée est la même partout, seul le fichier détermine sa portée. Chacun de ces fichiers contient aussi d’autres réglages, alors complétez-le au lieu de le remplacer.

Par utilisateur (macOS, Linux)

~/.claude.json

Par utilisateur (Windows)

%USERPROFILE%\.claude.json

Par projet

.mcp.json

S’il n’y a pas encore de bloc mcpServers, ajoutez ceci comme une nouvelle clé à côté de vos autres réglages, avec une virgule entre les deux.

"mcpServers": {
  "sandtime": {
    "type": "http",
    "url": "https://mcp.sandtime.io/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_API_KEY"
    }
  }
}

Si le bloc mcpServers existe déjà, collez ceci à l’intérieur, avec une virgule avant tout serveur déjà présent.

"sandtime": {
  "type": "http",
  "url": "https://mcp.sandtime.io/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

Connectez un MCP personnalisé

Ouvrez Settings > Plugins > MCPs et ajoutez un MCP personnalisé en choisissant Streamable HTTP plutôt que STDIO. URL ci-dessous va dans le champ d’adresse, et le nom et la valeur de l’en-tête ensemble sous Headers. Cet écran a aussi des champs Bearer token env var et Headers from environment variables, mais ceux-ci transmettent les secrets autrement, alors laissez-les vides.

URL

https://mcp.sandtime.io/mcp

Nom de l’en-tête

Authorization

Valeur de l’en-tête

Bearer YOUR_API_KEY

Enregistrez et activez

Enregistrez, redémarrez l’application, puis activez l’entrée dans la liste. Ajouter un serveur ne l’active pas. Cet écran ne propose aucune portée : l’entrée va donc toujours dans le fichier par utilisateur.

Dans config.toml, par utilisateur ou par projet

La même entrée ajoutée à la main, à la suite de ce que le fichier contient déjà. Le fichier par utilisateur fonctionne de la même façon dans l’application de bureau, la CLI et l’extension IDE. Le fichier par projet est plus restreint : il ne fonctionne que dans la CLI et l’extension IDE, seulement dans un projet de confiance.

Par utilisateur (macOS, Linux)

~/.codex/config.toml

Par utilisateur (Windows)

%USERPROFILE%\.codex\config.toml

Par projet

.codex/config.toml

[mcp_servers.sandtime]
url = "https://mcp.sandtime.io/mcp"

[mcp_servers.sandtime.http_headers]
Authorization = "Bearer YOUR_API_KEY"

Comment les fichiers se superposent

Les fichiers de projet sont lus de la racine du dépôt jusqu’à votre dossier courant, le plus proche l’emportant, avec le fichier par utilisateur en dessous de tous. Si CODEX_HOME est définie, le fichier par utilisateur s’y trouve au lieu de votre dossier personnel.

Le piège du projet non fiable

Codex ne lit les fichiers de projet que dans un projet marqué comme fiable ; dans un projet non fiable, il les ignore sans rien dire. Si un serveur n’apparaît jamais, vérifiez d’abord si le projet est fiable, avant de vérifier la configuration elle-même.