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.
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:
create_box, create_cylinder, create_sphere
boolean_fuse, boolean_cut, boolean_intersect
move_object, rotate_object, scale_object
create_fillet, create_chamfer, create_hole
get_state, list_faces, measure_distance
export_stl, export_step, import_stl
See MCP API Reference for the complete list.