Connect ChatGPT to octoja

Screenshot walkthrough: enable developer mode, create the octoja plugin, configure permissions and test it.

Connect ChatGPT to your octoja user in four steps: enable developer mode, create the plugin, configure its permissions and test a monitoring query.

Prerequisites: You need an octoja user with the MCP Usage permission, plus ChatGPT in a browser with Developer mode available.

Each person authorizes their own octoja user.

If your ChatGPT interface differs, check OpenAI's developer-mode instructions.

1. Enable developer mode

Open ChatGPT and sign in to the account or workspace you want to use.
Click your profile at the bottom left, then Settings.

Select Security and login in the settings sidebar. Scroll down to Developer mode.
Read the warning and turn on the Developer mode switch. It allows unverified connectors that can modify or erase data if given the necessary access.

ChatGPT settings with Security and login and the enabled Developer mode switch highlighted in red

2. Create the octoja Plugin

Open octoja in a separate tab, go to Settings → MCP clients → Add MCP client and copy the server address. It ends in /mcp.
Return to ChatGPT and click Plugins in the main sidebar.
Click + beside Search plugins at the top right of the Plugins page. The New Plugin dialog opens.

ChatGPT Plugins page with red rectangles around Plugins in the sidebar and the plus button beside Search plugins

Fill in the dialog as follows:

Field	What to enter or select
Name	`octoja`
Icon (optional)	Leave empty, or choose a PNG icon.
Description (optional)	Leave empty, or add a short description.
Connection	Keep Server URL selected and paste your octoja server address, including `/mcp`.
Authentication	OAuth
Advanced OAuth settings	Leave unchanged for the standard setup. No API key or manually entered client secret is needed.

https://rmm.example.com/mcp illustrates the format. Use your own octoja address, not this example address.

Read Custom MCP servers introduce risk. Check I understand and want to continue only after checking the server address and understanding the warning.
Click Create and wait for ChatGPT to prepare the connection.

New Plugin dialog with red rectangles around the name, connection and OAuth fields, risk acknowledgement and Create button; the server address is redacted

In Add octoja to ChatGPT, click Sign in with octoja. The browser opens octoja's authorization page.

Add octoja to ChatGPT dialog with Sign in with octoja highlighted in red

Check that the authorization page belongs to your own octoja instance. Sign in if prompted and verify the Signed-in user (Angemeldeter Benutzer in the screenshot).
Review Permissions (Berechtigungen). Read access is always included. For the monitoring test below, leave the additional capabilities unselected.

octoja access	When to grant it
View octoja data	Included for reading available devices, monitoring data and cases.
Make changes to octoja	When the plugin should update data in octoja.
Live device access	When it should retrieve live device data or files.
Control remote computers	When it should view screens and operate mouse and keyboard.
Run scripts and automations	When it should execute scripts, automations or power actions.

Click Allow (Zulassen in the screenshot).

octoja authorization screen with the permission choices and Zulassen button outlined in red; only read access is selected and the signed-in account is redacted

Return to ChatGPT. The octoja is installed. message confirms installation, and the plugin settings show the connected account.

3. Configure octoja Plugin permissions in ChatGPT

Choose when ChatGPT asks you before using the plugin. This setting does not expand the access you granted in octoja during setup.

In the octoja plugin settings, click Permissions. To return here later, open Settings → Plugins and select octoja.

Installed octoja plugin settings with a red rectangle around the Permissions row; the connected account is redacted

Choose the approval behavior you want:

ChatGPT option	Behavior shown in ChatGPT
Always ask	Asks before reading or making changes. Recommended for your first test.
Allow read actions	Reads without asking, but asks before making changes.
Allow low-risk actions	The displayed default. Automatically approves low-risk actions but may deny actions involving sensitive information.
Allow all actions	Does not ask before reading or taking action. Marked ELEVATED RISK.

ChatGPT plugin Permissions screen with all four approval options highlighted in red; Allow low-risk actions is the selected default

Allow all actions is optional, not a connection requirement. Use it only when you deliberately want the plugin to act without asking. For a cautious start, select Always ask.

4. Test the octoja Plugin

Click New chat.
Type @octoja in the message input. Under Plugins, select octoja from the suggestion list. It appears as a blue plugin label in the input.

ChatGPT message input with @octoja and the octoja plugin suggestion outlined in red

After selecting the plugin, enter a prompt. Replace the placeholder with the device name:

What's the check-status on [device name]?

Send the message and approve the tool call if ChatGPT asks.
Wait for the reply. Expand Called tool to inspect the requests and results, then compare them with the summary. Successful calls returning the intended device's monitoring data confirm the connection; a connection claim in the answer alone does not.

ChatGPT test prompt and monitoring summary with two Called tool entries outlined in red; machine and account names and the conversation title are redacted

Your result will depend on the device and its checks. If no device matches, check the name and your octoja user's access. If ChatGPT does not use the plugin, start a new chat and select it through @octoja again. For access errors, review both the octoja grant and your user's permissions.

Video walkthrough

Continue with Examples and workflows. To change octoja grants or disconnect the plugin, follow Overview and access.

Was this helpful?

Still need help? Ask the team