ArchiCAD MCP: три сервера на Tapir и подключение к Claude и Codex

SzamosiMate/tapir-archicad-MCP· Проверено 12.11.2026· 136на GitHub

Подключает агента к открытому проекту ArchiCAD через JSON API и аддон Tapir: найти и прочитать элементы, поменять свойства и классификации, создать стены и перекрытия, проверить модель по правилам бюро.

3 реализации:

191+ команд Tapir и JSON API за тремя инструментами: агент ищет команду, читает её схему и вызывает; держит несколько запущенных ArchiCAD и умеет HTTP с токеном.

Как подключить

Что сделать до подключения

Python 3.12 или новее и uv

Запущенный ArchiCAD; для полного набора команд — аддон Tapir

Вместо конфига можно открыть файл tapir-archicad.mcpb из последнего релиза в Claude Desktop или Claude Code

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio archicad \
  -- uvx --from tapir-archicad-mcp archicad-server

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.archicad]
command = "uvx"
args = ["--from", "tapir-archicad-mcp", "archicad-server"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "archicad": {
      "command": "uvx",
      "args": ["--from", "tapir-archicad-mcp", "archicad-server"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "archicad": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "tapir-archicad-mcp", "archicad-server"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "archicad": {
      "command": "uvx",
      "args": ["--from", "tapir-archicad-mcp", "archicad-server"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "archicad": {
      "command": "uvx",
      "args": ["--from", "tapir-archicad-mcp", "archicad-server"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "archicad": {
        "type": "local",
        "command": ["uvx", "--from", "tapir-archicad-mcp", "archicad-server"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "archicad": {
      "command": "uvx",
      "args": ["--from", "tapir-archicad-mcp", "archicad-server"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "archicad": {
      "command": "uvx",
      "args": ["--from", "tapir-archicad-mcp", "archicad-server"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

discovery_list_active_archicadsнаходит запущенные ArchiCAD и их порты

archicad_list_commandsищет нужную команду

archicad_get_command_schemaпоказывает параметры команды

archicad_call_toolвыполняет команду в ArchiCAD

archicad_get_jobпроверяет долгую задачу

Каждая из 250 команд Tapir — отдельный инструмент, по умолчанию спрятанный за поиском; режимы safe и readonly скрывают опасные команды.

Как подключить

Что сделать до подключения

ArchiCAD с 25 по 29 и uv

Аддон Tapir для вашей версии ArchiCAD со страницы релизов Tapir; в репозитории описания команд Tapir 1.5.9

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env ARCHICAD_MCP_MODE=safe --transport stdio archicad-mcp \
  -- uvx --from git+https://github.com/lgradisar/archicad-mcp archicad-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.archicad-mcp]
command = "uvx"
args = ["--from", "git+https://github.com/lgradisar/archicad-mcp", "archicad-mcp"]

[mcp_servers.archicad-mcp.env]
ARCHICAD_MCP_MODE = "safe"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "archicad-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/lgradisar/archicad-mcp",
        "archicad-mcp"
      ],
      "env": {
        "ARCHICAD_MCP_MODE": "safe"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "archicad-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/lgradisar/archicad-mcp",
        "archicad-mcp"
      ],
      "env": {
        "ARCHICAD_MCP_MODE": "safe"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "archicad-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/lgradisar/archicad-mcp",
        "archicad-mcp"
      ],
      "env": {
        "ARCHICAD_MCP_MODE": "safe"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "archicad-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/lgradisar/archicad-mcp",
        "archicad-mcp"
      ],
      "env": {
        "ARCHICAD_MCP_MODE": "safe"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "archicad-mcp": {
        "type": "local",
        "command": [
          "uvx",
          "--from",
          "git+https://github.com/lgradisar/archicad-mcp",
          "archicad-mcp"
        ],
        "environment": {
          "ARCHICAD_MCP_MODE": "safe"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "archicad-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/lgradisar/archicad-mcp",
        "archicad-mcp"
      ],
      "env": {
        "ARCHICAD_MCP_MODE": "safe"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "archicad-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/lgradisar/archicad-mcp",
        "archicad-mcp"
      ],
      "env": {
        "ARCHICAD_MCP_MODE": "safe"
      }
    }
  }
}

Инструменты сервера

TestConnectionпоказывает порт и версии ArchiCAD и Tapir

search_toolsищет команду Tapir

call_toolвыполняет найденную команду

RunTapirCommandвыполняет команду Tapir по имени

Показано 4 из 252.

Для ArchiCAD 29: проверка модели по правилам бюро в YAML, создание 51 типа элементов, пробный прогон перед каждой правкой и шлюз к примерно 800 командам.

Как подключить

Что сделать до подключения

ArchiCAD 29 (30 тоже работает) на macOS или Windows

Поставить сервер: uv tool install archicad-mcp-server; для Claude Desktop есть файл .mcpb со своим Python

Поставить Tapir 2.0.0 командой archicad-mcp install-tapir и перезапустить ArchiCAD

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio archicad-mcp \
  -- archicad-mcp --mode full

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.archicad-mcp]
command = "archicad-mcp"
args = ["--mode", "full"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "archicad-mcp": {
      "command": "archicad-mcp",
      "args": ["--mode", "full"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "archicad-mcp": {
      "type": "stdio",
      "command": "archicad-mcp",
      "args": ["--mode", "full"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "archicad-mcp": {
      "command": "archicad-mcp",
      "args": ["--mode", "full"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "archicad-mcp": {
      "command": "archicad-mcp",
      "args": ["--mode", "full"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "archicad-mcp": {
        "type": "local",
        "command": ["archicad-mcp", "--mode", "full"]
      }
    }
  }
}

{
  "mcpServers": {
    "archicad-mcp": {
      "command": "archicad-mcp",
      "args": ["--mode", "full"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "archicad-mcp": {
      "command": "archicad-mcp",
      "args": ["--mode", "full"]
    }
  }
}

Инструменты сервера

audit_delivery_readinessпроверяет модель по правилам бюро

run_ruleзапускает одно правило

highlight_failuresподсвечивает ошибочные элементы

create_issues_from_failuresзаводит замечания по ошибкам

find_elementsищет элементы по условиям

get_element_dataчитает данные элемента

get_model_summaryсводит модель по типам

find_collisionsищет коллизии

set_element_dataменяет данные элемента

modify_elementsправит элементы

move_elementsдвигает элементы

delete_elementsудаляет элементы

create_elementsсоздаёт стены, перекрытия, двери

capture_windowснимает окно ArchiCAD

export_ifcвыгружает IFC

save_projectсохраняет проект

read_schedule_schemeчитает схему спецификации

build_gdl_objectсобирает GDL-объект из меша

list_api_commandsвыводит команды API

execute_write_api_commandвыполняет команду записи API

Что попросить агента

«Какие проекты ArchiCAD у меня сейчас открыты?»Tapir MCP вызовет discovery_list_active_archicads и назовёт копии и их порты

«На порту <порт> выгрузи все стены проекта»Tapir MCP найдёт команду через archicad_list_commands, возьмёт её схему через archicad_get_command_schema и вызовет elements_get_elements_by_type через archicad_call_tool

«Проверь, что у всех стен заполнено свойство «Огнестойкость», и подсвети ошибки»Archicad MCP запустит правило через run_rule или audit_delivery_readiness и покажет ошибочные элементы через highlight_failures

«Проверь связь с ArchiCAD»archicad-mcp вызовет TestConnection и назовёт порт и версии ArchiCAD и Tapir

Для каких задач

Выгрузить все стены проекта или элементы нужного типа с их данными

Проверить модель по правилам бюро: обязательные свойства, классификации, готовность к выгрузке IFC

Создать стены, перекрытия, колонны, двери и окна, зоны и лестницы

Поменять свойства, классификации и атрибуты у группы элементов

Найти коллизии и завести по ним замечания в Issue Manager

Собрать GDL-объект из модели OBJ или 3DS

Ограничения

ArchiCAD 29 может упасть при чтении свойств даже одного элемента и унести несохранённую работу: перед такими запросами просите агента выполнить save_project

Без аддона Tapir доступна только часть команд, а описания команд в lgradisar/archicad-mcp должны совпадать с версией вашего Tapir

Часть команд закрывает ArchiCAD, сохраняет и закрывает проекты, удаляет элементы и отправляет изменения в Teamwork; режим ARCHICAD_MCP_MODE=safe в lgradisar их прячет

Сервер Tapir в статусе alpha, у alesdev88/Archicad-MCP 11 звёзд: оба проекта молодые

Если не работает

«Archicad is not running or the Tapir add-on is not loaded»

Откройте проект в ArchiCAD. Если он открыт, проверьте, что Tapir есть в Add-On Manager.

«is not available in the installed Tapir add-on»

Ваш Tapir старше описаний команд в archicad-mcp: обновите аддон.

Claude пишет о таймауте

Claude перестал ждать, а ArchiCAD продолжает работу: публикация, перезагрузка библиотек, Teamwork и IFC идут долго. Проверьте результат в ArchiCAD, прежде чем просить снова.

Пакет .mcpb не запускается или пишет «Server disconnected»

Удалите пакет, перезапустите клиент и поставьте заново. Первый запуск идёт 15–30 секунд, пока uv собирает окружение.

Claude Desktop не видит uvx или uv

Укажите в command полный путь к программе: найдите его командой where uvx на Windows или which uvx на macOS.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Archicad Tapir MCP Server	SzamosiMate	136	локально	не нужен	5	4 ноября 2026
archicad-mcp	lgradisar	39	локально	не нужен	252	30 сентября 2026
Archicad MCP	alesdev88	11	локально	не нужен	20	12 ноября 2026

Частые вопросы

Какой сервер выбрать?

Для любых команд Tapir и JSON API — Archicad Tapir MCP Server или archicad-mcp: оба ищут команду по запросу и вызывают её. archicad-mcp строже к безопасности: режимы safe и readonly. Для проверки модели по правилам бюро и создания элементов на ArchiCAD 29 — Archicad MCP от alesdev88.

Что такое Tapir и зачем он нужен?

Tapir — аддон для ArchiCAD с набором команд сообщества поверх встроенного JSON API. Archicad MCP от alesdev88 ставит его сам командой archicad-mcp install-tapir, для двух других серверов скачайте аддон со страницы релизов Tapir.

Как работать, если открыто несколько ArchiCAD?

Tapir MCP находит все запущенные копии через discovery_list_active_archicads и шлёт команды на нужный порт. В archicad-mcp отвечает первая запущенная копия: другую выберите переменной ARCHICAD_PORT.

Агент может испортить проект?

Может: часть команд удаляет элементы, сохраняет и публикует. В archicad-mcp включите ARCHICAD_MCP_MODE=safe или readonly и подтверждайте каждый вызов. Archicad MCP от alesdev88 сначала показывает пробный прогон с текущими и новыми значениями, а удаление и перенос требуют confirm=true.

Что делать, если команда идёт дольше 45 секунд?

Tapir MCP вернёт идентификатор задачи, а работа продолжится. Проверяйте её через archicad_get_job, пока статус running. Если клиент обрывает ожидание раньше, уменьшите --async-threshold-seconds.

Как подключить ArchiCAD MCP к Claude?

В Claude Desktop проще всего открыть файл .mcpb из релиза: такой есть у Tapir MCP и у Archicad MCP от alesdev88. В Claude Code выполните uv tool install archicad-mcp-server и claude mcp add archicad -- archicad-mcp --mode full. Затем откройте проект и попросите агента найти запущенные ArchiCAD.

Работает ли сервер из России?

Серверы работают на вашем компьютере и обращаются только к запущенному ArchiCAD на 127.0.0.1, без телеметрии и внешних серверов.

ArchiCAD MCP: три сервера на Tapir и подключение к Claude и Codex

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы