Docs · Connect your agent
Connect Claude
Behold works in the Claude apps on the web, desktop and phone, and in Claude Code. You need a Behold invitation and a Claude plan that allows custom connectors.
Claude apps
A connector you add on claude.ai also appears in the Claude desktop and phone apps.
- In Claude, open Customize, then Connectors. In some versions this is under Settings.
- Choose Add custom connector.
- Name it
Beholdand paste the server address:https://app.behold.parts/mcp - Leave the advanced OAuth fields empty, and add it. Then choose Connect. Behold's sign-in opens; approve the connection with your invited Google account.
- In a new chat, check that Behold is turned on in the connectors menu, and ask for something.
On a Team or Enterprise plan, an owner adds the connector for the organization first; then each person connects with their own account.
Once Behold is listed in Claude's connector directory, you'll be able to add it from there instead of pasting the address.
Claude Code
Add the server in a terminal:
claude mcp add --transport http behold https://app.behold.parts/mcp
Then start Claude Code, run /mcp, choose behold and sign in. Claude Code also sees connectors you added on claude.ai when you're signed in with the same account.
The Behold plugin
The plugin adds the same server plus four skills that teach Claude how to work in Behold:
| Skill | What it covers |
|---|---|
behold:projects | Choosing where a change goes: an existing project, a quick test or a new project |
behold:review-loop | Build, check, review the six views, measure, compare, resolve notes, save a version |
behold:version-control | Named versions: save, compare, restore and fork |
behold:assemblies | Parts placed with joints and fits, and interference and clearance checks |
The plugin is open source under the Apache-2.0 licence. Its public repository isn't published yet; until it is, add the server as shown above. These docs will give the install command once it is.
What Claude sends to Behold
Through the connector, Claude sends what it needs to work on your designs: part source, project titles and READMEs, build parameters, notes and guide text. It receives builds, check reports, images and files from your projects. Behold runs no AI model of its own; what it returns goes only to the Claude account you connected. See the privacy policy.