> ## Documentation Index
> Fetch the complete documentation index at: https://docs.isotopes.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# aidnn MCP server: Connect Claude, ChatGPT and Codex

> Connect enterprise AI assistants to the aidnn MCP server to analyze data, build apps and search your catalog. Sign in with your aidnn account; no API keys needed.

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:

| Assistant | Where it works | Who can add aidnn |
| - | - | - |
| Claude | claude.ai, Claude Desktop, Claude mobile apps | Anyone on Pro or Max. On Team and Enterprise, an Owner adds it once for the organization. |
| Claude Code | Terminal, IDE extensions | Anyone |
| ChatGPT | chatgpt.com | Business, Enterprise and Edu workspaces, if your workspace admin allows custom MCP servers |
| Codex | Codex CLI, IDE extension, ChatGPT desktop app | Anyone |

### 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.

```text theme={null}
https://<your-aidnn-address>/api/v1/mcp
```

> **Note:** If you are unsure which address to use, contact [support@isotopes.ai](mailto:support@isotopes.ai) and we will send it to you.

The [official aidnn MCP registry listing](https://registry.modelcontextprotocol.io/?q=io.github.isotopesai%2Faidnn) 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.

> [!WARNING]
>
> 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](#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](#how-sign-in-works) 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**

```bash theme={null}
claude mcp add --transport http --scope user aidnn https://<your-aidnn-address>/api/v1/mcp
```

`--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](#how-sign-in-works) in the browser.

> [!TIP]
>
> **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](#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](#how-sign-in-works) 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**

```bash theme={null}
codex mcp add aidnn --url https://<your-aidnn-address>/api/v1/mcp
```

**2. Sign in**

```bash theme={null}
codex mcp login aidnn
```

Complete the [aidnn sign-in](#how-sign-in-works) in the browser.

To check the connection, run `codex mcp list`, or `/mcp` inside Codex.

> [!TIP]
>
> **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](https://registry.modelcontextprotocol.io/?q=io.github.isotopesai%2Fdocs) 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

| Assistant | How to remove aidnn |
| - | - |
| Claude | **Customize → Connectors**, open the **⋯** menu next to aidnn and choose **Remove**. On Team and Enterprise, Owners remove it for everyone in **Organization settings → Connectors**. |
| Claude Code | `claude mcp remove aidnn`, or **Clear authentication** in `/mcp` to sign out only |
| ChatGPT | Open **Plugins**, select aidnn and remove it |
| Codex | `codex mcp remove aidnn`, or `codex mcp logout aidnn` to sign out only |

## Troubleshooting

| You see | What to do |
| - | - |
| **Sign in to Aidnn first** | Click **Sign in to Aidnn**, sign in, then approve access on the next page. Keep the assistant open while you do. |
| **Authorization request expired** | The sign-in took too long. Start the sign-in again from the assistant. |
| **Account changed** | You signed in to aidnn as someone else partway through. Start the sign-in again and use the account you want to connect. |
| **Choose a default workspace** | Go back to the approval page and pick a workspace, or **Account scope**, before you click **Allow access**. |
| aidnn appears twice in Claude Code | It was added both on claude.ai and with `claude mcp add`. Remove one, for example with `claude mcp remove aidnn`. |
| The assistant cannot find something you see in aidnn | It may be in another workspace. Ask the assistant to use that workspace by name. |

For anything else, contact [support@isotopes.ai](mailto:support@isotopes.ai).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.