- Run analyses — start an aidnn session, ask it questions about your connected data, and follow its progress.
- Upload files — send a spreadsheet or CSV to aidnn and analyze it.
- Build and publish apps — have aidnn prepare the data, then build, revise and publish an app from it.
- Improve your data catalog — search table and column descriptions and your business glossary, and update them.
Before you begin
You need an aidnn account, and one of the following:Your server address
Every assistant asks for the same address. It is the address you use to open aidnn, followed by/api/v1/mcp:
- Open aidnn in your browser and sign in.
- Copy the start of the address from the address bar, up to and including the domain, for example
https://<your-aidnn-address>. - Add
/api/v1/mcpto the end.
Note: If you are unsure which address to use, contact support@isotopes.ai and we will send it to you.The official aidnn MCP registry listing describes this connection. You still use your organization’s aidnn address when connecting an assistant.
How sign-in works
There are no API keys to create. The first time the assistant connects, it opens your browser:- Sign in to aidnn, if you are not already signed in.
- Approve access. The page asks to connect your assistant to Aidnn MCP, for example Connect Claude to Aidnn MCP?, and lists what the assistant can do: create sessions and prepare data, upload files and design apps, and publish and update apps.
- Choose a default workspace. New sessions, uploads and apps go there. Choose Account scope to work across the whole account instead.
- Click Allow access. The browser returns you to the assistant.
Claude
aidnn is added to Claude as a custom connector. Once it is added on claude.ai, it is also available in Claude Desktop, the Claude mobile apps and Claude Code.Pro and Max plans
1
Open Connectors
In Claude, go to Customize → Connectors.
2
Add a custom connector
Click + Add, then Add custom connector.
3
Enter the connector details
Enter the name aidnn and your server address, then click Continue.
4
Choose the sign-in settings
Under Authentication, choose Sign in now. Under OAuth client, choose Register automatically. Leave Request headers empty.
5
Sign in
Click Add, then complete the aidnn sign-in in the browser window that opens.
Team and Enterprise plans
An Owner adds aidnn once for the organization:- Go to Organization settings → Connectors and click Add.
- Hover over Custom and select Web.
- Enter the same details as in steps 3 and 4 above, then click Add.
Use aidnn in a chat
Click + at the lower left of the message box, choose Connectors, and turn on aidnn for the conversation. Claude asks before it uses an aidnn tool; choose Allow always only for tools you are comfortable letting it run unattended.Claude Code
If you already connected aidnn on claude.ai with the same Claude account, it is already available in Claude Code: run/mcp to check. Otherwise add it from your terminal:
1
Add the server
--scope user makes aidnn available in every project you open.2
Sign in
Start Claude Code, run
/mcp, select aidnn and choose Authenticate. Complete the aidnn sign-in in the browser.ChatGPT
aidnn is added to ChatGPT as a custom MCP server. On Business, Enterprise and Edu workspaces, your workspace admin must first allow custom MCP servers in the workspace settings.1
Open Plugins
In ChatGPT on the web, open Plugins.
2
Add a custom MCP server
Click +, then Add custom MCP server.
3
Enter the server details
Enter the name aidnn. Under Connection, enter your server address.
4
Choose OAuth
Under authentication, choose OAuth. Leave the client ID and secret empty; ChatGPT registers itself with aidnn.
5
Create the plugin
Review the warning, confirm, and select Create as plugin. Complete the aidnn sign-in in the browser.
6
Install it
Find aidnn in your plugins and install it.
@ in the message box and select aidnn. ChatGPT asks you to confirm each action that changes something in aidnn, such as starting a session or publishing an app. Review the details before you approve.
Codex
The Codex CLI, the Codex IDE extension and the ChatGPT desktop app share one configuration, so you set up aidnn once for all three.1
Add the server
2
Sign in
codex mcp list, or /mcp inside Codex.
Search the public documentation
The Isotopes AI Docs MCP server athttps://docs.isotopes.ai/mcp lets assistants search and read public documentation. It is separate from the aidnn MCP server above and cannot access your organization’s data or run analyses.
Try it
Once aidnn is connected, ask in plain language. For example:- “List my aidnn workspaces.”
- “Upload sales-2026.csv to aidnn and find which regions grew fastest last quarter.”
- “Ask aidnn for monthly revenue by product line from our Snowflake data, then build an app from it.”
- “Search the aidnn catalog for tables about customer churn.”
Disconnect aidnn
Troubleshooting
For anything else, contact support@isotopes.ai.