Skip to main content
Use the aidnn MCP server from the AI assistant you already work in. Estimated setup time: 5 minutes. aidnn runs an MCP (Model Context Protocol) server. Once your assistant is connected to it, you can ask the assistant to work in aidnn for you, without switching to the aidnn app:
  • 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.
Everything the assistant does runs as you, with your aidnn permissions. It sees only the data you can see in aidnn.

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:
  1. Open aidnn in your browser and sign in.
  2. Copy the start of the address from the address bar, up to and including the domain, for example https://<your-aidnn-address>.
  3. Add /api/v1/mcp to 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:
  1. Sign in to aidnn, if you are not already signed in.
  2. 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.
  3. Choose a default workspace. New sessions, uploads and apps go there. Choose Account scope to work across the whole account instead.
  4. Click Allow access. The browser returns you to the assistant.
You can work in another workspace later by asking for it by name, for example “use the Finance workspace”. You do not need to sign in again. The connection stays signed in while you use it. If you have not used it for 30 days, the assistant asks you to sign in again.
Only approve access for assistants you trust. The approval page shows the address you will be returned to after approval; if it is not the assistant you just set up, close the tab.

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:
  1. Go to Organization settings → Connectors and click Add.
  2. Hover over Custom and select Web.
  3. Enter the same details as in steps 3 and 4 above, then click Add.
Each member then goes to Customize → Connectors, finds aidnn and clicks Connect. Every member signs in to aidnn with their own account, so each of them sees only their own aidnn data.

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.
Sign in from an interactive session first. Claude Code cannot open the sign-in page during non-interactive runs such as claude -p. Once you have signed in, those runs use the saved sign-in.

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.
To use it, type @ 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

Complete the aidnn sign-in in the browser.
To check the connection, run codex mcp list, or /mcp inside Codex.
Working on a remote machine? Run codex mcp login aidnn --no-browser. Codex prints a sign-in link: open it on your own computer, sign in, then paste the full address you are returned to back into the terminal.

Search the public documentation

The Isotopes AI Docs MCP server at https://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.