Installation

La configuration du serveur MCP de Snipcart prend moins de deux minutes. Vous aurez besoin de votre clé API privée et d'un client compatible MCP.

Obtenir votre clé API

1. Connectez-vous à votre Tableau de bord du commerçant Snipcart.
2. Allez dans Compte → Clés API.
3. Copiez votre clé API secrète (commence par ST_ pour le mode test ou SL_ pour le mode production).

Nous vous recommandons de commencer avec votre clé en mode test (ST_...) pour explorer en toute sécurité. Vous pourrez passer en mode production une fois que vous serez à l'aise.

Claude Code

La méthode la plus rapide est la commande CLI :

claude mcp add Snipcart \
  -t http https://snipcart-mcp.azurewebsites.net/mcp \
  --header "X-Snipcart-Api-Key: YOUR_PRIVATE_API_KEY" \
  --scope user

• --scope user rend le serveur disponible pour tous vos projets. Utilisez --scope project pour le restreindre au projet en cours uniquement.

Vous pouvez également l'ajouter manuellement dans votre ~/.claude/settings.json (global) ou .claude/settings.json (au niveau du projet) :

{
  "mcpServers": {
    "snipcart": {
      "url": "https://snipcart-mcp.azurewebsites.net/mcp",
      "headers": {
        "X-Snipcart-Api-Key": "YOUR_PRIVATE_API_KEY"
      }
    }
  }
}

Remplacez YOUR_PRIVATE_API_KEY par la clé que vous avez copiée depuis votre tableau de bord.

Vérifier la connexion

Lancez Claude Code et essayez :

Show me my recent orders

Si tout est connecté, vous verrez vos commandes les plus récentes.

Claude Desktop

Ouvrez votre fichier de configuration claude_desktop_config.json :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "snipcart": {
      "url": "https://snipcart-mcp.azurewebsites.net/mcp",
      "headers": {
        "X-Snipcart-Api-Key": "YOUR_PRIVATE_API_KEY"
      }
    }
  }
}

Redémarrez Claude Desktop. Vous devriez voir les outils Snipcart apparaître dans le menu des outils (l'icône de marteau).

Cursor

Ouvrez Settings → MCP dans Cursor, ou ajoutez directement dans votre .cursor/mcp.json :

{
  "mcpServers": {
    "snipcart": {
      "url": "https://snipcart-mcp.azurewebsites.net/mcp",
      "headers": {
        "X-Snipcart-Api-Key": "YOUR_PRIVATE_API_KEY"
      }
    }
  }
}

Windsurf

Ajoutez dans votre ~/.codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "snipcart": {
      "serverUrl": "https://snipcart-mcp.azurewebsites.net/mcp",
      "headers": {
        "X-Snipcart-Api-Key": "YOUR_PRIVATE_API_KEY"
      }
    }
  }
}

Astuce : Windsurf supporte l'interpolation de variables d'environnement dans les en-têtes. Vous pouvez utiliser "X-Snipcart-Api-Key": "${env:SNIPCART_API_KEY}" pour éviter de coder votre clé en dur.

OpenAI Codex CLI

La méthode la plus rapide est la commande CLI :

codex mcp add snipcart --url https://snipcart-mcp.azurewebsites.net/mcp

Ensuite, éditez ~/.codex/config.toml pour ajouter l'en-tête :

[mcp_servers.snipcart]
url = "https://snipcart-mcp.azurewebsites.net/mcp"
http_headers = { "X-Snipcart-Api-Key" = "YOUR_PRIVATE_API_KEY" }

Ou utilisez une variable d'environnement pour la clé :

[mcp_servers.snipcart]
url = "https://snipcart-mcp.azurewebsites.net/mcp"
env_http_headers = { "X-Snipcart-Api-Key" = "SNIPCART_API_KEY" }

Autres clients MCP

Le serveur MCP de Snipcart utilise le transport Streamable HTTP à l'adresse :

https://snipcart-mcp.azurewebsites.net/mcp

Il requiert un seul en-tête personnalisé pour l'authentification :

X-Snipcart-Api-Key: YOUR_PRIVATE_API_KEY

Tout client MCP supportant les serveurs distants via Streamable HTTP (ou SSE) avec des en-têtes personnalisés devrait fonctionner. Consultez la documentation de votre client pour le format de configuration spécifique.

Note à propos de ChatGPT (web) : Le connecteur MCP de ChatGPT supporte uniquement l'en-tête authorization — il ne permet pas les en-têtes personnalisés comme X-Snipcart-Api-Key. Utilisez le CLI Codex ou un autre client à la place.

Auto-hébergement

Si vous préférez exécuter le serveur MCP sur votre propre infrastructure, il fonctionne sous Bun.

bun install
PORT=3000 bun run src/index.ts

Ensuite, pointez votre client MCP vers votre instance auto-hébergée :

{
  "mcpServers": {
    "snipcart": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "X-Snipcart-Api-Key": "YOUR_PRIVATE_API_KEY"
      }
    }
  }
}

Docker

Un Dockerfile est inclus pour les déploiements conteneurisés :

docker build -t snipcart-mcp .
docker run -p 3000:80 snipcart-mcp

Variables d'environnement

Variable	Défaut	Description
PORT	80	Port HTTP sur lequel le serveur écoute
SNIPCART_TIMEOUT_MS	30000	Délai d'expiration des requêtes API en millisecondes. Augmentez-le pour les boutiques avec plus de 100k commandes.
RATE_LIMIT_MAX	100	Nombre maximum de requêtes par fenêtre par clé API
RATE_LIMIT_WINDOW_MS	60000	Durée de la fenêtre glissante de limitation de débit en millisecondes
CONCURRENT_LIMIT	10	Nombre maximum de requêtes simultanées en cours par clé API

Prochaine étape : Exemples d'utilisation — Découvrez ce que vous pouvez faire avec le serveur MCP de Snipcart.