CLI Tools & IDE Setup

Configure Conjure MCP server for Claude, Cursor, Windsurf, and OpenAI tools.

Overview

Conjure uses the Model Context Protocol (MCP) to connect AI assistants to your CAD software. This guide shows how to configure Conjure for various AI-powered CLI tools and IDEs.

Prerequisite: You'll need a Conjure API key. Sign up here to get one.

Supported Tools

C Claude Code / Claude Desktop

Anthropic's AI assistant with native MCP support.

Configuration

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "conjure": {
      "command": "uvx",
      "args": ["conjure-mcp"],
      "env": {
        "CONJURE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Alternative: npx

{
  "mcpServers": {
    "conjure": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/claude-mcp-proxy", "--", "uvx", "conjure-mcp"],
      "env": {
        "CONJURE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cu Cursor IDE

AI-first code editor with built-in MCP support.

Project Configuration

Create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "conjure": {
      "command": "uvx",
      "args": ["conjure-mcp"],
      "env": {
        "CONJURE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Global Configuration

Or add to ~/.cursor/mcp.json for all projects.

W Windsurf IDE

Codeium's AI-powered IDE with MCP support.

Configuration

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "conjure": {
      "command": "uvx",
      "args": ["conjure-mcp"],
      "env": {
        "CONJURE_API_KEY": "your_api_key_here"
      }
    }
  }
}

O OpenAI ChatGPT Desktop

OpenAI's desktop app with MCP support (added March 2025).

Configuration

Add to your ChatGPT desktop MCP configuration:

{
  "mcpServers": {
    "conjure": {
      "command": "uvx",
      "args": ["conjure-mcp"],
      "env": {
        "CONJURE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Note: Check OpenAI's documentation for the exact config file location.

Ag OpenAI Agents SDK (Python)

Build custom AI agents with MCP tool support.

Installation

pip install openai-agents

Usage

from agents import Agent
from agents.mcp import MCPServerStdio

# Configure Conjure MCP server
conjure_server = MCPServerStdio(
    command="uvx",
    args=["conjure-mcp"],
    env={"CONJURE_API_KEY": "your_api_key_here"}
)

# Create an agent with Conjure tools
agent = Agent(
    name="CAD Assistant",
    instructions="You are a CAD design assistant. Use the Conjure tools to create 3D models.",
    mcp_servers=[conjure_server]
)

# Run the agent
async with agent:
    result = await agent.run("Create a box 50x30x20mm with filleted edges")
    print(result)

Troubleshooting

uvx not found

Install uv first: pip install uv or curl -LsSf https://astral.sh/uv/install.sh | sh

Connection refused

Make sure FreeCAD is running with the Conjure adapter enabled. The adapter needs to be active to receive commands.

Invalid API key

Verify your API key is correct. You can manage your API keys at /account/api-keys.

Tools not showing

Restart your AI tool after updating the MCP configuration. Most tools require a restart to detect new servers.

Available Tools

Once configured, Conjure exposes 70+ MCP tools for CAD operations:

Primitives

create_box, create_cylinder, create_sphere

Booleans

boolean_fuse, boolean_cut, boolean_intersect

Transforms

move_object, rotate_object, scale_object

Features

create_fillet, create_chamfer, create_hole

Queries

get_state, list_faces, measure_distance

Export

export_stl, export_step, import_stl

See MCP API Reference for the complete list.