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

# Claude

> Connect claude.ai and Claude Desktop to Izumi. One connector, one account.

Checked on Izumi 0.5.7, 2026-11-20 (claude.ai plan Pro, web; Claude Desktop 6.6395.1 on macOS, plan Pro).

claude.ai and Claude Desktop are the same account and the same connector. You add it once in claude.ai and Desktop sees it by itself. You connect over OAuth, with no token.

## What you get

* You ask Izumi from a Claude chat. Claude calls Izumi tools and answers with a source.
* You see only what you may see in Izumi, in all your companies.
* Optional: Claude 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 Claude account. The plan **Pro** was checked.
* The server address: `https://izumi.akiaconsulting.com/mcp`.

## Connect in claude.ai

> [!NOTE]
>
> The claude.ai menus change often. On the day of the check (2026-11-20) connectors are under **Plugins**, with the filter **Connectors**. This place used to be called **Customize**.

**1. Add a custom connector**

In the left menu click **Plugins**, then choose the filter **Connectors** above the list. At the top right click **Add**, then **Add custom connector**.

![claude.ai, Plugins, the Connectors filter](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/01-customize-connectors.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=60571af42dea587127aa51eb13896fee)

![claude.ai, Add custom connector](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/02-add-custom-connector.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=c59230c088d57d2e5c0244edb3577b27)

**2. Enter the name and the address**

In the **Add custom connector** window enter **Name** `Izumi` and **MCP server URL** `https://izumi.akiaconsulting.com/mcp`, then click **Continue**.

![claude.ai, the form with name and address](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/03-form.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=8b9bc916f2b146cee382969ea44ac2d7)

**3. Keep the detected settings**

Claude checks the server and detects the settings by itself. Leave them as they are:

* **Authentication**: **Sign in now** (label **Detected**).
* **OAuth client**: **Use Claude's published identity** (label **Detected**).
* **Request headers** and **Advanced** stay empty.

Click **Add**. Izumi opens at once, with no extra click on **Connect**.

![claude.ai, the detected authentication settings](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/04-auth-options.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=40e2d42827f8c130f3f20598aed7fdfc)

**4. Approve the connection in Izumi**

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

* Check that it says **Verified: claude.ai**. 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 Claude should not propose notes.
* Click **Approve**.

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

**5. Look at the tool permissions**

You return to claude.ai with the message **Connected to Izumi.** Open the connector (**Plugins**, **Izumi**) and the **Permissions** tab (next to **Overview**). It lists the tools in two groups: **Read-only tools** (**Get document**, **Search**, **Who knows**, **Whoami**) and **Write/delete tools** (**Propose note**). Each group has a setting, **Needs approval** by default, and each tool has three choices: allow, ask for approval, block.

![claude.ai, the tool permissions for Izumi](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/07-tool-permissions.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=328197f68bef299223e0196d623ac499)

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

Open a new chat. Click **+** in the message box, then **Plugins**. A list with switches opens. **Izumi** is already on. If it is not, turn it on.

![claude.ai, the Plugins menu in the message box](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/08-connectors-menu.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=c5ee71691d597e91393efac1f64a4d53)

**7. Check the connection**

Ask: "Call the Izumi tool whoami and tell me who I am." Before every call Claude asks "Claude wants to use Whoami from Izumi" with **Decline**, **Always allow** and **Allow once**. Choose **Allow once**. The answer returns your name, companies, the domains where you are an editor, the scopes (`read`, `propose`) and when the connection expires.

![claude.ai, the permission question for the Whoami tool](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/09-permission-prompt.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=6ad2b101d8269133b5643555329373a3)

**8. Ask about your documents and propose a note (optional)**

For example: "Call search: where is the API migration guide, then get\_document for the best hit. Then who\_knows for the topic API migration, then propose\_note in the domain Product." Approve each call. For `propose_note`, review the domain, title and text before you click **Allow once**.

![claude.ai, the permission question for the Propose note tool](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/10-permission-propose.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=cbd114b18f3e1e5c510578fd6f94ba1b)

