Доступ к вашим документам Onshape CAD с помощью ИИ.

Что это такое

Onshape MCP подключает помощника к Onshape. Вы описываете, чего хотите в терминах Onshape — создать эскиз, экструдировать часть, экспортировать STL — и ИИ Обрабатывает вызовы API. Это помощник для тех, кто уже знаком с ним. Это не замена навыкам САПР.

Статус

Раннее развитие. Это предлагается для людей, чтобы попробовать, если они заинтересованы - Вещи могут не всегда работать так, как ожидалось, и обратная связь ценится.

Этот проект не предоставляет общедоступный MCP-сервер или публичный OAuth. Прокси. Запустите его локально, самостоятельно разместите его или подключитесь к серверу, которым управляет кто-то Вы доверяете независимо.

Начало работы

Локальная настройка (Claude Desktop, OpenCode или любой MCP-клиент)

Это рекомендуемый путь. Местный сервер может читать и записывать файлы на вашем компьютере. машина напрямую — скриншоты, экспорт и FeatureScript — вместо прохождения Содержание через разговор.

Шаг 1: Создайте приложение Onshape OAuth

Создайте собственное приложение OAuth в Onshape http://localhost:18338/callback в качестве перенаправления URL. Сохраните идентификатор клиента и Секрет клиента доступен для onshape-mcp auth login.

Onshape MCP

AI-assisted access to your Onshape CAD documents.

What This Is

Onshape MCP connects your AI assistant to Onshape. You describe what you want in Onshape terms — create a sketch, extrude a part, export an STL — and the AI handles the API calls. This is a helper for people who already know Onshape, not a replacement for CAD skills.

Status

Early development. This is offered for people to try if they’re interested — things may not always work as expected, and feedback is appreciated.

This project does not provide a public hosted MCP server or a public OAuth proxy. Run it locally, self-host it, or connect to a server operated by someone you independently trust.

Getting Started

Local Setup (Claude Desktop, OpenCode, or any MCP client)

This is the recommended path. A local server can read and write files on your machine directly — screenshots, exports, and FeatureScript — instead of passing content through the conversation.

Step 1: Create an Onshape OAuth application

Create your own OAuth application in Onshape with http://localhost:18338/callback as a redirect URL. Keep its client ID and client secret available for onshape-mcp auth login. Direct OAuth with these user-owned credentials is the default. API access and secret keys are also supported as an alternative; see Authentication.

Step 2: Get the server binary

Pick whichever is easier for you:

• npx (requires Node.js): No separate install needed — your MCP client runs npx --yes onshape-mcp and it downloads automatically.
• Pre-built binary: Download from GitHub Releases and save it somewhere convenient.

Step 3: Configure your MCP client

Tell your MCP client how to launch the server.

Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

Using npx:

{
  "mcpServers": {
    "onshape": {
      "command": "npx",
      "args": ["--yes", "onshape-mcp"]
    }
  }
}

Using the downloaded binary:

{
  "mcpServers": {
    "onshape": {
      "command": "/path/to/onshape-mcp"
    }
  }
}

OpenCode

Add to your opencode.json:

Using npx:

{
  "mcp": {
    "onshape": {
      "type": "local",
      "command": ["npx", "--yes", "onshape-mcp"]
    }
  }
}

Using the downloaded binary:

{
  "mcp": {
    "onshape": {
      "type": "local",
      "command": ["/path/to/onshape-mcp"]
    }
  }
}

Other MCP clients

Any MCP client that supports stdio transport can launch this server. The command is either npx --yes onshape-mcp or the path to the downloaded binary.

Step 4: Authenticate and try it

Configure your OAuth client ID and secret, then run npx --yes onshape-mcp auth login when using the npm package, or onshape-mcp auth login when using the downloaded binary. Prefer configuration or ONSHAPE_MCP_AUTH__CLIENT_ID and