Integration avec un client MCP

TopSolid MCP supporte deux modes de connexion. L'endpoint HTTP natif est recommande pour la majorite des cas.

Deux modes de connexion

	HTTP natif (recommande)	Stdio direct (alternatif)
Demarrage	`install\Installer_TopSolidMCP.bat` une fois (ou `TopSolidMcpServer.exe --http-standalone`)	Automatique par le client
Config client	`"url": "http://127.0.0.1:8080/mcp"`	`"command": "C:\...\TopSolidMcpServer.exe"`
Multi-clients simultanes	Oui	Non (singleton)
claude.ai web / app	Oui (via tunnel)	Non
Node.js requis	Non (natif dans l'exe)	Non

Le serveur vient dans le zip de release : dezipper, double-clic sur install\Installer_TopSolidMCP.bat (voie noob) ou lancer l'exe avec --http-standalone. Laissez la console ouverte ; en usage quotidien, l'installer a deja cree la tache planifiee qui fait le travail.

Clients compatibles

Client	Stdio	HTTP natif	Notes
Claude Desktop	Oui	Oui
Claude Code (terminal)	Oui	Oui
Cursor	Oui	Oui
Windsurf	Oui	Oui
VS Code + GitHub Copilot	Oui	Oui	Mode Agent uniquement
JetBrains + AI Assistant	Oui	Oui
Antigravity / Cline / Roo Code	Oui	Oui
Continue	Oui	Oui
OpenClaw	Via sous-agent	Via URL	Config `openclaw.json`
claude.ai (web + app)	Non	Oui (tunnel requis)	Voir bridge-http
ChatGPT Desktop	Non	Non	Pas de support MCP local

Claude Desktop

Fichier de config :

%APPDATA%\Claude\claude_desktop_config.json

Acces : Claude Desktop → menu hamburger → Settings → Developer → Edit Config.

Via HTTP (recommande)Via stdio

json

{
  "mcpServers": {
    "topsolid": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

json

{
  "mcpServers": {
    "topsolid": {
      "command": "C:\\TopSolidMCP\\TopSolidMcpServer.exe"
    }
  }
}

Quittez completement Claude Desktop (clic droit icone notification > Quit) et relancez. L'icone marteau en bas du champ de saisie confirme la connexion.

Claude Code (terminal)

Via HTTP (recommande)Via stdio

powershell

claude mcp add --transport http topsolid http://127.0.0.1:8080/mcp
claude mcp list   # verification

powershell

claude mcp add topsolid C:\TopSolidMCP\TopSolidMcpServer.exe

Ou en fichier .mcp.json a la racine du projet :

Via HTTPVia stdio

json

{
  "mcpServers": {
    "topsolid": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

json

{
  "mcpServers": {
    "topsolid": {
      "command": "C:\\TopSolidMCP\\TopSolidMcpServer.exe"
    }
  }
}

Cursor

Option A — Via l'interface :

Settings (Ctrl+,) → MCP → Add new MCP server
Remplissez :
- Name : topsolid
- Type : http (ou sse pour la compat legacy)
- URL : http://127.0.0.1:8080/mcp

Option B — Via fichier %USERPROFILE%\.cursor\mcp.json :

Via HTTP (recommande)Via stdio

json

{
  "mcpServers": {
    "topsolid": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

json

{
  "mcpServers": {
    "topsolid": {
      "command": "C:\\TopSolidMCP\\TopSolidMcpServer.exe"
    }
  }
}

Windsurf

Ctrl+Shift+P → Windsurf: Configure MCP Servers, ou editez directement %USERPROFILE%\.codeium\windsurf\mcp_config.json :

Via HTTP (recommande)Via stdio

json

{
  "mcpServers": {
    "topsolid": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

json

{
  "mcpServers": {
    "topsolid": {
      "command": "C:\\TopSolidMCP\\TopSolidMcpServer.exe"
    }
  }
}

VS Code + GitHub Copilot

GitHub Copilot supporte MCP depuis VS Code 1.99+ (avril 2025), en mode Agent uniquement.

Etape 1 : Settings (Ctrl+,) → cherchez mcp enabled → cochez Chat > Mcp: Enabled

Etape 2 : Creez .vscode/mcp.json a la racine du projet :

Via HTTP (recommande)Via stdio

json

{
  "servers": {
    "topsolid": {
      "type": "http",
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

json

{
  "servers": {
    "topsolid": {
      "type": "stdio",
      "command": "C:\\TopSolidMCP\\TopSolidMcpServer.exe"
    }
  }
}

Copilot Chat en mode Agent uniquement

Selectionnez le mode Agent en haut du panneau Chat (pas "Edit" ni "Ask").

JetBrains (IntelliJ, Rider, WebStorm...)

File > Settings > Tools > AI Assistant > Model Context Protocol (MCP) > + > As JSON :

Via HTTP (recommande)Via stdio

json

{
  "mcpServers": {
    "topsolid": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

json

{
  "mcpServers": {
    "topsolid": {
      "command": "C:\\TopSolidMCP\\TopSolidMcpServer.exe"
    }
  }
}

Import depuis Claude Desktop

Si vous avez deja configure Claude Desktop, cliquez Import from Claude Desktop pour importer automatiquement.

Antigravity / Cline / Roo Code

Ces extensions VS Code ont leur propre gestion MCP. Ouvrez leur panel → Settings → MCP Servers → Edit Config :

Via HTTP (recommande)Via stdio

json

{
  "mcpServers": {
    "topsolid": {
      "url": "http://127.0.0.1:8080/mcp",
      "disabled": false
    }
  }
}

json

{
  "mcpServers": {
    "topsolid": {
      "command": "C:\\TopSolidMCP\\TopSolidMcpServer.exe",
      "disabled": false
    }
  }
}

Sauvegardez (Ctrl+S). L'extension detecte le changement automatiquement. Verifiez que les outils TopSolid apparaissent dans le panneau MCP.

Continue (VS Code / JetBrains)

Editez ~/.continue/config.json :

Via HTTP (recommande)Via stdio

json

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "http",
          "url": "http://127.0.0.1:8080/mcp"
        }
      }
    ]
  }
}

json

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "C:\\TopSolidMCP\\TopSolidMcpServer.exe"
        }
      }
    ]
  }
}

OpenClaw

Configuration pour le framework multi-agents OpenClaw.

Dans ~/.openclaw/openclaw.json, le serveur MCP TopSolid peut etre configure en HTTP ou stdio :

Via HTTP (recommande)Via stdio

json

{
  "agents": {
    "topsolid": {
      "mcp": {
        "topsolid": {
          "url": "http://127.0.0.1:8080/mcp"
        }
      }
    }
  }
}

json

{
  "agents": {
    "topsolid": {
      "mcp": {
        "topsolid": {
          "command": "C:\\TopSolidMCP\\TopSolidMcpServer.exe"
        }
      }
    }
  }
}

Le sous-agent TopSolid est configure dans ~/.openclaw/agents/topsolid/agent/system.md. Le skill et les tool permissions ne dependent pas du mode de transport.

claude.ai (web + app Windows)

claude.ai accepte uniquement des serveurs MCP distants via URL. L'endpoint HTTP natif, expose via un tunnel, permet cette connexion.

Ce que le tunnel expose

L'endpoint publielie sur Internet des outils qui compilent et executent du code arbitraire sur votre poste (topsolid_execute_script, topsolid_modify_script) ainsi que les recettes d'ecriture PDM. Une URL de tunnel nu, sans authentification, suffit a quiconque la connait pour piloter votre TopSolid et votre systeme de fichiers.

Mettez Cloudflare Access (ou un equivalent) devant le tunnel avant d'y brancher quoi que ce soit. Le tunnel nu trycloudflare.com n'est pas recommande, meme temporairement.

Etapes resumees :

Demarrez le serveur (install\Installer_TopSolidMCP.bat ou TopSolidMcpServer.exe --http-standalone)
Publiez-le derriere un tunnel nomme + Cloudflare Access — procedure detaillee dans le guide HTTP
claude.ai → Settings → Connecteurs → Ajouter → https://topsolid-mcp.votredomaine.com/mcp

Voir le guide HTTP complet pour l'installation pas-a-pas, la securite et le troubleshooting.

ChatGPT Desktop

Non supporte

ChatGPT Desktop ne supporte pas les serveurs MCP locaux (mai 2026). Utilisez Claude Desktop, Cursor ou Claude Code.

Outils disponibles

Une fois connecte, votre assistant IA dispose des outils suivants :

Outil	Description
`topsolid_get_state`	Etat de connexion, document actif, projet courant
`topsolid_run_recipe`	Execute une des 195 recettes pre-construites
`topsolid_list_recipes`	Catalogue des recettes, filtrable par categorie ou mot-cle
`topsolid_get_recipe`	Retourne le code source C# d'une recette
`topsolid_api_help`	Recherche dans l'API TopSolid (1728 methodes, synonymes FR)
`topsolid_execute_script`	Compile et execute du C# hors transaction de modification
`topsolid_modify_script`	Compile et execute du C# avec transaction (Pattern D auto)
`topsolid_compile`	Compile-check d'un script sans l'executer (`CSharpCodeProvider`, C# 5)
`topsolid_find_path`	Chemin Dijkstra entre types dans le graphe API
`topsolid_explore_paths`	Exploration BFS multi-chemins
`topsolid_search_help`	FTS5 sur 5809 pages de l'aide en ligne TopSolid
`topsolid_search_commands`	Recherche dans 2428 commandes UI TopSolid (Layer 2)
`topsolid_search_examples`	Recherche dans les corpora prives locaux (opt-in, env var)

Pour la plupart des usages

topsolid_run_recipe suffit. Les 195 recettes couvrent PDM, parametres, export, assemblages, familles, mise en plan, nomenclature et plus. Demandez simplement en francais.

N'auto-approuvez pas les outils de script

topsolid_execute_script et topsolid_modify_script compilent et executent du C# en pleine confiance dans le processus du serveur, sur votre poste. « Lecture seule » signifie seulement « hors transaction de modification TopSolid » — ce n'est pas un bac a sable.

Ne les ajoutez pas a la liste des outils toujours autorises de votre client MCP. Si vous n'avez besoin que de consulter, lancez le serveur avec --read-only : topsolid_modify_script n'est alors meme pas enregistre. Voir Options de lancement.

Troubleshooting

`Graph data not found at expected locations`

Le fichier graph.json n'est pas au bon endroit. Le serveur cherche dans :

data\graph.json (sous-dossier a cote de l'exe)
graph.json (a cote de l'exe)
En remontant 3 niveaux (mode developpement)

`Another TopSolidMcpServer instance is already running`

Le serveur est un singleton (un seul processus). Avec le mode HTTP natif, un seul processus sert tous les clients — ce message ne doit pas apparaitre. En mode stdio avec plusieurs clients, forcez l'arret :

powershell

Get-Process TopSolidMcpServer -ErrorAction SilentlyContinue | Stop-Process

`Connect() retourne false`

Normal dans TopSolid v7.20 (bug connu). Le serveur verifie via TopSolidHost.Version > 0 a la place. Si les outils fonctionnent, tout va bien.

Les outils n'apparaissent pas

Verifiez que TopSolid est ouvert avant de lancer le client IA
En mode HTTP : verifiez que le serveur tourne (icone systray, ou Get-NetTCPConnection -LocalPort 8080 -State Listen)
En mode stdio : verifiez le chemin vers l'exe (doubles backslashs \\)
Quittez completement le client IA et relancez (pas juste fermer la fenetre)

Integration avec un client MCP ​

Deux modes de connexion ​

Clients compatibles ​

Claude Desktop ​

Claude Code (terminal) ​

Cursor ​

Windsurf ​

VS Code + GitHub Copilot ​

JetBrains (IntelliJ, Rider, WebStorm...) ​

Antigravity / Cline / Roo Code ​

Continue (VS Code / JetBrains) ​

OpenClaw ​

claude.ai (web + app Windows) ​

ChatGPT Desktop ​

Outils disponibles ​

Troubleshooting ​

Graph data not found at expected locations ​

Another TopSolidMcpServer instance is already running ​

Connect() retourne false ​

Les outils n'apparaissent pas ​

Integration avec un client MCP

Deux modes de connexion

Clients compatibles

Claude Desktop

Claude Code (terminal)

Cursor

Windsurf

VS Code + GitHub Copilot

JetBrains (IntelliJ, Rider, WebStorm...)

Antigravity / Cline / Roo Code

Continue (VS Code / JetBrains)

OpenClaw

claude.ai (web + app Windows)

ChatGPT Desktop

Outils disponibles

Troubleshooting

`Graph data not found at expected locations`

`Another TopSolidMcpServer instance is already running`

`Connect() retourne false`

Les outils n'apparaissent pas