Na het instellen kan de AI-toepassing het Archicad-project beheren en bewerken, vergelijkbaar met de ingebouwde AI Assistant. Wat er met de koppeling mogelijk is, staat in het artikel Externe AI koppelen aan Archicad via MCP.
Hoe de koppeling werkt
De koppeling wordt eenmalig per AI-toepassing ingesteld. Archicad levert daarvoor twee gegevens aan in het venster Options > Desktop AI Tool Connection:
command: het pad naar het programma dat de MCP-server van Archicad start;
args: het pad naar het serverscript.
Deze gegevens worden in de configuratie van de AI-toepassing ingevuld. Vraagt de AI-toepassing naar het type server, kies dan stdio. Neem de paden altijd over uit het venster in Archicad, want ze verschillen per computer en per taalversie.
Algemene werkwijze
Deze werkwijze geldt voor elke AI-toepassing:
Vraag in de AI-toepassing hoe een lokale MCP-server wordt gekoppeld, bijvoorbeeld: "Hoe koppel ik een lokale MCP-server? Ik heb een command line en een argument van die toepassing."
Kies in Archicad Options > Desktop AI Tool Connection en kopieer de command en args.
Plak de gegevens op de plaats die de AI-toepassing aangeeft. Dat is vaak in het chatvenster zelf.
Kies als servertype stdio als de AI-toepassing daarom vraagt.
Start de AI-toepassing opnieuw als dat nodig is.
Controleer de verbinding met de vraag: "Welke Archicad-projecten zijn momenteel geopend?" Bij meerdere geopende projecten worden ze allemaal getoond.
De volgende hoofdstukken beschrijven de stappen per AI-toepassing.
Claude Desktop
Kies in Archicad Options > Desktop AI Tool Connection en kopieer de command en args.
Kies in Claude Desktop File > Settings > Developer > Edit Config. Het configuratiebestand claude_desktop_config.json opent in een teksteditor.
Voeg de command en args toe aan de sectie mcpServers, zoals in het voorbeeld hieronder, en sla het bestand op.
Sluit Claude Desktop volledig af via File > Exit en start het programma opnieuw. Het hoofdvenster sluiten is niet voldoende.
Controleer de verbinding met de vraag: "Welke Archicad-projecten zijn momenteel geopend?"
Een voorbeeld voor Windows, waarbij [gebruiker] de eigen gebruikersnaam is:
"mcpServers": {
"Archicad Public MCP Server": {
"command": "C:\\Program Files\\Graphisoft\\Archicad 30\\node.exe",
"args": [
"C:\\Users\\[gebruiker]\\AppData\\Local\\Graphisoft\\MCPServer\\Archicad 30 INT\\mcp-node-app.js"
]
}
}
Een voorbeeld voor macOS:
"mcpServers": {
"Archicad Public MCP Server": {
"command": "/Applications/Graphisoft/Archicad 30/Archicad 30.app/Contents/Frameworks/node",
"args": [
"/Users/[gebruiker]/Library/Application Support/Graphisoft/MCPServer/Archicad 30 INT/mcp-node-app.js"
]
}
}In plaats van stap 2 en 3 kan Archicad het configuratiebestand ook zelf aanvullen via het venster Configure Public MCP Server. Selecteer daarin met Browse het configuratiebestand van de AI-toepassing en klik op Configure. Ga daarna verder met stap 4.
Cursor
Kies in Archicad Options > Desktop AI Tool Connection en kopieer de command en args.
Open in Cursor het menu Customize en kies het tabblad MCPs.
Klik op New MCP Server. Het bestand mcp.json opent.
Voeg de command en args toe aan de sectie servers, met als type stdio, zoals in het voorbeeld hieronder.
Controleer de verbinding met de vraag: "Welke Archicad-projecten zijn momenteel geopend?"
Een voorbeeld voor Windows:
{
"servers": {
"Archicad Public MCP Server": {
"type": "stdio",
"command": "C:\\Program Files\\Graphisoft\\Archicad 30\\node.exe",
"args": [
"C:\\Users\\[gebruiker]\\AppData\\Local\\Graphisoft\\MCPServer\\Archicad 30 INT\\mcp-node-app.js"
]
}
}
}Op macOS zijn de paden dezelfde als in het voorbeeld voor Claude Desktop.
ChatGPT Desktop
Kies in Archicad Options > Desktop AI Tool Connection en kopieer de command en args.
Kies in ChatGPT Desktop Settings > Plugins > Add > Add MCP server.
Vul in het venster Connect to a custom MCP de volgende gegevens in:
Name: Archicad Public MCP Server
Type: STDIO
Command to launch: het volledige pad naar node, gekopieerd uit Archicad
Arguments: het volledige pad naar mcp-node-app.js, gekopieerd uit Archicad
Sla de instellingen op en start ChatGPT Desktop opnieuw.
Controleer de verbinding met de vraag: "Welke Archicad-projecten zijn momenteel geopend?"
VS Code
Kies in Archicad Options > Desktop AI Tool Connection en kopieer de command en args.
Maak in de map .vscode een bestand mcp.json aan met dezelfde inhoud als in het voorbeeld voor Cursor, met de command en args uit Archicad.
Start de MCP-server.
Controleer de verbinding met de vraag: "Welke Archicad-projecten zijn momenteel geopend?"
Aandachtspunten
De menu's en instellingen van AI-toepassingen kunnen wijzigen.
De koppeling werkt alleen zolang Archicad geopend is.
Na de koppeling kan de AI-toepassing het echte project wijzigen. Bewaar vooraf een back-up of werk in een Teamwork-project.