Skip to content

Commit dfb6e0f

Browse files
committed
docs: openAI
Signed-off-by: Raju Udava <86527202+dstala@users.noreply.github.com>
1 parent 8328098 commit dfb6e0f

File tree

1 file changed

+57
-1
lines changed

1 file changed

+57
-1
lines changed

content/docs/mcp.mdx

Lines changed: 57 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -158,6 +158,62 @@ Claude will execute these requests using the enabled NocoDB tools, reading from
158158

159159
<Callout type="warning">OAuth authorization functions as a set of access credentials granting Claude control over your NocoDB base within the selected workspace. Only authorize access to bases and operations you trust Claude to perform on your behalf.</Callout>
160160

161+
161162
### OpenAI Web
162163

163-
OAuth-based integration allows OpenAI ChatGPT users to access NocoDB databases through the custom actions interface.
164+
OAuth-based integration enables OpenAI web users (ChatGPT) to securely connect with NocoDB databases through the MCP connector, directly from their browser environment. This provides the same granular access control and eliminates the need for manual configuration or desktop client setup.
165+
166+
#### Prerequisites
167+
Enable Developer Mode in ChatGPT settings to allow custom connector additions.
168+
1. Open [ChatGPT Settings](https://chatgpt.com/#settings/Connectors) in a new tab.
169+
* Alternatively, click your **Profile Icon** → **Settings** → **Settings** → **Apps & Connectors**).
170+
2. Click **Advance Settings** & enable **Developer Mode**.
171+
172+
#### Setup Steps
173+
1. Open [ChatGPT Settings](https://chatgpt.com/#settings/Connectors) in a new tab.
174+
* Alternatively, click your **Profile Icon** → **Settings** → **Settings** → **Apps & Connectors**).
175+
2. Click **Create** button in top right corner of the **Connectors** modal.
176+
3. In the "New connector" dialog:
177+
- Provide a connector name of your choice. Optionally, add a description / icon.
178+
- Enter the MCP Server URL: `https://app.nocodb.com/mcp`
179+
- Check the box for **I trust this application**.
180+
- Click `Create`
181+
4. Authorize Access:
182+
* Log in to your NocoDB account if prompted
183+
* Select the workspace and base you want to connect
184+
* Review and confirm the permissions being requested:
185+
* Access to the selected base
186+
* Read / create / update / delete records
187+
* Act on your behalf within the selected resources
188+
* Click **Authorize**
189+
190+
Once authorization completes, you will see a confirmation message in ChatGPT Web indicating the NocoDB connector is now connected.
191+
192+
<Callout type="note">For on-prem enterprise users, replace `https://app.nocodb.com` with your NocoDB instance URL.</Callout>
193+
194+
#### Configure Tool Permissions
195+
196+
By default, all tools provided by NocoDB are enabled. You can customize which tools are active.
197+
1. Open NocoDB connector from [ChatGPT Settings](https://chatgpt.com/#settings/Connectors) in a new tab.
198+
2. All tools are listed under **Actions**. Use the toggles to enable or disable specific tools as needed.
199+
200+
To confirm which workspaces and bases are available, use the **Get Base Info** tool under the NocoDB connector panel.
201+
202+
#### Using NocoDB Tools in OpenAI Web
203+
204+
On the ChatGPT interface, start a new conversation and
205+
- Click the **+** icon to open the "Tools" menu, enable `Developer Mode` if not already enabled.
206+
- Use `Add sources` to find and select the NocoDB connector you created. Toggle to enable it.
207+
208+
Once configured, you can query or update your NocoDB data conversationally. For example:
209+
210+
* “List all open support tickets assigned to me”
211+
* “Add a new contact named ‘Alice Chen’ to the CRM base”
212+
* “Update the status of Order #2456 to ‘Shipped’”
213+
* “Summarize total revenue by month from the Sales base”
214+
215+
ChatGPT executes these actions using the connected NocoDB tools according to the permissions granted.
216+
217+
<Callout type="warning">OAuth authorization provides ChatGPT controlled access to your NocoDB base within the selected workspace. Only authorize operations and bases you trust ChatGPT to manage on your behalf.</Callout>
218+
219+
---

0 commit comments

Comments
 (0)