Connect your AI (MCP)

FieldCAD speaks the Model Context Protocol. Connect it to the AI you already pay for — Claude Code or Claude Desktop today — and ask it to work on your documents directly: “add a gyroid infill to the bracket”, “shell the housing to 2 mm and check it's watertight”. Every AI edit is validated and measured by the FieldCAD kernel and lands in the document's history, where you review it in the editor. The AI usage runs onyour subscription — FieldCAD doesn't meter it.

1 · Create an access token

On the Account page, under Connect your AI, create an access token. It is shown once — copy it. The token grants full access to your documents; creating a new one revokes the old.

2 · Connect your client

Claude Code (terminal):

claude mcp add fieldcad http://localhost:4321/mcp -t http \
  -H "Authorization: Bearer YOUR_TOKEN"

Claude Desktop — add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "fieldcad": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:4321/mcp",
               "--header", "Authorization: Bearer YOUR_TOKEN"]
    }
  }
}

claude.ai and ChatGPT web connectors need an OAuth sign-in flow — coming soon. Until then, use Claude Code or Claude Desktop.

3 · Teach it FieldCAD (recommended)

Install the FieldCAD skill so your AI knows the graph semantics, parameter shapes, and common recipes before its first edit:download SKILL.md and save it as~/.claude/skills/fieldcad/SKILL.md (Claude Code picks it up automatically).

What the AI can do

• list_documents / read_graph — see your documents and designs.
• search_blocks / block_doc — look up the block catalog.
• apply_edits — change a design; the batch is atomic, validated, measured (volume, bounding box, watertightness), and saved as one history entry.
• evaluate — re-measure without changing anything.

Security: the token identifies you and only reaches your own (and public) documents. Revoke it any time by creating a new one on the Account page.