Fracttal One can connect to artificial intelligence assistants such as Google Gemini through the MCP (Model Context Protocol) with OAuth authentication. This integration allows Gemini to access your company's maintenance data in Fracttal One (assets, work orders, meter readings, and more) directly from the Gemini chat, without exporting files or switching platforms.
The option to add custom MCP connectors depends on your Gemini plan and, for Google Workspace accounts, on the settings defined by the administrator. If you don't see the + Custom option in the Connectors tab, check your Gemini plan or contact your organization's Google Workspace administrator.
Step 1: Create the OAuth consumer in Fracttal One
The setup begins in Fracttal One, where you'll create an OAuth consumer to generate the credentials (Key and Secret) you'll need in Gemini.
In Fracttal One, go to Settings > API Connections.
Select the OAuth Consumers tab (①) and click the (+) button (②) to create a new consumer.
Complete the form with the following information:
Authorization type: select Authorization code.
Name: enter a descriptive name, such as
Gemini MCP.Redirect URL: this field is required. For now, enter the MCP server URL (
https://one.fracttal.com/mcp/oauth/fracttal-one) as a temporary value; you'll replace it in Step 3 with the URI provided by Gemini.
Permission Group: select a permission group (this field is required). When the connection is made through an MCP client, this group doesn't apply: the profile and permissions of the user who authorizes the connection are used.
- Click Save.
- Fracttal One generates the consumer credentials. Copy the Key and Secret values using the copy icon. You'll need them in Gemini.
Step 2: Configure the MCP connector in Gemini
With your Fracttal One credentials ready, go to Gemini to configure the MCP connector.
In Gemini, click Customize in the sidebar menu and select the Connectors tab.
Click + Custom to add a custom MCP connector. The "Connect to an MCP server" dialog will open.
Enter the Fracttal One MCP server URL in the MCP server URL field:
https://one.fracttal.com/mcp/oauth/fracttal-one
Click Additional settings > Show more to expand the authentication fields. The Client ID, Client secret, and Copy redirect URI button will appear.
- Enter the credentials you obtained from Fracttal One in the corresponding fields:
- Client ID: paste the Fracttal One Key.
- Client secret: paste the Fracttal One Secret.
- Click Copy redirect URI (①). Save this URI; you'll need it to complete the OAuth consumer in Fracttal One.
Don't close this Gemini window. You'll return to it after adding the redirect URI in Fracttal One.
Step 3: Complete the connection
Now return to Fracttal One to add the redirect URI, and then return to Gemini to finish the connection.
In Fracttal One, open the OAuth consumer you created in Step 1 and, in the Redirect URL field, replace the temporary value with the URI you copied from Gemini.
- Return to Gemini and click Next. Gemini will display a consent screen. Select the "I understand and accept the risks" checkbox and click Connect.
- The Fracttal One authorization page will open. Click Grant access to approve the connection.
- Back in Gemini, the Save your custom app dialog will open with the connector name already filled in and a list of available actions. If you want, edit the name and click Connect to save it.
- You'll see a confirmation banner indicating that the connector is active and ready to use.
Step 4: Query Fracttal One data from Gemini
With the connection active, you can query maintenance data directly from the Gemini chat.
- In Gemini's prompt field, mention the connector by typing
@Fracttalfollowed by your query. For example: "@Fracttal tell me which work orders are open this week".
The first time Gemini needs to use a connector action, it will display a message asking you to authorize that action. Click Always allow so Gemini can use it without asking you again. If you prefer to authorize it only for this query, click Allow once.
- Gemini will process the query by accessing your company's data in Fracttal One and will display the answer directly in the chat.
Notes:
User permissions: the data Gemini can query depends on the permissions of the user who authorized the connection, not on the OAuth consumer's permission group.
Credential management: you can view and manage the OAuth consumer credentials (Key and Secret) in Fracttal One by going to Settings > API Connections > OAuth Consumers.
Revoking access: you can revoke access from Fracttal One by deleting the OAuth consumer or reviewing active authorizations in the App authorizations section.
Third-party service: Gemini is a Google product, and its availability, features, and interface may change without notice from Fracttal. Fracttal doesn't control or guarantee the operation of third-party services.