> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trymechai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MechAI for Onshape Enterprise

<Callout icon="circle-info" color="#670797">
  **Note:** You must be an ***admin*** in your Onshape Enterprise to complete these steps.
</Callout>

## Enterprise connection

The Enterprise connection allows MechAI to securely access documents within your Enterprise while respecting your organization's existing permissions and governance controls.

<Steps>
  <Step title="Initiate the connection">
    Navigate to **Enterprise settings** > **Connections** and send your `Enterprise ID` to the MechAI team. We will then send you an Enterprise connection invitation.
  </Step>

  <Step title="Provision the connection">
    Once you accept the connection invite, please complete the following steps:

    <Steps>
      <Step title="Add users">
        Add all users who will use MechAI to the Enterprise connection.

        <div className="space-y-4">
          <img src="https://mechai.b-cdn.net/onshape-enterprise-setup/enterprise-connection-accepted.png" alt="Enterprise connection" />

          <img src="https://mechai.b-cdn.net/onshape-enterprise-setup/enterprise-connection-add-screen.png" alt="Add users" />
        </div>
      </Step>

      <Step title="Enable permissions">
        Navigate to **Enterprise settings** > **Global permissions**  and enable the **Export files** permission for all those users and **[team@trymechai.com](mailto:team@trymechai.com)**.

        ![Export files permissions](https://mechai.b-cdn.net/onshape-enterprise-setup/enterprise-export-permission.png)
      </Step>
    </Steps>
  </Step>
</Steps>

## API keys

**What are API keys?**

API keys provide a secure way for third-party applications to interact with your account. You define the scope of access when the key is created, and can modify or revoke that access at any time.

**What does MechAI use your Onshape API keys for?**

MechAI uses your API keys only to access, share, and edit the Onshape documents associated with tasks you explicitly request. We do not use your keys to browse unrelated documents, make purchases, manage users, modify account settings, or perform any actions outside the scope of your assigned work.

<Steps>
  <Step title="Create an API key">
    In Onshape, navigate to **Enterprise settings** > **Developer**. Click **API keys** then **Create new API key**.
  </Step>

  <Step title="Select owner & permissions">
    In **Name**, enter `MechAI`. In **User**, select yourself or the team member in your organization who will work with the MechAI team.

    Select these permissions:

    * **Application can read your documents**
    * **Application can write to your documents**
    * **Application can delete your documents and workspaces**
    * **Application can share and unshare documents on your behalf**

    <Callout icon="circle-info" color="#670797">
      **Note:** MechAI uses delete and share permissions narrowly. We delete only temporary documents and workspaces generated by our agent and share only the specific documents required to carry out tasks you authorize.
    </Callout>
  </Step>

  <Step title="Upload your API keys securely">
    After you create the API key, Onshape displays an **Access key** and **Secret key**. Open the secure portal below, then paste both values there.

    <div id="mechai-credential-upload" className="credential-upload">
      <button className="credential-upload-button" type="button" data-credential-upload-start="true">
        {"Secure portal"}
      </button>
    </div>

    <Callout icon="circle-info" color="#670797">
      **Note:** Onshape shows the **Secret key** only once at creation. Copy it before you close the dialog—you cannot view it again later.
    </Callout>
  </Step>
</Steps>

## Setup materials

<Steps>
  <Step title="Add your team">
    Send us the work email addresses of everyone who will be using MechAI. We will create an account for each user and provide onboarding instructions.

    Please also ensure all users join the designated Slack, Google Chat, or Microsoft Teams channel so they can receive product updates, share feedback, and communicate directly with our team.
  </Step>

  <Step title="Share drawing templates">
    In Onshape, share your organization's DWT document in Onshape with **[team@trymechai.com](mailto:team@trymechai.com)**. Please include templates for both parts and assemblies, as well as any size, process, or standards-specific variants currently used by your team.
  </Step>

  <Step title="Share approved template documents">
    If your Enterprise requires users to select from approved drawing templates, please also share each approved drawing template document with **[team@trymechai.com](mailto:team@trymechai.com)**.

    This applies when **Enterprise settings** > **Preferences** > **Drawings** is configured to require approved templates. In that case, MechAI needs access to that particular approved template document, so generated drawings can use the same template.

    ![Onshape Enterprise drawing preferences with approved drawing templates enabled](https://mechai.b-cdn.net/onshape-enterprise-setup/enterprise-drawing-preferences-template.png)
  </Step>

  <Step title="Share representative drawing examples">
    In Onshape, share a set of examples in Onshape documents that best reflect your organization's drawing standards and engineering practices with **[team@trymechai.com](mailto:team@trymechai.com)**. For each example, include both the part or assembly model and its corresponding drawing documents.

    We highly recommend providing examples that span a range of manufacturing processes, part complexities, GD\&T requirements, FAI/KPC annotations, and single- and multi-sheet drawing packages.
  </Step>
</Steps>