Serveur MCP
L'API v0 est aussi disponible comme serveur MCP (Model Context Protocol), pour qu'un assistant IA — Claude, Cursor, VS Code… — puisse l'appeler directement : rechercher un contrat, créer un Ask, suivre une commande, extraire les prix d'une facture.
https://api.switchgrid.tech/mcp
Chaque outil MCP correspond à un endpoint documenté de l'API v0 : mêmes paramètres, mêmes réponses, mêmes erreurs, mêmes rate-limits. Les outils suivent l'API : un endpoint ajouté ou modifié l'est aussi dans le serveur MCP.
Authentification
Deux façons de s'authentifier ; le header x-api-version est inutile dans les deux cas, le serveur MCP cible toujours la v0.
Connexion OAuth (recommandée). Ajoutez simplement l'URL du serveur dans votre client (Claude, ChatGPT, Claude Code, Cursor, VS Code…). Au premier appel, il ouvre une page Switchgrid : connectez-vous, choisissez le projet auquel donner accès, puis autorisez. Le client obtient un jeton limité à ce projet, qu'il renouvelle seul. Les applications connectées sont listées sur la page Clés d'API du projet, d'où vous pouvez les déconnecter à tout moment. Seuls les membres d'un projet peuvent y connecter une application, et le retrait d'un membre déconnecte celles qu'il avait autorisées.
Token d'API. Les clients qui permettent d'envoyer un header peuvent aussi utiliser un token d'API, dans Authorization: Bearer <Token>.
L'assistant agit avec les droits d'une clé d'API du projet : il peut créer des Asks et commander des données.
Configuration
Claude (claude.ai, Claude Desktop), ChatGPT : ajoutez un connecteur personnalisé avec l'URL https://api.switchgrid.tech/mcp, puis connectez-vous.
Claude Code
claude mcp add --transport http switchgrid https://api.switchgrid.tech/mcp
# puis /mcp dans Claude Code pour vous connecter
Cursor, VS Code et autres clients « Streamable HTTP »
{
"mcpServers": {
"switchgrid": { "url": "https://api.switchgrid.tech/mcp" }
}
}
Avec un token d'API plutôt qu'OAuth, ajoutez "headers": { "Authorization": "Bearer <Token>" } (ou --header "Authorization: Bearer <Token>" pour Claude Code).
Outils
Tous les endpoints de l'API v0 sont exposés. Les principaux :
| Outil | Endpoint |
|---|---|
search_contract | POST/search_contract |
create_ask, get_ask | POST/ask |
create_order | POST/integration/enedis/order |
extract_invoice_pricing | API d'extraction de factures, dernière version (0.1) |
- La recherche de contrat passe par la recherche multi-fournisseurs
search_contract, pas par l'ancienne recherche Enedis. - Les fichiers (factures, justificatifs) sont transmis en base64 :
{ "filename": "facture.pdf", "contentBase64": "…" }. - Les outils de l'API v0 acceptent
switchgrid_test_env: "true"pour travailler sur l'environnement de test. - Une réponse de plus de 200 000 caractères (une longue courbe de charge par exemple) est tronquée : réduisez la période demandée.