Conexão Pública MCP

Requisitos

• Um plano de subscrição do Archicad que suporte a Conexão Pública MCP — ex.: Archicad Collaborate ou Archicad Max.
• Uma ferramenta local de IA de desktop que suporte ligação a um servidor MCP local de terceiros – a sua ferramenta de IA conseguirá confirmar isto.

Fluxo de trabalho geral para estabelecer a conexão

Para estabelecer uma conexão entre o Archicad e a sua ferramenta de IA, precisará de criar uma conexão. A sua ferramenta de IA fará isto com as informações a que pode aceder a partir do Archicad e fornecer depois à sua ferramenta de IA. Isto só precisa de ocorrer uma vez por ferramenta de IA.

1. Na sua ferramenta de IA, pode perguntar: “Pode dizer-me como conecto um Servidor MCP local? Tenho uma linha de comandos e argumentos dessa aplicação para criar esta conexão.”
2. Após a sua ferramenta de IA o informar sobre o método de conexão, mude para o Archicad para recolher as informações necessárias.
3. No Archicad, abra a caixa de diálogo ‘Desktop AI Tool Connection’ (menu Opções):

1. Copie o texto de “linha de comandos e argumentos” apresentado nesta caixa de diálogo do Archicad.
2. Volte à sua ferramenta de IA e cole este texto na localização que a sua ferramenta de IA sugeriu (normalmente na própria interface de chat).
3. A sua ferramenta de IA pode necessitar de saber o tipo de servidor. Se for o caso, utilize ‘stdio’.
4. A sua ferramenta de IA estabelecerá a conexão utilizando as informações acima.
5. Poderá ser necessário reiniciar a sua ferramenta de IA.
6. Pode verificar a conexão perguntando: ‘Que projectos do Archicad estão abertos de momento?’ Se tiver múltiplos projetos abertos, a sua ferramenta de IA irá listá-los a todos.
7. Uma vez conectado, pode começar a colocar comandos relevantes do Archicad MCP.

Para saber mais sobre as ferramentas Archicad MCP e exemplos de comandos, consulte: Ferramentas MCP suportadas

Exemplos de configurações

Claude Desktop

1. Abra o ficheiro de configuração em Ficheiro > Definições > Programador > Editar Config. Irá apontar para o seu ficheiro claude_desktop_config.json, que deve ser aberto num editor de texto.
2. Estenda a secção mcpServers com o command e os args obtidos a partir do Archicad clicando no comando Desktop AI Tool Connection.
3. Guarde as alterações no ficheiro de configuração e reinicie a aplicação Claude desktop. Tenha em atenção que fechar a janela principal do Claude não fecha a aplicação. Para sair, utilize Ficheiro > Sair.
4. Reinicie o Claude e teste a ligação ao servidor MCP utilizando este comando: ‘Diz-me as instâncias do Archicad em execução’.

A localização do ficheiro de configuração depende do computador; eis um exemplo:

C:\Users\<your_user>\AppData\Local\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude \ claude_desktop_config.json

 "mcpServers": {
    "Archicad Public MCP Server": {
      "command": "C:\\Program Files\\Graphisoft\\Archicad 30\\node.exe",
      "args": [
        "C:\\Users\\<your_user>\\AppData\\Local\\Graphisoft\\MCPServer\\Archicad 30 INT\\mcp-node-app.js"
      ]
    }
  }

/Users/<your_user>/Library/Application Support/Claude-3p/claude_desktop_config.json

  "mcpServers": {
    "Archicad Public MCP Server": {
      "command": "/Applications/Graphisoft/Archicad 30/Archicad 30.app/Contents/Frameworks/node",
      "args": [
        "/Users/<your_user>/Library/Application Support/Graphisoft/MCPServer/Archicad 30 INT/mcp-node-app.js"
      ]
    }
  }

Cursor

1. Aceda ao menu de personalização e seleccione o separador MCPs.
2. Clique em New MCP Server. Irá abrir o ficheiro mcp.json, onde a secção servers deve ser estendida com o command e os args obtidos a partir do Archicad clicando no comando Desktop AI Tool Connection a partir do menu Opções.

{
  "servers": {
    "Archicad Public MCP Server": {
      "type": "stdio",
      "command": "C:\\Program Files\\Graphisoft\\Archicad 30\\node.exe",
      "args": [
        "C:\\Users\\<your_user>\\AppData\\Local\\Graphisoft\\MCPServer\\Archicad 30 INT\\mcp-node-app.js"
      ]
    }
  }
}

{
  "servers": {
    "Archicad Public MCP Server": {
      "type": "stdio",
      "command": "/Applications/Graphisoft/Archicad 30/Archicad 30.app/Contents/Frameworks/node",
      "args": [
        "/Users/<your_user>/Library/Application Support/Graphisoft/MCPServer/Archicad 30 INT/mcp-node-app.js"
      ]
    }
  }
}

ChatGPT desktop

1. Na sua aplicação de desktop ChatGPT, vá a Definições > Plugins > Adicionar > Adicionar servidor MCP.
2. Aparecerá a indicação Ligar a um MCP personalizado; especifique aqui:
   1. Nome: Archicad Public MCP Server
   2. Tipo: STDIO
   3. Comando para lançar: Caminho completo para o node, copiado da sua caixa de diálogo Desktop AI Tool Connection do Archicad
   4. Argumentos: Caminho completo para mcp-node-app.js, copiado da sua caixa de diálogo Desktop AI Tool Connection do Archicad
3. Guarde e reinicie a aplicação ChatGPT desktop.
4. Teste a conexão ao servidor MCP com o comando 'Diz-me as instâncias do Archicad em execução'.

VS Code

1. Crie um ficheiro mcp.json na sua pasta .vscode com o seguinte conteúdo.
2. O valor de command e args é obtido a partir da sua caixa de diálogo Desktop AI Tool Connection do Archicad.
3. Inicie este servidor mcp.
4. Teste a conexão ao servidor MCP com o comando ‘Diz-me as instâncias do Archicad em execução’.

{
  "servers": {
    "Archicad Public MCP Server": {
      "type": "stdio",
      "command": "C:\\Program Files\\Graphisoft\\Archicad 30\\node.exe",
      "args": [
        "C:\\Users\\<your_user>\\AppData\\Local\\Graphisoft\\MCPServer\\Archicad 30 INT\\mcp-node-app.js"
      ]
    }
  }
}

{
  "servers": {
    "Archicad Public MCP Server": {
      "type": "stdio",
      "command": "/Applications/Graphisoft/Archicad 30/Archicad 30.app/Contents/Frameworks/node",
      "args": [
        "/Users/<your_user>/Library/Application Support/Graphisoft/MCPServer/Archicad 30 INT/mcp-node-app.js"
      ]
    }
  }
}