![claude.ai, the answer with the tool results](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/12-answer-tools.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=df446761488accd66995751eb8eb2e1a)

**9. Check the proposal in Izumi**

Open the **Review queue**, tab **Pending**. The row shows who proposed it and the client (**Claude**). 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 Claude](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/13-review-detail.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=15647f2baa54c621ce78174ce0738251)

> [!NOTE]
>
> Some screenshots on this page show a chat in Serbian, because the check ran with Serbian questions. The Izumi tool texts in them are English.

## Claude Desktop

Desktop is the same account and the same connector as claude.ai. You add nothing: the connector you added in claude.ai appeared in Desktop by itself, with your older chats. The Izumi tools, the approval page and the 90-day connection are the same.

> [!NOTE]
>
> The Desktop screenshots in this section come from a run with the Serbian demo company, Moravska Trgovina. Claude Desktop itself is in English.

### Where the connector is

1. In the left menu click **Plugins**.

2. **Izumi** is in the list **Your plugins**, marked **Custom connector**, with the address izumi.akiaconsulting.com.

   ![Claude Desktop, the connector list with Izumi](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/desktop-02-connectors.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=2cd0f02d886b16dd38f545bb5429af71)

3. A click on the **Izumi** row opens the details: the **Added** label and the **...** menu. The **Permissions** tab (next to **Overview**) explains the modes. In **Manual** mode you choose when Claude may use tools. In **Auto** mode an automatic check blocks actions it marks as risky, and otherwise Claude may work without asking, even for tools set to **Needs approval**. All Izumi tools are on **Needs approval** by default. In the screenshot **Whoami** is on **Always allow** and the group says **Mixed**: **Always allow** is remembered per tool, so it was left over from an earlier click in the permission question.

   ![Claude Desktop, the details of the Izumi connector](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/desktop-07-connector-detail.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=4d0dc3ef9ca552aba8cc8b4e495767a8)

### Call a tool in Desktop

1. Open a new chat (**New**) and check that Izumi is on (**+**, **Plugins**).

2. Ask, for example: "Call the Izumi tool whoami and tell me who I am. Then call search: how long do we keep documentation in Moravska Trgovina?"

3. In **Manual** mode Desktop asks for permission for every tool separately (except tools set to **Always allow**): "Claude wants to use Search from Izumi", with **Decline**, **Always allow** and **Allow once**. While it waits, the chat shows **Needs your input**.

   ![Claude Desktop, the permission question for the Search tool](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/desktop-05a-permission.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=56949c6d38f7ad9738d2e6961760dc14)

4. `whoami` shows your name, the connection (scopes `read` and `propose`, expiry 90 days) and companies and domains with your role. `search` returns an answer with sources and links to documents.

   ![Claude Desktop, the answer from whoami and search](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/desktop-05-chat.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=53d5b1491900b3227898287bdae1d0de)

## See and revoke the connection

In Izumi open **My tokens and profile**. The connection is a row marked **Connected app**, with the name **Claude** and the address `claude.ai`. Click **Revoke**. The connection ends at once, without a confirmation.

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

## Reconnect after a revoke

In claude.ai:

* On the next call Claude asks for tool approval again, then says it failed ("Couldn't use Izumi: Whoami"). Izumi asks for a new sign-in.
* Under the message box there is a card "Reconnect a connector to keep using it" with **Not now** and **Reconnect**.
* In **Plugins**, **Izumi** it says **Sign-in expired** and "Connection has expired. You can reconnect to re-authenticate." with a **Reconnect** button (top right and in the connector row). **Disconnect** is in the **...** menu. **Reconnect** leads to the same approval page. After you approve, all calls work again.

![claude.ai, the Reconnect card in the chat](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/14-reconnect-chat.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=fdde9ef9ff7429ed9bd3fc379aff220b)

![claude.ai, Sign-in expired on the connector page](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/15-connection-expired.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=b69c5171d5844aacab85d59aaeb92658)

