Documentation / MCP server for AI agents

MCP server for AI agents

Connect an AI assistant (like Claude) to your Configo account so it can build and test-calculate a product configurator for you.

Configo runs an MCP server that lets an AI assistant work with your configurators directly — reading a product spec or spreadsheet you give it, creating the materials and controls/calculations/parts a configurator needs, and running test calculations to check the numbers come out right, all without you clicking through the visual editor yourself.

What it can do

Once connected, an assistant can:

  • List your projects and the materials already defined in one
  • Create new materials (fabrics, hardware, etc.)
  • Create a configurator and set its controls, calculations and parts
  • Run a test calculation for a given set of inputs (e.g. a width/height/fabric combination) and get back the price and bill of materials it would produce, without creating a real order

It only ever acts as you: the assistant can see and change exactly what you could yourself, in the projects you're a member of — nothing more.

Connecting your account

The server is https://mcp.configo.org/mcp. Add it as a remote MCP server in your assistant — most clients (Claude included) will recognize it needs authorization and walk you through a normal login and consent screen the first time, the same way you'd approve any other application under OAuth Applications.

The consent screen marks the assistant as an unverified application. That's expected: MCP clients register with Configo on their own, under a name they choose, so Configo can't vouch for who is behind it — check the address the screen says you'll be sent back to (for Claude it's claude.ai) and approve only if it's the assistant you're actually connecting.

If your client can't register itself and asks you to supply an OAuth Client ID, create one under OAuth Applications: tick Public client, enter the redirect URI your client tells you to use, grant the projects, materials and configurators scopes, and paste the resulting Client ID into the client.

Using it

Ask the assistant to read a product spec, a price list, or a spreadsheet you give it, and build a configurator from it. A good first step for the assistant to take is calling the get_schema_reference tool, which explains the controls/calculations/parts format — worth mentioning if you're prompting it yourself rather than letting it figure that out.

Before treating a configurator as done, ask the assistant to test it: give it a few known input combinations (specific dimensions and material choices, say) and have it run the calculation tool to check the resulting price and bill of materials match what you expect — the same way you'd sanity-check a spreadsheet formula.

Security

Approving the consent screen grants the assistant projects, materials and configurators access — exactly what you could do yourself, nothing more. You can revoke that access at any time from Settings → Security: it shows up under Active sessions under the name the assistant registered with (for Claude, simply "Claude"), the same way any other app you've authorized does. Revoking there takes effect immediately.