You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/docs/mcp.mdx
+57-1Lines changed: 57 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -158,6 +158,62 @@ Claude will execute these requests using the enabled NocoDB tools, reading from
158
158
159
159
<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>
160
160
161
+
161
162
### OpenAI Web
162
163
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.
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>
0 commit comments