In Claude Desktop:

* The same call fails. Claude tries twice, says a new sign-in is needed, and the same card with **Reconnect** appears under the chat.

  ![Claude Desktop, the Reconnect card after a revoke](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/desktop-06-after-revoke.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=366d4629e315af10b7c291e41664aa8e)

* **Reconnect** opens the browser, not a window in the app. First the claude.ai page "Finish connecting a connector?" appears. Continue only if you started the connection from Claude Desktop. The **Continue connecting** button is grey at first.

  ![claude.ai, the page Finish connecting a connector](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/desktop-04-finish-connecting.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=31522420f41ec39758a8bcfd09b9fb3c)

* Then the Izumi page "Connect Claude to Izumi" appears with **Verified: claude.ai** and the buttons **Approve** and **Deny**.

  ![Izumi, the approval page opened from Claude Desktop](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/05-izumi-consent.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=470f4a29c561324483446aaebf6b04b5)

* After **Approve** return to Desktop. In the same chat `whoami` works, with a new connection (a changed prefix and expiry).

## Remove the connector

1. Revoke the connection in Izumi (above).
2. In claude.ai: **Plugins**, **Izumi**, the **...** menu (it also has **Refresh tools list** and **Disconnect**), **Remove**, then confirm "Delete Izumi?" with the **Delete** button. The dialog reminds you that you need the server address to add it again.

Removing in Desktop was checked: afterwards Izumi is no longer in the connector list.

## Limits

* The plan **Pro** was checked. A custom connector is added with no extra steps and all five tools work, including `propose_note`.
* On the day of the check the mode was **Manual**: every tool call asks for approval (**Allow once**), except tools you set to **Always allow**. **Always allow** is remembered per tool.
* claude.ai sometimes offers "Switch to Auto mode?" (**Stay in Manual** or **Switch to Auto**). In **Auto** mode an automatic check blocks risky actions and Claude does the rest without asking. This changes a setting of your Claude account and is not part of connecting to Izumi.
* A connection lasts 90 days from the last approval. After that claude.ai shows **Sign-in expired** and asks for **Reconnect**.
* The approval page shows the name you are signed in as in Izumi. If it is not your account, do not approve.

> [!WARNING]
>
> Not checked live: the plans Free, Team and Enterprise (whether an organization owner can add the connector once for everyone), the mobile app, the Windows version of Desktop, **Auto** mode, the **Reconnect** button on the card in the claude.ai chat (it opened nothing visible in the check; the button in **Plugins** works), signing in with the header `Authorization: Bearer <token>` instead of OAuth, what happens when Desktop is signed in to the wrong Claude account (the connector probably does not show), and `get_document`, `who_knows` and `propose_note` from Desktop (checked in claude.ai).

## Troubleshooting

* **Verified: claude.ai** 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.

* **Sign-in expired** or "Connection has expired": the connection was revoked, expired or ended in Izumi. Go to **Plugins**, **Izumi**, **Reconnect**, then **Approve**.

* After **Approve** it says "The request expired / Start connecting again from the app." Check before you start over: the connection probably already succeeded. In one check the server issued access, and a second submission of the same form was refused. The cause is not known.

  ![Izumi, the page The request expired](https://mintcdn.com/akia-consulting/UfDKk95B0JApANc6/images/en/claude/desktop-04-request-expired.png?fit=max\&auto=format\&n=UfDKk95B0JApANc6\&q=85\&s=f4b93abe5501f8dae9847c289950f579)

* After a revoke the tool approval window appears twice before the message that the call failed. Click **Decline**, and the **Reconnect** card appears.

* The connector icon is the letter "A" instead of the Izumi mark. This is a known issue and the cause is not yet determined.

* Izumi is not in the list in **+**, **Plugins**: the connector was removed or switched off. Add it again or turn the switch on.

* `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.

* `search` does not find a document: Claude sees only what you may see. Check that you can see the document in **Documents**.

* After you remove the connector, 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.