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

# ChatGPT

> Connect ChatGPT to Izumi and ask about your documents from a chat.

Checked on Izumi 0.5.7, 2026-11-20 (ChatGPT plan Free, web).

You connect ChatGPT to Izumi over OAuth. You copy no token and enter no client ID.

## What you get

* You ask Izumi from ChatGPT. ChatGPT calls Izumi tools and answers with a source and a link to the document.
* You see only what you may see in Izumi, in all your companies.
* Optional: ChatGPT can propose a note. The note goes to the **Review queue**, and an editor of the domain approves or rejects it.
* The connection lasts 90 days. You revoke it yourself on **My tokens and profile**.

## Before you start

* An Izumi account, invited with the address you sign in with.
* A ChatGPT account. The plan **Free** was checked.
* The server address: `https://izumi.akiaconsulting.com/mcp`. For a company with its own installation, it is the address of their Izumi with `/mcp` at the end.

## Connect

> [!NOTE]
>
> ChatGPT renames its menus often. On the day of the check (2026-11-20) connectors are called **Plugins**. If your menu looks different, look for the entry that adds your own MCP server.

**1. Add the MCP server**

In the left menu of ChatGPT click **Plugins**. At the top right click **Add**, then **Add custom MCP server**. The same path leads through **Settings**, **Plugins**, **Browse directory**.

![ChatGPT, Plugins menu](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/chatgpt/01-settings-plugins.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=e36b3a1e89c0e3a245bcab3defeba19a)

![ChatGPT, Add custom MCP server](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/chatgpt/02-add-custom-mcp.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=57859f731f84c0b52a6e0ee89a18fc6a)

**2. Fill in the form**

* **Name**: `Izumi`.
* **Server URL**: `https://izumi.akiaconsulting.com/mcp`.
* **Authentication**: **OAuth**. Do not open **Advanced OAuth settings**, the fields stay empty.
* Tick **I understand and want to continue** and click **Create as a plugin**.

![ChatGPT, the filled form for Izumi](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/chatgpt/03-form.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=418d77b38b36249aadd5c6a38295150b)

**3. Click Connect Izumi**

ChatGPT creates the plugin and opens a window named Izumi. Click **Connect Izumi**.

![ChatGPT, the Connect Izumi window](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/chatgpt/04-connect-dialog.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=d13241cdc7bbce4fbe8d31011406c55f)

**4. Approve the connection in Izumi**

Izumi opens. If you are not signed in, sign in first. Then the page "Connect ChatGPT to Izumi" appears.

* Check that it says **Verified: chatgpt.com**. If it says anything else, do not approve.
* The first permission, **read the documents you can read, in all your companies**, is always on.
* The second permission, **suggest notes that an editor reviews**, is ticked by default. Untick it if ChatGPT should not propose notes.
* Click **Approve**.

![Izumi, the approval page for the ChatGPT connection](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/chatgpt/05-izumi-consent.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=dca2c815ed21503eb8ce7b277942edd8)

**5. Turn Izumi on in a chat**

You return to ChatGPT and the plugin is in the **Installed** list. Open a new chat, click **+** in the message box and choose **Izumi**. This turns Izumi on for that chat.

![ChatGPT, the + menu in the message box](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/chatgpt/06-composer-menu.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=216f75d2411e42064be96652069b8df6)

**6. Check the connection and ask about your documents**

Ask: "Call the Izumi tool whoami and tell me who I am and what I may do." ChatGPT returns your name, the name of the connection (`ChatGPT`), the scopes (`read`, `propose`), the expiry (90 days from approval) and the domains where you are an editor.

Then ask something from your documents, for example: "Call the Izumi tool search: where is the API migration guide? Then call get\_document for the best hit and name the source." ChatGPT calls `search`, then `get_document`, answers and gives a link to the source document.

![ChatGPT, the answer from whoami and search](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/chatgpt/07-answer-whoami-search.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=8ab3335785fbf406b38c1cf18d4918c3)

**7. Propose a note (optional)**

For example: "Call the Izumi tool who\_knows for the topic …. Then call propose\_note in the domain …". The answer returns the proposal ID and the 30-day deadline.

For tools that write, ChatGPT may ask "Allow ChatGPT to use Izumi?" with **Always allow**, **Deny** and **Allow once**. Choose as you see fit.

![ChatGPT, the answer from propose\_note](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/chatgpt/09-answer-propose.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=f50518bd42a5bf9303c38960db7ec97e)

**8. Check the proposal in Izumi**

Open the **Review queue**, tab **Pending**. The row shows who proposed it and the client (**ChatGPT**). An editor of the domain chooses **Approve** or **Reject**. If the proposal is yours, you can withdraw it with **Withdraw**.

![Izumi, the Review queue with a proposal from ChatGPT](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/chatgpt/11-review-detail.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=205588ff258c0a61bcd1ca53b0cd5ae4)

## See and revoke the connection

In Izumi open **My tokens and profile**. The connection is a row marked **Connected app**, with the name **ChatGPT**, the address `chatgpt.com`, scopes, companies and dates. Click **Revoke**. The connection ends at once, without a confirmation.

![Izumi, My tokens and profile with the ChatGPT connection](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/chatgpt/13-my-tokens.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=be44ea8475f283058bd9634f2a478592)

After a revoke, on the next call ChatGPT shows "Reconnect Izumi: Your Izumi connection has expired. Reconnect it before ChatGPT can use it for this request." with **Not now** and **Reconnect**. **Reconnect** opens the same **Connect Izumi** window and the same approval page. After you approve again, `whoami` works with no other setup.

## Remove the connector from ChatGPT

1. Revoke the connection in Izumi (above).
2. In ChatGPT: **Plugins**, **Installed**, open **Izumi**, the **...** menu (three dots), **Delete plugin**, and confirm ("Permanently delete Izumi and its connections? This can't be undone").

## Limits

* The plan **Free** was checked. Everything works on it: `whoami`, `search`, `get_document`, `who_knows` and `propose_note`.
* Permission for tools that write: in one run ChatGPT called `propose_note` without asking, in another it asked for **Allow once**. ChatGPT asks by its own risk judgment. Do not rely on either behavior.
* A connection lasts 90 days from the last approval. After that ChatGPT asks for **Reconnect**.
* The rate limit is 60 calls per minute (`rate_limited`).
* The approval page shows the name you are signed in as in Izumi. If it is not your account, do not approve.

## Troubleshooting

* **Verified: chatgpt.com** is missing, or the page says the client is not verified: the server cannot confirm the client's identity. Approve only if the name and address match what you expect.
* "Reconnect Izumi" in the middle of a chat: the connection was revoked, expired or ended in Izumi. Click **Reconnect**, then **Approve**.
* There is no **Izumi** entry in the **+** menu: the plugin is off or deleted. Check **Plugins**, **Installed**.
* `forbidden_scope` on `propose_note`: the connection was made without the `propose` scope. Revoke it and connect again with **suggest notes that an editor reviews** ticked. This error was checked live only in Claude Code, not in ChatGPT.
* `search` does not find a document: ChatGPT sees only what you may see. Check that you can see the document in **Documents**.
* After you delete the plugin in ChatGPT, check **My tokens and profile** and revoke what is left of the connection.


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