Connecting Fracttal One with ChatGPT allows you to interact with your maintenance data directly from the ChatGPT interface, using natural language to query work orders, assets, metrics, and more, without needing to leave the assistant.
The integration uses the MCP (Model Context Protocol) with OAuth 2.0 authentication, ensuring that ChatGPT accesses Fracttal with the same permissions as the authenticated user.
Requirements
- Active Fracttal One account with administrator permissions or access to Settings.
- ChatGPT account with Pro, Team, Enterprise, or Edu plan (MCP connector functionality is not available on the free ChatGPT plan).
- Access to the API Connections section within Fracttal One.
- Developer Mode enabled in ChatGPT (see Step 5).
Step by Step
Access Fracttal One Settings
Log in to your Fracttal One account. In the upper right corner, click on the user menu and select Settings.
User Menu › Settings
Go to API Connections
In the settings side menu, locate and select API Connections. Then click on the OAuth Consumers tab.
Settings › API Connections › OAuth Consumers
Create a New OAuth Consumer
Click the (+) button to add a new consumer.
Fill out the form with the following information:
Field | Value |
|---|---|
Authorization Type | Authorization Code |
Name | Name the connection as you prefer (e.g., ChatGPT MCP) |
URL | Callback URL generated by ChatGPT (this must be done in parallel with step 6) |
Permission Group | Select the permission group you want. However, the system will use the permissions of the authenticated user. |
Once the form is complete, click the Save icon (top right).
Copy the Generated Key and Secret
Upon saving, Fracttal One will automatically generate a Key and a Secret for the consumer. Copy and securely store both values — you will need them in the next step.
Enable Developer Mode in ChatGPT
To add custom MCP connectors, you must first enable Developer Mode:
- Open ChatGPT at chatgpt.com and log in.
- In the lower-left corner, click your username and then go to Settings.
- Go to the Apps & Connectors section.
- Click Advanced and enable Developer Mode.
Note: Enabling Developer Mode will automatically disable ChatGPT’s Memory feature. This is a limitation imposed by OpenAI.
Add the MCP Connector in ChatGPT
With Developer Mode enabled, you can now add the Fracttal One connector:
- In Settings › Apps & Connectors, click Create (or Add MCP server, depending on your plan).
- Fill out the form with the following information:
Field | Value |
|---|---|
Connector Name | Fracttal One (or the name you prefer) |
Description (optional) | MCP connector for maintenance management with Fracttal |
MCP Server URL | https://one.fracttal.com/mcp/oauth/fracttal-one |
Authentication | OAuth |
Client ID | Paste the Key generated in Step 4 |
Client Secret | Paste the Secret generated in Step 4 |
- Check the risk confirmation box ("I trust this application").
- Click Create.
Important: When performing the advanced OAuth configuration in ChatGPT, the Callback URL required to establish the OAuth connection in Fracttal One is automatically generated (this must be done in parallel with step 4).
Authorize the Connection
ChatGPT will show you a button to connect with Fracttal One. When you click it, a Fracttal authorization window will open where you must:
- Log in with your Fracttal One account.
- Confirm the requested access permissions.
Once approved, the connector will be active. You will see its status as Connected in the Apps & Connectors section.
Done! You now have Fracttal One connected to ChatGPT. You can start a conversation and ask about your work orders, assets, metrics, and more.
Important Considerations:
- Using this integration may involve usage, limits, or charges associated with ChatGPT (OpenAI) plans. Such costs and conditions are determined solely by OpenAI.
- ChatGPT may request confirmation before performing write actions (create, modify, delete records). Always review proposed actions before confirming them.
- The user is responsible for validating and supervising the actions and results generated through this integration.
- ChatGPT’s Memory feature is automatically disabled when using Developer Mode.